Discourse FontAwesome Pro

[Discourse]

| |
|-|-|-|
| | Résumé | Discourse FontAwesome Pro permet d’utiliser les icônes Font Awesome Pro dans Discourse avec une licence FontAwesome en utilisant le jeton de package NPM de votre compte.|
| | Lien du dépôt | https://github.com/discourse/discourse-fontawesome-pro|
| | Guide d’installation | Comment installer des plugins dans Discourse|

Comme il s’agit d’un plugin official maintenu par l’équipe Discourse, les demandes de Support, de signalement de Contribute > Bug, de contributions Contribute > UX et de nouvelles fonctionnalités Contribute > Feature peuvent être formulées dans les catégories respectives ici sur Meta, et étiquetées avec le tag approprié du plugin. Cliquez sur un lien ci-dessous pour en créer une.

 Support  Bug  UX  Fonctionnalité

Configuration

Cela nécessite quelques étapes supplémentaires par rapport à un plugin normal pour être activé :

Tout d’abord, vous devrez définir une variable d’environnement supplémentaire contenant votre clé de licence Font Awesome Pro : DISCOURSE_FONTAWESOME_AUTH_TOKEN

Le script d’installation doit également être appelé lors de l’initialisation, en tant que hook supplémentaire “after_code”. Cela permet de télécharger et d’ajouter les SVGs de FontAwesome Pro lors de la construction en utilisant votre jeton d’authentification. Il s’agit d’un bloc supplémentaire distinct du bloc de clonage du plugin.

Voici un exemple d’installation dans 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

---

Choisir une famille d’override :

Dans les paramètres d’administration, vous pouvez remplacer la famille d’icônes Discourse par défaut :

Choisir un style d’override :

Vous pouvez également remplacer le style d’icône par défaut :

Duotone

Pour avoir un contrôle total sur le support du duotone, vous devrez remplacer le CSS suivant (dans un thème ou autrement) et le remplacer par votre propre schéma de couleurs :

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

Pour colorer des icônes individuelles, référencez l’ID du SVG :

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

Mise à jour du style Duotone
Si vous utilisez des sélecteurs basés sur des classes comme :

.fa-secondary { color: red; }

Vous devrez mettre à jour votre style pour utiliser des propriétés CSS personnalisées à la place. Les remplacements de couleurs basés sur les classes ne fonctionnent plus car ils ont été supprimés dans Font Awesome v7

---

Sous le capot, cela utilise le dépôt de FontAwesome pour installer les polices dans le dossier SVG du plugin, et permet à Discourse de récupérer les sprites à partir de là.

Hébergé par nous ? Ce plugin est disponible dans nos plans Entreprise.

[TheDarkWizard]

@featheredtoast Je n’ai pas eu la chance de vérifier, mais télécharge-t-il la version la plus récente de fontawesome pro, comme la 6.x ?

[jrgong]

Il y avait une solution de contournement mentionnée ici :

How to use Font Awesome Pro v6?

<link rel="stylesheet" href="path/to/font-awesome-pro-v6/css/all.min.css"> Obtain the Font Awesome Pro v6 package: Sign in to your Font Awesome account. Download the Font Awesome Pro v6 package, which includes the necessary CSS and font files. Replace “path/to/font-awesome-pro-v6” with the actual path where you have stored the Font Awesome Pro v6 CSS file. By adding the <link> tag to your Discourse theme’s “head_tag.html” file, you’re referencing the Font Awesome Pro v6 CSS file, which will l…

[jrgong]

La dernière version prend-elle déjà en charge FA6 pro ? @featheredtoast

[JammyDodger]

Je crains que ce ne soit pas encore le cas. Je pense que c’est toujours le cas :

@awesomerobot

Nous n’avons pas encore officiellement mis à jour vers la v6… la v6 modifie certaines icônes, en renomme beaucoup, et en supprime certaines… c’est donc un travail considérable pour trouver tout ce qui doit être mis à jour et remplacé. J’espère que nous pourrons nous en occuper bientôt.

[davidkingham]

Pour ceux qui se demandent, cela ne fonctionne toujours pas avec la v6, même avec le dernier noyau qui le prend en charge, vous devez toujours utiliser --branch fa5 pour que les icônes pro fonctionnent.

[jrgong]

Ce plugin est-il toujours maintenu ? Je me demande si nous pourrions utiliser les icônes pro de FA(6) à ce stade.

[featheredtoast (Jeff Wong)]

Il a besoin d’un peu de rangement - c’est sur la liste, nous y travaillons - Veuillez excuser la poussière.

[Juan_David_Martínez (Juan David Martinez Cubillos)]

Salut à tous, j’ai mis à jour ce plugin pour qu’il fonctionne avec FontAwesome v7. Je mettrai bientôt à jour la documentation.

[jrgong]

Est-il possible que le style regular ne soit pas appliqué correctement dans les paramètres du plugin ? En consultant Find Icons with the Perfect Look & Feel | Font Awesome, les icônes FA de style regular sont toutes creuses, mais sur mon site, les icônes ont toujours un style plein.

[Juan_David_Martínez (Juan David Martinez Cubillos)]

Merci d’avoir signalé le problème, la correction a déjà été fusionnée. Faites-moi savoir si vous rencontrez d’autres problèmes.

[putty (Derek Putnam)]

Salut Juan,
Est-ce que c’est lié par hasard ?

[jrgong]

Quelqu’un d’autre a-t-il un problème avec l’icône « d-icon-d-watching-first » qui ne fonctionne pas lorsque le plugin est activé ?
Testé sur 3.6.0.beta2

[Alteras (Steven Chang)]

Ah, bien vu. Je viens de mettre à jour le plugin pour qu’il affiche à nouveau la bonne icône.

[jrgong]

autre bug (ré)apparu avec les paramètres suivants :
Style d’icône Fa réglé sur régulier
Famille d’icônes Fa réglée sur classique

Lorsqu’un signet avec un rappel est défini, aucune icône n’est affichée :

[Alteras (Steven Chang)]

Merci ! Je viens de pousser un correctif pour cela. Cela devrait fonctionner maintenant.

[jrgong]

@Alteras

Que pensez-vous d’une fonctionnalité de plugin supplémentaire qui permettrait d’utiliser un style différent pour toutes les icônes d’état actif ? Par exemple, je constate la tendance à utiliser des icônes pleines (style « solid » dans FA) pour l’état actif et des icônes creuses (style « regular » dans FA) pour l’état normal.

En utilisant Discourse, j’ai remarqué qu’il est « étrange » d’avoir des icônes creuses (style FA regular) dans l’état actif.

[hipp0]

L’API ne semble pas fonctionner avec le forfait Lite à 60 , je suppose que vous avez besoin du forfait Pro à 99 par an pour utiliser l’API pour les icônes professionnelles…

[Lilly]

Non, l’API nécessite l’option de téléchargement et l’utilisation d’applications SVG, ce qui requiert le plan Pro (ou supérieur). Le plan Pro Lite ne permet qu’une utilisation web limitée via leur kit. Ce n’est pas très clair et cela devrait probablement être ajouté au message original.

Font Awesome