Discourse Stickers v2.0
Cette version représente une modernisation assez significative du composant. Outre un certain nombre d’améliorations internes, la configuration des autocollants a été repensée pour faciliter la gestion de collections d’autocollants plus volumineuses.
Paramètres des autocollants entièrement repensés
Le changement le plus important dans la v2.0 concerne la configuration des autocollants elle-même.
L’ancienne version stockait les autocollants sous forme de paramètre JSON contenant des valeurs telles que :
-
title -
emoji -
previewUrl -
markdownUrl
Dans la v2.0, cela a été remplacé par le type de paramètre objects natif de Discourse.
Chaque autocollant est désormais un objet configurable à part entière avec ses propres champs :
-
Titre - le nom de l’autocollant / texte de l’infobulle
-
Groupe - organiser optionnellement les autocollants en groupes
-
Badge émoji - afficher optionnellement un petit émoji dans le coin
-
Image - télécharger l’autocollant directement via le paramètre
-
Catégories - restreindre optionnellement les autocollants à des catégories spécifiques
-
Masquer dans les messages privés - contrôler si un autocollant est disponible dans les MP
-
Canaux de chat - restreindre optionnellement les autocollants à des canaux de chat publics spécifiques
Cela rend la configuration des autocollants beaucoup plus facile à comprendre et à maintenir, en particulier pour les collections volumineuses.
Groupes d’autocollants et filtrage
Vous pouvez désormais attribuer des autocollants à un Groupe.
Lorsque plusieurs groupes sont disponibles, le sélecteur d’autocollants affiche automatiquement une barre de filtres en haut.
Vous pouvez basculer entre :
-
Tous
-
les groupes individuels
-
Autre pour les autocollants sans groupe
Le filtre est généré dynamiquement à partir des autocollants actuellement disponibles pour l’utilisateur.
Autocollants spécifiques à une catégorie
Les autocollants peuvent désormais être attribués optionnellement à des catégories Discourse spécifiques.
Si un autocollant a des catégories configurées, il n’apparaîtra dans le composant de message/réponse classique que si l’une de ces catégories est sélectionnée.
Si aucune catégorie n’est configurée, l’autocollant reste disponible partout.
Plus de contrôle sur les autocollants de Chat
La v2.0 offre plus de contrôle sur la disponibilité des autocollants dans Discourse Chat.
Vous pouvez désormais :
-
masquer des autocollants individuels des messages privés ;
-
restreindre les autocollants à des canaux de chat publics spécifiques ;
-
laisser le paramètre de canal vide pour rendre un autocollant disponible dans tous les canaux de chat publics/catégorie.
Cela permet aux administrateurs de maintenir différents ensembles d’autocollants pour différentes parties de leur communauté.
Les autocollants publiés ne sont plus cliquables
Les autocollants publiés sont désormais traités comme des images non interactives.
Ils n’ouvrent plus la lightbox Discourse lorsqu’on clique dessus.
Cela s’applique à la fois aux :
-
autocollants dans les messages classiques ;
-
autocollants publiés dans le Chat.
L’objectif est de faire en sorte que les autocollants se comportent davantage comme du contenu d’autocollant/réaction plutôt que comme des images téléchargées normales.
Meilleur état vide
Si aucun autocollant n’est disponible pour le contexte actuel, le sélecteur affiche désormais un état vide approprié au lieu d’afficher simplement un sélecteur vide.
Par exemple, cela peut se produire lorsque les restrictions de catégorie ou de Chat empêchent tout autocollant d’être disponible.
Migration des configurations d’autocollants existantes
L’une des parties les plus importantes de la v2.0 est que les installations existantes n’ont pas besoin de recréer leur collection d’autocollants.
L’ancien paramètre JSON sticker_images est automatiquement migré vers le nouveau format objects lors de la mise à jour du composant.
Les titres et les valeurs émoji des autocollants existants sont conservés.
Plus important encore, les images d’autocollants téléchargées existantes sont également migrées automatiquement.
Ainsi, si vous avez déjà des dizaines d’autocollants configurés, la mise à jour vers la v2.0 ne devrait pas vous obliger à les télécharger tous à nouveau.
L’ancienne propriété markdownUrl n’est plus nécessaire et n’est pas conservée car le nouveau champ Image représente le téléchargement Discourse effectif.