Pages spéciales du plugin web¶
Cette page explique pourquoi le plugin web de Kirexo introduit une notion de page spéciale — un contenu rédigé « comme un article » mais qui n'est pas un article — et quels choix de conception découlent de son isolement. Pour comprendre la séparation entre contenu de travail et contenu publié d'un article, voir Contenu de travail, révisions et corbeille ; pour le rôle du plugin web dans l'architecture à plugins, voir Architecture.
Un contenu rédigé « comme un article », mais qui n'en est pas un¶
Une page spéciale est un contenu que l'utilisateur écrit avec les mêmes gestes qu'un article : un titre, du markdown, un statut brouillon ou publié. Elle sert à porter les pages d'accompagnement d'un site — « À propos », « Contact », mentions légales — que l'on veut afficher à côté de la frise des articles, sans qu'elles soient elles-mêmes des articles diffusés.
La ressemblance s'arrête à l'expérience de rédaction. Une page spéciale n'est jamais un App\Entity\Article. C'est une entité distincte, SpecialPage (src/Plugin/Web/src/Entity/SpecialPage.php), qui vit dans le bundle du plugin web et nulle part ailleurs. Elle ne référence aucun article, n'apparaît dans aucun carnet, et n'entre pas dans le pipeline de diffusion multi-canaux.
Une donnée locale au bundle, par principe d'isolation¶
Kirexo repose sur un principe : un plugin de diffusion est un bundle isolé, supprimable sans laisser de dette dans le cœur. Retirer le bundle web ne doit rien casser dans l'application principale. Ce principe dicte plusieurs décisions autour de la page spéciale.
- Aucune dépendance sortante du cœur vers le bundle. Le cœur de Kirexo ne connaît pas
SpecialPage. La dépendance ne va que dans un sens : le bundle web peut lire des ports du cœur (par exempleArticleRepositoryInterfacepour réagir à une publication), jamais l'inverse. - Un statut local, pas celui de l'article. Le statut d'une page spéciale est porté par sa propre énumération,
SpecialPageStatus(src/Plugin/Web/src/Entity/Enum/SpecialPageStatus.php), avec deux valeurs seulement :Draft(brouillon) etPublished(publié). On ne réutilise pasApp\Entity\Enum\ArticleStatus: les étatsUnpublishedetTrashedd'un article — pensés pour le cycle de vie de la diffusion et la corbeille — n'ont aucun sens pour une page « À propos ». Recopier l'enum du cœur créerait précisément le genre de couplage que l'isolation veut éviter. - Une donnée qui disparaît avec le bundle. Comme
SpecialPagevit dans le bundle et n'est référencée par rien du cœur, désinstaller le plugin web fait disparaître ses pages spéciales sans orphelin ni contrainte pendante côté application. C'est le corollaire assumé de l'isolation : ces pages appartiennent au web et seulement au web.
Cette localité tranche avec le modèle d'un article, qui est au contraire une donnée partagée du cœur, exposée à tous les canaux de diffusion. Un article existe pour être diffusé partout ; une page spéciale existe pour n'exister que sur le site web.
Le slug : normalisé, unique par site, et parfois réservé¶
Chaque page spéciale porte un slug — le segment d'URL qui l'identifie sur le site. Plutôt que de laisser un champ texte libre, Kirexo en fait un Value Object, Slug (src/Plugin/Web/src/ValueObject/Slug.php), qui ne peut jamais exister dans un état invalide : la validation se fait au constructeur, sinon une exception est levée. Trois invariants sont garantis.
- Normalisation kebab-case. Le slug brut est translittéré en ASCII (les accents tombent), les séparateurs deviennent des tirets, tout passe en minuscules, et les tirets de bord sont retirés.
Slugd'entrée « Mon Été 2024 ! » devientmon-ete-2024. La normalisation évite les doublons visuels (« À propos » et « a-propos » ne doivent pas cohabiter comme deux URL différentes) et garantit des adresses propres. - Unicité par site. Deux pages d'un même site ne peuvent pas partager un slug. Cette unicité est portée jusqu'en base par une contrainte
(site_id, slug)sur la table, doublée d'un pré-check applicatif. Elle est par site, pas globale : deux utilisateurs distincts peuvent chacun avoir une pagea-propossur leur propre site. - Slugs réservés. Certains slugs sont interdits parce qu'ils entreraient en collision avec le routage ou des chemins sensibles de l'application :
admin,api,feed,rss,login,logout,search,sitemap… (liste complète dans la constanteRESERVEDdu Value Object). Autoriser une pageadminreviendrait à laisser un utilisateur masquer ou détourner une route de la plateforme. La réservation ferme cette porte à la source, au moment même où le slug est construit.
À noter : les chemins techniques à points (comme /.well-known/*) ne figurent pas dans la liste des réservés — la normalisation kebab-case supprime les points, un slug utilisateur ne peut donc jamais les produire. Leur protection relève du routage multi-tenant du site, pas du Value Object.
Statut et ordre pilotent l'affichage public¶
Deux propriétés de la page gouvernent ce que voit un visiteur du site public.
- Le statut décide de la visibilité. Une page en
Draftn'existe pas pour le public ; seule une pagePublishedest servie. Le rendu public interroge directement le statut en base et ne sert que les pages publiées — il ne passe pas par le contrôle d'accès propriétaire, qui protège la surface de gestion (les réglages du site), pas la lecture anonyme d'une page déjà publiée. - L'ordre dans le header (
headerOrder) décide de la place. Les pages publiées sont listées dans le header du site, triées par ordre croissant de ce champ puis par date de création. C'est ainsi qu'un utilisateur choisit de faire apparaître « À propos » avant « Contact » dans la navigation de son site.
La transition entre les deux statuts est délibérée et réversible : publish() fait passer la page en publié et fige sa première date de publication (les publications suivantes ne l'écrasent pas), tandis que unpublishToDraft() la repasse en brouillon tout en conservant la trace de cette première publication.
Les brouillons sont toujours groupés sous les publiées¶
Dans les réglages du site, la liste de gestion mêlerait sinon des lignes qui pèsent sur le menu public (les publiées) et des lignes qui n'y paraissent pas (les brouillons), sans frontière visible. Kirexo impose donc un ordre canonique par statut : les pages publiées d'abord, les brouillons ensuite, chaque groupe restant trié par headerOrder. Le tri est porté par la requête findBySite (src/Plugin/Web/src/Repository/SpecialPageRepository.php), qui classe d'abord sur le statut (publié avant brouillon) puis sur headerOrder — un brouillon ne peut donc jamais s'afficher au-dessus d'une publiée, quelle que soit la valeur brute de son headerOrder. Un séparateur visuel matérialise cette frontière dans la liste (« Brouillons — non affichés dans le menu du site »).
Cet invariant est défendu jusqu'au serveur, pas seulement à l'affichage. Le glisser-déposer est confiné à un groupe : le contrôleur de réordonnancement (src/Plugin/Web/src/Controller/WebPluginSpecialPageReorderController.php) rejette (400) tout ordre reçu où un brouillon précéderait une publiée, et le client restaure alors sa liste. On ne fait jamais confiance à l'ordre envoyé par le navigateur.
Comme le glisser-déposer ne franchit pas la frontière, c'est le changement de statut qui fait traverser le séparateur, en repositionnant la page du bon côté. Publier place la page en fin du groupe publié, juste au-dessus du séparateur (WebPluginSpecialPagePublishController) ; dépublier la place en tête du groupe brouillon, juste dessous (WebPluginSpecialPageUnpublishController). L'utilisateur retrouve ainsi sa page à un endroit prévisible, sans avoir à la rechercher dans la liste. Le versant utilisateur de ces gestes est décrit dans Réordonner les pages du menu de son site.
L'ordre est implicite, réglé par glisser-déposer¶
Le champ headerOrder existe en base, mais il n'est pas exposé à l'utilisateur comme un numéro à saisir. Côté interface, l'ordre est implicite : la liste des pages spéciales s'affiche déjà triée par headerOrder, et l'utilisateur la réordonne par glisser-déposer — la page tout en haut devient la première du menu, celle tout en bas la dernière. Au dépôt, headerOrder est simplement réécrit séquentiellement (0, 1, 2…) selon la nouvelle position des lignes.
Ce choix évite de demander à l'utilisateur de raisonner sur des numéros absolus (« faut-il mettre 5 ou 50 pour laisser de la place ? ») : la position visuelle est l'ordre, sans intermédiaire. À la création, une page prend la place suivante libre — elle arrive donc en fin de liste, à charge pour l'utilisateur de la remonter s'il le souhaite.
Le glisser-déposer est une amélioration progressive, portée par un contrôleur Stimulus s'appuyant sur le Drag & Drop natif HTML5, sans dépendance ajoutée. Sans JavaScript, la liste reste triée et lisible et toutes les autres actions restent disponibles ; seule la réorganisation par glisser-déposer ne l'est pas. Le versant utilisateur est décrit dans Réordonner les pages du menu de son site.
Toute mutation d'une page rafraîchit le rendu public¶
Le menu affiché sur le site public dépend directement de la liste des pages publiées et de leur ordre. Or, le rendu public est mis en cache par site (voir Rendu public d'un site). Pour que le menu public ne reste jamais périmé, chaque mutation d'une page spéciale — créer, modifier, publier, dépublier, supprimer, réordonner — invalide le cache du site juste après l'écriture. Le visiteur voit donc toujours l'état à jour, sans attendre la prochaine publication d'article.
« Admin ≠ publication » : la page naît en brouillon¶
Kirexo pose un invariant fort : l'administration ne rédige ni ne publie de contenu ; chaque utilisateur est seul maître de ce qu'il publie. Les pages spéciales respectent cet invariant par construction.
Une SpecialPage naît toujours en Draft — son constructeur ne prend même pas de statut en argument. Aucun mécanisme automatique, aucune action d'administration ne peut publier une page à la place de l'utilisateur : la publication est un geste explicite que seul le propriétaire du site accomplit. C'est le même parti pris que pour la publication d'un article, décrit dans Contenu de travail, révisions et corbeille.
Aucune page n'est créée à la place de l'utilisateur¶
Une page spéciale n'apparaît jamais toute seule. Ni l'activation du plugin web, ni la naissance du site n'en fabriquent une : la seule voie de création est le geste explicite de l'utilisateur dans les réglages du site de son carnet (src/Plugin/Web/src/Controller/WebPluginSpecialPageCreateController.php).
La chaîne des préalables mérite d'être suivie dans l'ordre, parce que ses deux maillons se confondent facilement. Le Site lui-même ne naît pas de l'activation du plugin : activer le plugin web ouvre la surface de réglages, mais le site naît du rattachement d'un premier domaine à un carnet (src/Plugin/Web/src/Controller/WebPluginSiteDomainAddController.php). L'événement PluginActivatedForUser (src/Plugin/Event/PluginActivatedForUser.php) reste émis par le cœur et reste écoutable, mais le bundle web ne s'en sert plus pour créer quoi que ce soit. Tant qu'aucun domaine n'est rattaché, la création d'une page spéciale est donc refusée, avec le message qui nomme le préalable manquant — « Rattachez d'abord un domaine à ce carnet pour créer son site ». Le lien 1–1 entre un carnet et son site est porté par l'unicité de notebookId sur Site, pas par une garde applicative de non-duplication.
Le prix de cette rigueur est un site initialement sans page d'accompagnement — pas de « À propos » de courtoisie à relire et à corriger. C'est un arbitrage assumé : une page pré-remplie que personne n'a demandée est un contenu dont l'utilisateur hérite sans l'avoir écrit, et qu'il faut penser à supprimer s'il n'en veut pas. Le thème, lui, prévoit la place : son aperçu de rendu est calculé sur un contexte d'exemple qui contient une entrée « À propos » (src/Plugin/Web/src/Controller/WebPluginThemeUpdateController.php), pour que le menu se voie même sur un site qui n'a encore aucune page.
Voir aussi¶
- Contenu de travail, révisions et corbeille — le cycle de vie d'un article, dont les pages spéciales empruntent les gestes de rédaction sans en partager le modèle.
- Carnets : modèle de données — un autre exemple du même invariant d'identifiants UUIDv7 générés au constructeur.
- Architecture — le socle à plugins qui justifie l'isolation d'un bundle de diffusion comme le plugin web.