|||
-|-|-|
| Riepilogo | Discourse FontAwesome Pro consente l’uso delle icone Font Awesome Pro in Discourse con una licenza FontAwesome utilizzando il token del pacchetto NPM del tuo account.
| Link al Repository | https://github.com/discourse/discourse-fontawesome-pro
| Guida all’Installazione | Come installare plugin in Discourse
Configurazione
Questo richiede alcuni passaggi aggiuntivi per abilitare rispetto a un normale plugin:
Innanzitutto, dovrai configurare una variabile d’ambiente aggiuntiva contenente la chiave di licenza del tuo font awesome pro: DISCOURSE_FONTAWESOME_AUTH_TOKEN
Lo script di installazione deve essere chiamato durante l’inizializzazione, come hook aggiuntivo “after_code”. Questo scarica e aggiunge gli SVG di FontAwesome Pro durante la build utilizzando il tuo token di autenticazione. Questo è un blocco aggiuntivo separato dal blocco di clonazione del plugin.
Ecco un esempio di installazione in 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
Scelta di una famiglia di override:
Nelle impostazioni dell’amministratore, puoi sovrascrivere la famiglia di icone predefinita di Discourse:
Scelta di uno stile di override:
Puoi anche sovrascrivere lo stile di icona predefinito:
Duotone
Per avere il pieno controllo del supporto duotone, dovrai sovrascrivere il seguente CSS (in un tema o altrove) e sostituirlo con il tuo schema di colori:
svg {
--fa-secondary-color: red;
--fa-secondary-opacity: 0.6;
}
Per colorare singole icone, fai riferimento all’ID dell’SVG:
#fad-search .fa-secondary {
--fa-secondary-color: red;
--fa-secondary-opacity: 0.6;
}
Aggiornamento Stile Duotone
Se stai usando selettori basati su classi come:.fa-secondary { color: red; }Dovrai aggiornare il tuo styling per utilizzare invece le proprietà personalizzate CSS. Le sovrascritture di colore basate su classi non funzionano più poiché sono state rimosse in Font Awesome v7
Sotto il cofano, questo utilizza il repository di FontAwesome per installare i font nella cartella SVG del plugin, e consente a Discourse di prelevare gli sprite da lì.
Ospitato da noi? Questo plugin è disponibile sui nostri piani Enterprise.