 |
Résumé | Bouton « Suivre la catégorie » ajoute un élément span qui devient un bouton « Suivre cette catégorie » dans les messages. |
 |
Dépôt | https://github.com/pacharanero/discourse-watch-category-button |
 |
Nouveau avec les thèmes Discourse ? | Guide du débutant pour utiliser les thèmes Discourse |
Installer ce composant de thème
Ce composant de thème utilise la session de l’utilisateur connecté pour mettre à jour les niveaux de notification des catégories ; aucune clé API n’est requise.
Fonctionnalités
-
Ajoute un bouton « Suivre cette catégorie » à l’intérieur des messages à l’aide d’un élément span compatible avec l’assainisseur (sanitizer).
-
Le clic sur le bouton définit le niveau de notification de la catégorie pour l’utilisateur actuel sur Suivi (Watching) pour la catégorie actuelle ou pour une catégorie sélectionnée via CategoryId.
-
Seuls les messages rédigés par les groupes autorisés (par défaut :
staff) sont transformés en boutons (cela vise à réduire le risque que ce composant (TC) soit utilisé à mauvais escient pour faire suivre des catégories par méprise). -
Permet de cibler un ID de catégorie spécifique ou la catégorie du message actuel.
-
S’intègre aux fonctionnalités existantes de notifications de suivi de Discourse, sans modifier la façon dont le statut de suivi est géré par l’utilisateur dans ses préférences, par catégorie, ou via les désabonnements des notifications par e-mail.
Utilisation
Définir une catégorie spécifique
<span data-watch-category="3">Suivre cette catégorie</span>
Utiliser la catégorie du message actuel
<span data-watch-category="current">Suivre cette catégorie</span>
Résultat :
Paramètres
Ce composant n’inclut pas encore de paramètres de thème. Ce sera la prochaine étape, une fois que je me serai assuré qu’il n’y a pas de bogues majeurs et que ce composant (TC) est utile à d’autres personnes.
Considérations de sécurité et de confidentialité
- Ces boutons ne peuvent être créés que par les utilisateurs du groupe #staff (pour le moment)
- Nécessite un clic explicite de l’utilisateur pour modifier les paramètres de notification.
- Aucune clé API n’est utilisée ; cela repose sur la session de l’utilisateur connecté.
Idées pour la feuille de route (Roadmap)
- Rendre les groupes autorisés à créer des boutons configurables via les paramètres du thème.
- Rendre le style du bouton configurable via les paramètres du thème.
- Rendre le niveau de notification configurable (par ex., Suivi discret (Tracking), Suivi actif (Watching), Muet (Muted)).
Contribution
Je suis heureux d’accepter les contributions ! Veuillez ouvrir des issues ou des pull requests sur le dépôt GitHub. Idéalement, améliorons ce composant plutôt que de le dupliquer (fork) pour modifier les ALLOWED_GROUPS ou effectuer d’autres changements mineurs.
Sujets liés
En cherchant à savoir si ce composant (TC) avait déjà été créé, j’ai trouvé quelques sujets demandant des fonctionnalités similaires :
Change notification level with a link
Can I create a link to subscribe to a category? - #3 by david
Make watching a category more prominent for users
Notification setting button with context