 |
Resumen | Discourse FontAwesome Pro permite el uso de iconos de Font Awesome Pro en Discourse con una licencia de FontAwesome utilizando el token del paquete NPM de tu cuenta. |
 |
Enlace al repositorio | https://github.com/discourse/discourse-fontawesome-pro |
 |
Guía de instalación | Cómo instalar plugins en Discourse |
Configuración
Esto requiere algunos pasos adicionales para habilitarlo desde un plugin normal:
Primero, necesitarás configurar una variable de entorno adicional que contenga tu clave de licencia de Font Awesome Pro: DISCOURSE_FONTAWESOME_AUTH_TOKEN
El script de instalación también debe llamarse durante la inicialización, como un gancho adicional “after_code”. Esto descarga y agrega los SVG de FontAwesome Pro en la compilación utilizando tu token de autenticación. Este es un bloque adicional separado del bloque de clonación del plugin.
Aquí tienes un ejemplo de instalación en app.yml:
env:
DISCOURSE_FONTAWESOME_AUTH_TOKEN: 123456
hooks:
after_code:
- exec:
cd: $home/plugins
cmd:
- git clone https://github.com/discourse/discourse-fontawesome-pro.git
- exec:
cd: $home/plugins/discourse-fontawesome-pro
raise_on_fail: false
cmd:
- $home/plugins/discourse-fontawesome-pro/scripts/install.sh
Elegir una familia de reemplazo:
En la configuración de administración, puedes reemplazar la familia de iconos predeterminada de Discourse:
Elegir un estilo de reemplazo:
También puedes reemplazar el estilo de icono predeterminado:
Duotono
Para tener el control total del soporte duotono, deberás reemplazar el siguiente CSS (en un tema o de otro modo) y sustituirlo con tu propia paleta de colores:
svg {
--fa-secondary-color: red;
--fa-secondary-opacity: 0.6;
}
Para colorear iconos individuales, referencia el ID del SVG:
#fad-search .fa-secondary {
--fa-secondary-color: red;
--fa-secondary-opacity: 0.6;
}
Actualización de estilo duotono
Si estás usando selectores basados en clases como:.fa-secondary { color: red; }Necesitarás actualizar tu estilo para usar propiedades personalizadas de CSS en su lugar. Las sobrescrituras de color basadas en clases ya no funcionan, ya que fueron eliminadas en Font Awesome v7
En el fondo, esto utiliza el repositorio de FontAwesome para instalar las fuentes en la carpeta SVG del plugin, y permite que Discourse capture los sprites desde allí.
¿Alojado por nosotros? Este plugin está disponible en nuestros planes Enterprise.
