Discourse FontAwesome Pro

[Discourse]

	Résumé	Discourse FontAwesome Pro permet l’utilisation d’icônes Font Awesome Pro dans Discourse grâce à 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

Étant donné qu’il s’agit d’un plugin #officiel maintenu par l’équipe Discourse, les demandes de Support, Contribute > Bug, Contribute > UX et Contribute > Feature peuvent être faites dans les catégories respectives ici sur Meta, et étiquetées avec l’étiquette de plugin appropriée. Cliquez sur un lien ci-dessous pour en démarrer une.

 Support  Bug  UX  Fonctionnalité

Configuration

Cela nécessite quelques étapes supplémentaires pour l’activer par rapport à un plugin normal :

D’abord, vous devrez définir une variable d’environnement supplémentaire contenant votre jeton de package font awesome pro (notez que c’est différent de votre jeton API) : DISCOURSE_FONTAWESOME_AUTH_TOKEN

Le script d’installation doit également être appelé pendant l’initialisation, en tant qu’accroche « after_code » supplémentaire. Cela télécharge et ajoute les SVG FontAwesome Pro lors de la construction en utilisant votre jeton d’authentification. C’est 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 de substitution :

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

Choisir un style de substitution :

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

Duotone

Pour prendre un contrôle total de la prise en charge 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 des classes ne fonctionnent plus car ils ont été abandonnés dans Font Awesome v7

---

En interne, 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 depuis là.

Hébergé par nous ? Ce plugin est disponible sur 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]

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 (Lillian)]

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