Rendu public d'un site (plugin web) : contenu, SEO et cache¶
Cette page explique pourquoi le contenu servi par un site Kirexo est une structure épurée et sûre, pourquoi le permalien d'un article s'appuie sur son identifiant plutôt que sur un slug stocké, et pourquoi l'invalidation du cache se fait par un tag de site et non page par page. Pour savoir comment un domaine est résolu vers le site à servir, voir Multi-tenant : résolution d'un domaine vers un site ; pour la nature des pages spéciales affichées sur le site, voir Pages spéciales du plugin web ; pour le socle à plugins et le worker mode qui contraignent ces choix, voir Architecture.
Deux régimes dans une même page : le contenu et le thème¶
Une page publique se compose en deux temps, et il vaut la peine de bien les distinguer.
Le contenu — le flux d'articles, un article, une page spéciale — est rendu par les gabarits du plugin. C'est le seul HTML que le plugin maîtrise de bout en bout : il est piloté par des données structurées, et le texte rédactionnel qu'il affiche est du markdown déjà assaini par le rendu du cœur (App\Service\Article\MarkdownRenderer), le même pour un article que pour une page spéciale. Ce rendu n'a aucune surface d'injection : il n'existe pas de canal par lequel un contenu non assaini l'atteindrait. Sa sécurité ne repose pas sur un filtrage ajouté après coup, mais sur le fait qu'il n'y a rien de brut à filtrer.
Le thème fournit tout le reste : l'en-tête, le corps qui accueille le contenu, le pied de page et la feuille de style. Ses sources relèvent d'un autre régime — sandbox Twig, sanitizer, filtre CSS, CSP stricte — traité dans Sécurité du rendu personnalisé des sites. Le thème est assaini avant que le contenu ne soit injecté à l'emplacement qu'il prévoit : ce n'est jamais du HTML brut qui atteint la page, et le contenu, lui, n'est jamais re-filtré.
C'est cette frontière qui rend l'ensemble lisible : le thème décide de l'habillage, jamais de ce qui est publié ; le contenu décide de ce qui est publié, jamais de l'habillage. Le pourquoi de ce découpage est développé dans Modèle de thème et catalogue fourni.
Trois surfaces publiques, et rien d'autre¶
Un site public n'expose que trois natures de page, toutes anonymes (le rendu public ne demande jamais d'authentification — c'est le prolongement de l'invariant « admin ≠ publication » décrit dans Multi-tenant : résolution d'un domaine vers un site).
- La home paginée liste les derniers articles publiés destinés au canal web du carnet de ce site, du plus récent au plus ancien, par pages de dix. Elle ne montre que des articles qui sont à la fois publiés, dont la destination inclut le web, et qui appartiennent au carnet du site : un article publié uniquement vers d'autres canaux — ou publié dans un autre carnet du même auteur — n'apparaît pas sur ce site.
- Les pages spéciales publiées, adressées par leur slug (
/{slug}). Seules les pages en statut publié sont servies ; un brouillon ou un slug réservé renvoie un 404. Leur nature est détaillée dans Pages spéciales du plugin web. - L'article publié, adressé par son permalien (
/{slug}/{id}), à condition d'appartenir au carnet du site, d'être publié, et d'être destiné au web.
Ces trois formes de chemin sont disjointes — zéro segment pour la home, un segment pour une page spéciale, deux segments pour un article — ce qui évite toute ambiguïté de routage entre elles, sans arbitrage ni ordre de priorité à maintenir.
Le contenu du site est scopé au carnet, pas à l'auteur¶
Un site appartient à un carnet, pas à un compte (voir Configuration par carnet et extensibilité des plugins). Le rendu public le reflète strictement : les articles servis sont ceux du carnet du site, jamais l'ensemble des articles de l'auteur.
Un même utilisateur peut tenir plusieurs carnets, chacun avec son propre site sur son propre domaine. Le web étant un canal de diffusion parmi d'autres, un article n'apparaît sur un site que s'il remplit trois conditions cumulatives : appartenir au carnet de ce site, être publié, et avoir le web dans ses destinations. Un article du carnet A n'est donc jamais rendu sur le site du carnet B, même s'ils partagent le même auteur.
Le filtrage porte l'{id} du carnet dans une seule requête : côté home comme côté article, la couche d'accès aux données (Kirexo\Plugin\Web\Repository\PublishedWebArticleFinder, src/Plugin/Web/src/Repository/PublishedWebArticleFinder.php) sélectionne les articles par notebook_id, statut publié et présence du web dans les destinations. L'{id} de l'article reçu dans le permalien ne suffit pas à le servir : encore faut-il qu'il appartienne au carnet du site résolu. C'est ce qui rend l'isolation inter-carnets structurelle, et pas seulement une question d'affichage.
Le permalien d'article : l'identifiant fait autorité, le slug est cosmétique¶
Le permalien d'un article est /{slug}/{id}. La partie qui identifie réellement l'article est {id}, son UUIDv7 ; {slug} n'est qu'un habillage lisible dérivé du titre.
Pourquoi le slug n'est pas stocké sur l'article¶
Un article est une entité du cœur de Kirexo, partagée par tous les canaux de diffusion. Le web, lui, n'est qu'un plugin parmi d'autres. Ajouter une colonne slug — une notion purement web, utile à une seule URL — sur l'entité article coupleraient le schéma du cœur à un plugin particulier. Ce serait exactement le couplage que l'architecture à bundles isolés cherche à éviter : supprimer un plugin ne doit rien casser dans le cœur. Le slug est donc calculé à la volée à partir du titre, jamais persisté. Rien n'est ajouté à l'article pour le confort d'un seul canal.
Pourquoi l'identifiant fait autorité¶
Faire porter l'identité par l'UUID plutôt que par le slug résout plusieurs problèmes d'un coup.
- Lookup déterministe. Retrouver un article par son identifiant est direct et sans ambiguïté ; il n'y a pas à gérer les collisions de slugs, ni à garantir l'unicité d'un texte dérivé d'un titre potentiellement dupliqué.
- Pas de rupture de lien quand le titre change. Un slug stocké se périmerait dès que l'auteur renomme son article. Ici, l'ancien lien continue de fonctionner : c'est l'
{id}qui compte, et le{slug}reçu est ignoré pour la résolution. - Protection contre le duplicate content. Comme n'importe quel slug placé devant le bon
{id}mènerait au même article, on risquerait de multiplier les URL équivalentes aux yeux des moteurs de recherche. Le rendu recalcule le slug attendu à partir du titre courant et, si le slug de l'URL diffère, redirige vers l'URL canonique. Une seule adresse fait foi ; les variantes convergent vers elle au lieu de se concurrencer.
Le slug ne sert donc que la lisibilité et le référencement ; il ne porte aucune responsabilité d'identification, et sa dérive éventuelle est corrigée par redirection plutôt que subie.
Le SEO est produit côté serveur, pas figé dans le gabarit¶
Chaque page publique — home, page spéciale, article — produit ses propres métadonnées de référencement : title, meta description, URL canonique et balises Open Graph. Ces valeurs sont calculées côté serveur en fonction du contenu réel de la page (le titre du site, celui de l'article, son extrait, son URL canonique), puis passées au gabarit sous forme de données.
Le point important est qu'elles ne sont pas écrites en dur dans le gabarit. Le gabarit ne fait que placer des valeurs qu'on lui fournit ; il ne « devine » ni ne fabrique le titre ou la description. Cette séparation garde une seule source de vérité pour le SEO (le rendu), rend chaque page cohérente avec son contenu, et évite que la logique de référencement se disperse dans plusieurs gabarits où elle finirait par diverger.
L'invalidation du cache se fait par tag de site¶
Le rendu de chaque page publique est mis en cache. Le sujet délicat n'est pas de remplir ce cache, mais de savoir quand et comment le vider.
Le problème : « qui a changé ? » est une mauvaise question¶
Quand un auteur publie un article, plusieurs pages du site deviennent périmées d'un coup : la home (l'article doit y apparaître, et la pagination se décale), la page de l'article lui-même, et potentiellement d'autres. Chercher à invalider précisément les pages touchées obligerait le code qui réagit à la publication à raisonner sur la structure du site — quelle page de pagination, quel slug, quel identifiant — c'est-à-dire à connaître des détails de rendu qui ne le regardent pas. Ce couplage serait fragile : la moindre évolution de la pagination ou du plan du site rendrait l'invalidation incomplète, et donc le cache incohérent.
La solution : un tag agnostique de page, de slug et d'identifiant¶
Chaque entrée de cache d'un site est étiquetée avec un même tag, propre au site — dérivé de son identifiant, indépendant de la page, du slug ou de l'article. Home, pages spéciales et articles d'un même site partagent ce tag unique.
Dès lors, réagir à une publication se réduit à un seul geste : invalider le tag du site. Toutes les entrées cachées du site — home, toutes ses pages, tous ses articles — tombent ensemble, sans que le code qui déclenche l'invalidation ait à savoir quelle page a réellement changé. Le tag est posé au bon niveau : celui du site, précisément parce qu'une publication rend potentiellement obsolète n'importe quelle page de ce site. On échange une invalidation chirurgicale mais fragile contre une invalidation grossière mais sûre et sans couplage — un compromis assumé, d'autant que régénérer les pages d'un site est bon marché comparé au coût d'un cache silencieusement incohérent.
Cette invalidation est déclenchée en réaction à la publication d'un article, via le canal de messages dédié au plugin web : le cœur signale « un article a été publié », le plugin en déduit le site concerné par le carnet de l'article (findByNotebookId, src/Plugin/Web/src/MessageHandler/WebArticlePublishedHandler.php) et invalide son tag. Comme le rendu, l'invalidation suit donc le carnet : publier dans le carnet A ne purge que le cache du site du carnet A.
La publication d'un article n'est cependant pas le seul événement qui rend une page périmée : le menu du site liste les pages spéciales publiées, dans leur ordre. Toute mutation d'une page spéciale — la créer, la modifier, la publier, la dépublier, la supprimer ou la réordonner — invalide donc elle aussi le tag du site, juste après l'écriture. Sans cela, le menu public pourrait afficher un ordre ou une liste de pages périmés jusqu'à la prochaine publication d'article. Le même geste d'invalidation par tag sert tous ces déclencheurs : peu importe ce qui a changé, on invalide le site entier.
flowchart LR
A["Article publié<br/>(cœur)"] --> B["message « article publié »<br/>(canal du plugin web)"]
B --> C["le plugin retrouve le site<br/>(via le carnet de l'article)"]
C --> D["invalidation du tag du site"]
D --> E["home + pages + articles<br/>du site purgés ensemble"]
Si le carnet de l'article publié n'a pas de site (aucun domaine rattaché), il n'y a simplement rien à invalider : l'opération est un no-op, sans effet de bord.
Portée de cette page¶
Cette page décrit le contenu servi par un site et son cache. La résolution du domaine vers le bon site — comment blog.exemple.fr devient « ce site-ci » — n'est pas reprise ici : elle est traitée dans Multi-tenant : résolution d'un domaine vers un site. L'habillage (le modèle de thème, le catalogue fourni) est traité dans Modèle de thème et catalogue fourni, et les garde-fous de sécurité qui l'accompagnent (sandbox Twig, sanitizer « site public », filtre CSS, CSP stricte) dans Sécurité du rendu personnalisé des sites.
Voir aussi¶
- Multi-tenant : résolution d'un domaine vers un site — comment un domaine est aiguillé vers le site à servir, en amont de ce rendu.
- Configuration par carnet et extensibilité des plugins — pourquoi un site appartient à un carnet, ce qui fonde l'isolation inter-carnets du contenu servi.
- Pages spéciales du plugin web — la nature des pages spéciales que ce rendu sert par slug.
- Modèle de thème et catalogue fourni — l'habillage qui enveloppe le contenu décrit ici.
- Architecture — le socle à plugins isolés et le worker mode FrankenPHP qui justifient un slug non persisté et un rendu autonome.
- Sécurité du rendu personnalisé des sites — la défense en profondeur (sandbox Twig, sanitizer, filtre CSS) qui sécurise les sources d'un thème.