Configurer les emojis personnalisés

[Discourse]

Ce guide explique comment personnaliser les émojis sur votre site Discourse via des ensembles d’émojis sélectionnables, le téléchargement de nouveaux émojis, la configuration des paramètres du site et l’ajustement des tailles d’émojis.

Niveau d’utilisateur requis : Administrateur

Sélection d’un ensemble d’émojis

Discourse prend actuellement en charge cinq ensembles d’émojis :

• Fluent UI
• Noto
• OpenMoji
• Twemoji
• Standard (Unicode)

Pour un aperçu de l’apparence des différents ensembles, vous pouvez consulter cette comparaison d’ensembles d’émojis. Vous pouvez configurer le paramètre de site emoji_set à l’adresse /admin/config/emoji/settings ainsi que d’autres paramètres liés aux émojis.

Le menu déroulant affiche également des ensembles hérités qui ne sont plus activement pris en charge pour des raisons de licence. Ils restent listés pour la compatibilité ascendante - si votre site utilisait l’un de ces ensembles, il continuera de fonctionner, mais les émojis s’afficheront désormais en utilisant l’ensemble actuel correspondant.

[details=“Tableau montrant les ensembles hérités et leurs remplacements”]
|Ensemble hérité|Remplacement|
|—|—|\n|Apple/International|Twemoji|\n|Facebook Messenger|Standard (Unicode)|\n|Google style|Noto|\n|Google Classic|Noto|\n|Twitter style|Twemoji|\n|Win10 style|Fluent UI|\n\n[/details]

Ajout d’émojis personnalisés

Pour ajouter des émojis personnalisés :

1. Naviguez vers Admin → Apparence → Émoji à l’adresse /admin/config/emoji

2. Cliquez sur le bouton Ajouter un émoji pour nommer, classer et télécharger votre image d’émoji
   Si vous avez plusieurs fichiers d’émojis à télécharger, vous pouvez sélectionner jusqu’à 10 fichiers image dans le sélecteur de fichiers pour un téléchargement groupé. Les noms de fichiers image seront utilisés comme noms d’émojis dans ce cas.

   
   
   

Paramètres des émojis

Vous pouvez accéder aux paramètres des émojis à l’adresse /admin/config/emoji/settings pour personnaliser le comportement des émojis sur votre site.

• enable_emoji - Active l’affichage et l’utilisation des émojis dans votre instance Discourse. S’il est désactivé, les émojis ne seront pas rendus et les utilisateurs ne pourront pas y accéder ni les utiliser dans les champs de texte.
• emoji_set - Sélectionnez votre style d’émoji préféré. Différents ensembles d’émojis peuvent donner des apparences uniques aux émojis affichés sur le site.
• max_emojis_in_title - Nombre maximum d’émojis autorisés dans le titre d’un sujet (par défaut : 1). Si la valeur est zéro, cela empêche l’utilisation de tout émoji dans les titres de sujets.
• enable_emoji_shortcuts - Les émoticônes courantes telles que :) :p :( seront converties en émojis.
• emoji_autocomplete_min_chars - Nombre minimum de caractères requis pour déclencher la fenêtre contextuelle d’auto-complétion d’émojis (par défaut : 0).
• enable_inline_emoji_translation - Active la traduction pour les émojis en ligne (sans espace ni ponctuation avant).
• emoji_deny_list - Ces émojis ne seront pas disponibles pour être utilisés dans les menus ou les raccourcis.
• external_emoji_url - URL d’un service externe pour les images d’émojis. Laissez vide pour utiliser la valeur par défaut.
• discourse_reactions_enabled_reactions - Définit une liste de réactions activées, tout émoji est autorisé ici. Réactions par défaut : +1, laughing, open_mouth, clap, confetti_ball, et hugs.
• discourse_reactions_excluded_from_like - Réactions qui ne comptent pas comme un “J’aime”. Toutes les réactions qui ne figurent pas dans cette liste compteront comme un “J’aime” pour les badges, les signalements et d’autres fins.
• discourse_reactions_allow_any_emoji - Si cette option est activée, un bouton sera ajouté permettant aux utilisateurs de sélectionner n’importe quel émoji dans le sélecteur de réactions. Les membres seront autorisés à choisir n’importe quel émoji, y compris les émojis personnalisés, pour les réactions. Pour limiter les réactions disponibles, utilisez le paramètre de site emoji_deny_list.

Redimensionnement des émojis personnalisés

Par défaut, tous les émojis sont redimensionnés via CSS à 20x20, mais cela peut être remplacé par du CSS personnalisé. Pour conserver le rapport d’aspect correct et la taille native dans les publications, ajoutez le CSS suivant :

/* Rendre les émojis de taille normale (ne pas forcer le carré) */
div.topic-post img.emoji[src*="uploads"], 
div.d-editor-preview img.emoji[src*="uploads"], 
div.emoji-modal img.emoji[src*="uploads"], 
div.d-editor-textarea-wrapper img.emoji[src*="uploads"], 
div.title-wrapper img.emoji[src*="uploads"], 
td.main-link img.emoji[src*="uploads"] {
  width: auto;
  height: auto;
}

Pour personnaliser la taille d’un émoji spécifique, utilisez :

img.emoji[title=":youremoji:"] { 
  height: XXpx; 
  width: YYpx; 
}

Pour redimensionner les émojis dans les messages de chat et le statut de l’utilisateur dans les chats :

div.chat-message-text img.emoji[src*="uploads"], 
span.user-status-message img.emoji[src*="uploads"] {
  width: auto;
  height: auto;
}