Discourse FontAwesome Pro

:discourse2: Resumo Discourse FontAwesome Pro permite o uso de ícones Font Awesome Pro no Discourse com uma licença FontAwesome usando o token do pacote NPM da sua conta.
:hammer_and_wrench: Link do Repositório https://github.com/discourse/discourse-fontawesome-pro
:open_book: Guia de Instalação Como instalar plugins no Discourse

Configuração

Ative a configuração do site fontawesome pro icons enabled e insira seu token do pacote font awesome pro (observe que é diferente do seu token de API) na configuração do site fontawesome auth token. O Discourse baixa os ícones em segundo plano.

Você também pode definir o token com a variável de ambiente DISCOURSE_FONTAWESOME_AUTH_TOKEN. Se este método for usado, a chave não será editável na interface do usuário.

Versões anteriores deste plugin exigiam executar scripts/install.sh em seu app.yml. Isso não é mais necessário e pode ser removido.


Escolhendo uma família substituta:

Nas configurações de administrador, você pode substituir a família padrão de ícones do Discourse:

Escolhendo um estilo substituto:

Você também pode substituir o estilo padrão do ícone:

Duotone

Para ter controle total sobre o suporte duotone, você precisará substituir o seguinte CSS (em um tema ou de outra forma) e substituí-lo por seu próprio esquema de cores:

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

Para colorir ícones individuais, referencie o ID do SVG:

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

:warning: Atualização de Estilo Duotone
Se você estiver usando seletores baseados em classes como:

.fa-secondary { color: red; }

Você precisará atualizar seu estilo para usar propriedades personalizadas de CSS em vez disso. As substituições de cor baseadas em classes não funcionam mais, pois foram descontinuadas no Font Awesome v7


Por baixo dos panos, isso está usando o repositório da FontAwesome para instalar fontes na pasta SVG do plugin, e permite que o Discourse carregue os sprites de lá.

:discourse2: Hospedado por nós? Este plugin está disponível em nossos planos Enterprise.

36 Curtiram

@featheredtoast Ainda não tive a chance de verificar, mas isso baixa a versão mais recente do Font Awesome Pro, como a 6.x?

1 Curtiu

Houve uma solução alternativa mencionada aqui:

A versão mais recente já suporta o FA6 pro? @featheredtoast

Receio que ainda não. Acho que este ainda é o caso:

3 Curtiram

Para quem estiver se perguntando, isso ainda não funciona com a v6, mesmo com o core mais recente dando suporte, você ainda precisa usar --branch fa5 para que os ícones pro funcionem.

3 Curtiram

Este plugin ainda está em manutenção? Estou curioso se poderíamos usar os ícones do FA(6) pro neste momento.

Precisa de alguns retoques - está na lista, estamos trabalhando nisso - Desculpe a poeira.

2 Curtiram

Olá a todos, atualizei este plugin para funcionar com o FontAwesome v7. Atualizarei a documentação em breve.

6 Curtiram

É possível que o estilo regular não esteja sendo aplicado corretamente nas configurações do plugin? Ao verificar Find Icons with the Perfect Look & Feel | Font Awesome, os ícones FA no estilo regular estão todos vazados, mas no meu site os ícones ainda têm um estilo preenchido

2 Curtiram

Obrigado por relatar, a correção já foi mesclada. Informe se encontrar outros problemas.

2 Curtiram

Olá Juan,
Isso tem alguma relação por acaso?

1 Curtiu

Mais alguém está tendo um problema com o ícone “d-icon-d-watching-first” que não funciona quando o plugin está ativado?
Testado em 3.6.0.beta2

1 Curtiu

Ah, boa observação. Acabei de atualizar o plugin para que ele mostre o ícone correto novamente.

2 Curtiram

outro bug (re)surgiu com as seguintes configurações:
Estilo de ícone Fa definido como regular
Família de ícones Fa definida como clássica

Quando um favorito com lembrete é definido, nenhum ícone é exibido:

CleanShot 2025-11-24 at 15.58.04@2x

2 Curtiram

Obrigado! Acabei de enviar uma correção para isso. Deve funcionar agora.

2 Curtiram

@Alteras

O que você acha de um recurso adicional de plugin que permita usar um estilo diferente para todos os ícones de estado ativo? Por exemplo, vejo a tendência de ícones preenchidos (em FA: estilo de ícone “sólido”) sendo usados para o estado ativo e ícones vazados (em FA: estilo de ícone “regular”) para o estado normal.

Ao usar o Discourse, notei que parece “estranho” ter ícones vazados (também conhecidos como estilo regular do FA) no estado ativo.

2 Curtiram

A API parece não funcionar com o plano Lite de $60, presumo que você precise do plano Pro de $99 por ano para usar a API para ícones profissionais…

não, a API precisa da opção de download e do uso em aplicativos SVG, o que requer o plano Pro (ou superior). O plano Pro Lite permite apenas uso limitado na web por meio do kit deles. Eles não deixam isso super claro e isso provavelmente deveria ser adicionado à postagem original.