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¶
- Un compte porteur de
ROLE_ADMIN. Pour en provisionner un, voir Créer un compte utilisateur en CLI. - Être connecté·e à l'espace d'administration. Si ce n'est pas le cas, commencez par vous connecter sur
/admin/login.
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 :
- 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é ».
- 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¶
- Pourquoi l'activation des plugins est asymétrique — pourquoi le verrou vaut ici mais pas côté utilisateur.
- Activer un plugin pour son compte — le pendant côté utilisateur : activer, parmi les canaux que vous avez ouverts globalement, ceux de son propre compte.
- Choisir les destinations d'un article et prévisualiser son rendu web — comment un auteur choisit, article par article, vers quels canaux activés diffuser.
- Espaces utilisateur et admin — l'accueil
/u, le dashboard/adminet les pages de réglages.