FontAwesome Pro per Discourse

:discourse2: Riepilogo Discourse FontAwesome Pro consente l’utilizzo delle icone Font Awesome Pro in Discourse con una licenza FontAwesome utilizzando il token del pacchetto NPM del tuo account.
:hammer_and_wrench: Link al repository https://github.com/discourse/discourse-fontawesome-pro
:open_book: Guida all’installazione Come installare i plugin in Discourse

Configurazione

Questa configurazione richiede alcuni passaggi aggiuntivi rispetto a un plugin normale:

Innanzitutto, devi impostare una variabile d’ambiente aggiuntiva contenente la tua chiave di licenza Font Awesome Pro: DISCOURSE_FONTAWESOME_AUTH_TOKEN

Lo script di installazione deve anche essere chiamato durante l’inizializzazione come hook aggiuntivo “after_code”. Questo scarica e aggiunge gli SVG di FontAwesome Pro durante la compilazione utilizzando il tuo token di autenticazione. Si tratta di 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 di amministrazione, puoi sovrascrivere la famiglia di icone predefinita di Discourse:

Scelta di uno stile di override:

Puoi anche sovrascrivere lo stile predefinito delle icone:

Duotone

Per avere il pieno controllo del supporto duotone, dovrai sovrascrivere il seguente CSS (in un tema o altrimenti) e sostituirlo con la tua combinazione di colori:

svg {
  --fa-secondary-color: red;
  --fa-secondary-opacity: 0.6;
}

Per colorare le singole icone, fai riferimento all’ID dell’SVG:

#fad-search .fa-secondary {
  --fa-secondary-color: red;
  --fa-secondary-opacity: 0.6;
}

:warning: Aggiornamento allo stile duotone
Se stai utilizzando selettori basati su classi come:

.fa-secondary { color: red; }

Dovrai aggiornare il tuo stile per utilizzare le proprietà CSS personalizzate invece. Le sovrascrizioni 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, permettendo a Discourse di recuperare gli sprite da lì.

:discourse2: Ospitato da noi? Questo plugin è disponibile nei nostri piani Enterprise.

36 Mi Piace

@featheredtoast Non ho avuto modo di controllare, ma questo scarica la versione più recente di fontawesome pro, tipo la 6.x?

È stato menzionato un workaround qui:

L’ultima versione supporta già FA6 pro? @featheredtoast

Temo di no, non ancora. Penso che sia ancora così:

3 Mi Piace

Per chi se lo stesse chiedendo, questo non funziona ancora con la v6, anche con il core più recente che lo supporta, è ancora necessario utilizzare --branch fa5 per far funzionare le icone pro.

3 Mi Piace

Questo plugin è ancora mantenuto? Sono curioso se a questo punto potremmo usare le icone pro di FA(6)

Ha bisogno di un po’ di riordino: è in lista, ci stiamo lavorando - Scusate per la polvere.

2 Mi Piace

Ciao a tutti, ho aggiornato questo plugin per funzionare con FontAwesome v7. Aggiornerò presto la documentazione.

6 Mi Piace

È possibile che lo stile regular non venga applicato correttamente nelle impostazioni del plugin? Quando controllo Find Icons with the Perfect Look & Feel | Font Awesome, le icone FA in stile regular sono tutte vuote, ma sul mio sito le icone hanno ancora uno stile pieno

2 Mi Piace

Grazie per la segnalazione, la correzione è già stata unita. Fammi sapere se riscontri altri problemi.

2 Mi Piace

Ciao Juan,
È in qualche modo correlato?

1 Mi Piace

Qualcun altro ha un problema con l’icona “d-icon-d-watching-first” che non funziona quando il plugin è abilitato?
Testato su 3.6.0.beta2

1 Mi Piace

Ottima osservazione. Ho appena aggiornato il plugin in modo che mostri nuovamente l’icona corretta.

2 Mi Piace

un altro bug (ri)apparso con le seguenti impostazioni:
Stile icona Fa impostato su regular
Famiglia icona Fa impostata su classic

Quando è impostato un segnalibro con promemoria, non viene visualizzata alcuna icona:

CleanShot 2025-11-24 at 15.58.04@2x

2 Mi Piace

Grazie! Ho appena caricato una correzione. Dovrebbe funzionare ora.

2 Mi Piace

@Alteras

Cosa ne pensi di una funzionalità aggiuntiva del plugin che consenta di utilizzare uno stile diverso per tutte le icone di stato attivo? Ad esempio, vedo la tendenza a utilizzare icone piene (in FA: stile “solid”) per lo stato attivo e icone vuote (in FA: stile “regular”) per lo stato normale.

Mentre uso Discourse, ho notato che sembra “strano” avere icone vuote (alias stile FA regular) nello stato attivo.

2 Mi Piace

Sembra che l’API non funzioni con il piano Lite da $60, immagino che sia necessario il piano Pro da $99 all’anno per utilizzare l’API per le icone pro…