Aller au contenu

Pourquoi l'activation des plugins est asymétrique (utilisateur vs administrateur)

Un plugin de diffusion peut être activé à deux portées distinctes : globalement, pour toute l'instance (décision de l'administration), et individuellement, pour un compte (décision de l'auteur·ice). Ces deux portées suivent une règle commune — on ne veut pas casser des publications existantes — mais elles n'en tirent pas la même conséquence. Cette page explique pourquoi, et pourquoi désactiver un plugin côté utilisateur n'efface jamais ses réglages.

Le comment faire vit ailleurs : Gérer les plugins de diffusion (administrateur) et Activer un plugin pour son compte. Le raisonnement structurel sur les plugins comme bundles isolés est dans Architecture des plugins de diffusion.

Deux portées, un même invariant de départ

L'état d'un plugin est calculé sur quatre valeurs — Indisponible, Disponible, Activé, Activé (verrouillé) — définies par l'énumération Kirexo\Plugin\Contracts\PluginState (src/Plugin/Contracts/PluginState.php). L'état Activé (verrouillé) signifie « activé et déjà utilisé pour publier au moins un article ».

À l'origine, ce verrou « activé-et-utilisé » était appliqué symétriquement aux deux portées : ni l'administration ni l'utilisateur ne pouvaient couper un plugin ayant déjà servi. L'intention était bonne — protéger les publications existantes — mais la conséquence était trop forte côté utilisateur : un auteur se retrouvait prisonnier d'un canal dès sa première publication, sans pouvoir masquer un espace dont il ne voulait plus.

La dissymétrie : ce que « casser une publication » veut dire à chaque échelle

La règle diverge parce que l'enjeu n'est pas le même selon la portée.

  • Côté administration (portée globale), couper un canal déjà utilisé retire un mode de diffusion à l'échelle de la plateforme, sur lequel reposent les publications de tous les auteurs. C'est irréversible du point de vue des lecteurs : un site public qui disparaît pour tout le monde, un flux qui s'éteint. Le verrou reste donc actif en portée globale. L'administration peut réactiver un canal, jamais désactiver un canal déjà utilisé. Cette règle est portée par PluginActivationService::setGlobal() (src/Service/Plugin/PluginActivationService.php), qui lève une exception si l'état global est Activé (verrouillé).

  • Côté utilisateur (portée compte), désactiver un plugin ne concerne que son propre compte. Cela ne casse aucune publication d'un autre auteur, et surtout cela ne détruit rien : c'est un simple masquage, réversible. Le verrou est donc levé en portée utilisateur. PluginActivationService::setForUser() refuse toujours d'activer un plugin coupé globalement (invariant « user ⊆ global »), mais n'oppose plus aucun verrou à la désactivation.

En résumé : l'administration protège la plateforme, l'utilisateur reste maître de son compte. Le même invariant de départ produit deux décisions opposées parce que la portée de la casse potentielle n'est pas la même.

Désactiver n'est pas perdre : masquage, pas purge

Le point central côté utilisateur est que désactiver un plugin ne supprime aucun réglage. Quand un auteur coupe le plugin Web, la désactivation écrit seulement un drapeau enabled = false sur son activation ; ses données de site — domaine, pages spéciales, apparence — restent en base, intactes.

Ce qui change est uniquement l'exposition :

  • les points d'entrée de configuration du plugin disparaissent de la navigation — pour le plugin Web, le lien « Configurer Web » du menu ⋯ de chaque carnet, via App\Twig\Components\NotebookConfigLinks (src/Twig/Components/NotebookConfigLinks.php), qui ne retient que les plugins actifs pour le propriétaire du carnet ;
  • l'entrée que le plugin contribue au menu du compte — « Mes thèmes » pour le plugin Web — disparaît elle aussi : App\Twig\Components\UserMenuPluginLinks (src/Twig/Components/UserMenuPluginLinks.php) n'affiche une contribution que si le plugin est actif pour l'utilisateur courant, précisément pour ne pas exposer une fonctionnalité inaccessible ;
  • les URL de l'espace user du plugin (préfixe /u/web/, réglages et aperçu) renvoient une 404, via WebSettingsAccessSubscriber (src/Plugin/Web/src/EventSubscriber/WebSettingsAccessSubscriber.php).

Aucun de ces deux mécanismes ne touche aux données : ils lisent l'état d'activation et masquent. Réactiver le plugin fait donc réapparaître les entrées de configuration avec tous leurs réglages tels qu'ils étaient. C'est ce qui rend la désactivation utilisateur sans danger, et donc autorisable : elle est parfaitement réversible.

Le masquage suit donc la portée de chaque point d'entrée : par carnet pour la configuration du site — il n'existe aucune entrée « Mon site » globale à faire disparaître, puisque cette configuration appartient au carnet — et par compte pour ce qui est de portée compte, comme la bibliothèque de thèmes. Dans les deux cas, c'est la même règle qui décide : le plugin est-il actif pour cet utilisateur ? Voir Configuration par carnet et extensibilité des plugins.

Pourquoi l'état « verrouillé » continue d'exister malgré tout

On aurait pu supprimer l'état Activé (verrouillé) du calcul puisqu'il ne bloque plus l'utilisateur. Ce n'est pas le choix retenu : l'état reste calculé de façon uniforme par le resolver, parce qu'il porte une information sémantique juste — « ce canal a déjà diffusé » — utile à l'affichage administrateur (badge + infobulle de refus).

La dissymétrie ne vit donc pas dans le calcul de l'état, mais dans son interprétation selon la portée :

  • le service PluginActivationService ne transforme le verrou en refus que pour la portée globale ;
  • le composant App\Twig\Components\PluginToggle (src/Twig/Components/PluginToggle.php) ne présente le verrou comme bloquant qu'en portée globale, et affiche simplement « Activé » (jamais « Activé (verrouillé) ») en portée utilisateur.

Garder une source unique pour l'état, tout en localisant la décision d'action dans le service et l'affichage dans le composant, évite d'introduire un état intermédiaire « à moitié verrouillé » et maintient l'autorisation (le Voter) séparée de la règle métier (le service).

Voir aussi