Aller au contenu

Gérer les plugins de diffusion (administrateur)

Vous êtes administrateur·ice d'une instance Kirexo et vous voulez piloter les plugins de diffusion (les canaux : web, RSS, Mastodon…) pour toute la plateforme : les activer ou désactiver globalement, lire combien d'articles chaque canal a servi à publier, et comprendre le verrou qui empêche de couper un canal déjà utilisé. Cette recette se fait depuis la page /admin/plugins.

Prérequis

Activation globale (admin) ≠ activation par compte (utilisateur)

Cette page contrôle la disponibilité d'un canal pour toute l'instance — un « kill switch ». Chaque utilisateur choisit ensuite, parmi les canaux que vous avez activés globalement, ceux qu'il active pour son propre compte depuis ses réglages. Un canal désactivé globalement n'apparaît chez aucun utilisateur.

Ouvrir la page des plugins

Connecté·e en administrateur·ice, rendez-vous sur /admin/plugins. La page « Plugins de diffusion » affiche, sous le fil d'Ariane Admin › Plugins, une ligne par canal enregistré sur l'instance. Chaque ligne comporte :

  • une pastille de couleur propre au canal ;
  • le libellé du canal (par exemple Web) ;
  • un badge compteur « N publié(s) » (voir plus bas) ;
  • l'état d'activation globale et un bouton de bascule.

Lire les compteurs d'articles

Le badge « N publié(s) » de chaque ligne indique le nombre d'articles publiés via ce canal, à l'échelle de toute la plateforme (tous auteurs confondus). Un canal qui n'a encore jamais servi affiche « 0 publié ».

Ce compteur est dérivé des destinations des articles publiés : il se recalcule à chaque affichage de la page. Il n'existe aucun journal séparé à consulter ni à purger.

Admin ≠ publication

La page n'expose que des métadonnées de canal et des compteurs. Vous n'y voyez ni titre, ni corps d'article, et vous ne pouvez rien y rédiger ni publier. L'administration gère les canaux, jamais le contenu.

Activer ou désactiver globalement un canal

Sur la ligne du canal visé, le bouton de bascule bascule l'état global :

  1. Si le canal est désactivé globalement, son bouton affiche « Activer ». Cliquez dessus : le canal devient disponible pour toute la plateforme et l'état passe à « Activé ».
  2. Si le canal est activé, son bouton affiche « Désactiver ». Cliquez dessus pour le couper : il redevient indisponible et disparaît des réglages de tous les utilisateurs.

L'état affiché à côté du bouton se met à jour immédiatement.

Comprendre le verrou : on ne coupe pas un canal déjà utilisé

Un canal qui a déjà servi à publier au moins un article ne peut plus être désactivé globalement. C'est une protection : couper un tel canal reviendrait à retirer un mode de diffusion sur lequel des publications existantes reposent déjà.

Dans ce cas, le bouton de bascule est verrouillé (désactivé) et une infobulle explique le refus, par exemple :

Le plugin « Web » a déjà diffusé au moins un article publié : il ne peut plus être désactivé.

Si une tentative de désactivation est malgré tout refusée par cette règle, un message d'alerte s'affiche en haut de la page pour la même raison. Vous pouvez toujours réactiver un canal désactivé ; seul le sens « désactiver un canal déjà utilisé » est bloqué.

Le verrou est une règle métier, pas une question de droits

Le refus ne vient pas d'un manque d'autorisation : en tant qu'administrateur·ice, vous êtes autorisé·e à basculer les canaux. C'est le canal lui-même, parce qu'il a déjà diffusé, qui ne peut plus être coupé. Un badge d'état affiche alors « Activé (verrouillé) ».

Ce verrou ne s'applique qu'à la portée globale

Le verrou « activé-et-utilisé » ne concerne que cette page d'administration. Côté utilisateur, chaque auteur·ice peut désactiver un canal pour son propre compte à tout moment, même après avoir publié dessus — sans perdre ses réglages. Le pourquoi de cette asymétrie est détaillé dans Pourquoi l'activation des plugins est asymétrique.

En cas de problème

  • Je ne vois pas la page /admin/plugins (erreur 403 ou 404). L'accès est réservé à ROLE_ADMIN. Pour un visiteur connecté à l'espace utilisateur, l'admin se masque (404) ; assurez-vous d'être connecté·e sur l'espace d'administration (/admin/login). Voir Architecture des firewalls.
  • La ligne d'un canal reste sur « Désactiver » impossible. Le canal a déjà diffusé un article : c'est le verrou décrit ci-dessus, pas un bug. Le compteur de la même ligne le confirme (au moins 1 publié).
  • Aucun plugin n'est listé. L'instance n'a aucun canal enregistré. Les plugins sont fournis par le code de la plateforme ; si la liste est vide, aucun canal n'est encore disponible.

Voir aussi