Fiches personnalisées

Une page dessinée une fois, autant de pages que de fiches.

Réalisations, articles, recettes, membres de l'équipe, biens à louer : vous déclarez les champs, vous dessinez la page dans l'éditeur, et chaque fiche remplie devient une page complète, avec son adresse et son référencement.

1. Le modèle : quels champs

Un modèle de fiche déclare la forme commune : un titre et une image principale pour toutes, puis les champs que vous choisissez. Cinq types de champ suffisent à presque tout.

text texte court → une durée, une ville, un prix affiché
rich_text texte riche → une description mise en forme
image image → une photo de la médiathèque
video vidéo (adresse) → YouTube, Vimeo
button bouton ou lien → vers une page, une adresse, un questionnaire

Exemple : un modèle « Réalisation »

POST /api/agent/v1/modeles/creer/
{ "nom": "Réalisation", "slug": "realisation",
"champs": [
{ "code": "lieu", "libelle": "Lieu", "type": "text" },
{ "code": "annee", "libelle": "Année", "type": "text" },
{ "code": "description", "libelle": "Description", "type": "rich_text" },
{ "code": "photo", "libelle": "Photo", "type": "image" }
] }

2. Le gabarit : à quoi ça ressemble

Le gabarit est une page ordinaire, construite dans l'éditeur avec les mêmes sections, lignes et blocs que le reste du site. Là où doit apparaître la valeur d'un champ, on écrit son code entre crochets : [%lieu%], [%description%]. Au rendu, chaque fiche y verse ses valeurs.

<h1>[%title%]</h1>
<p class="lieu">[%lieu%] — [%annee%]</p>
[%description%]

Modifier le gabarit modifie toutes les fiches d'un coup : une nouvelle mise en page s'applique à cent réalisations sans en rouvrir une seule.
Un champ laissé vide disparaît proprement : son emplacement rend une chaîne vide.
Le gabarit n'a pas d'adresse à lui : ouvert directement, il répond 404. Ce sont les fiches qui sont publiques.

3. La fiche : le contenu

Une fiche remplit les champs du modèle. Elle a son adresse, sous /co/<modèle>/<slug>/, et ses propres métadonnées de recherche : chaque réalisation sort dans Google avec son titre et sa description, pas avec ceux du gabarit.

POST /api/agent/v1/objets/creer/
{ "modele": "realisation",
"titre": "Cuisine en chêne massif",
"valeurs": { "lieu": "Rennes", "annee": "2026",
"description": "<p>…</p>", "photo": 12 } }

PATCH /api/agent/v1/objets/42/
{ "metadonnees": { "titre": "…", "description": "…" },
"publie": true }

Une fiche naît en brouillon ; la publier est un geste à part.
Corriger un champ ne touche pas aux autres : ce qu'on ne mentionne pas ne bouge pas.
Une version par langue, si le site est multilingue : un bouton sur l'écran de la fiche crée sa version anglaise.

Les afficher, les vendre

Une grille ou un carrousel posé sur n'importe quelle page affiche les fiches publiées d'un modèle. Publier une nouvelle fiche la fait apparaître, sans retoucher la page.
Un produit se greffe sur une fiche : prix, TVA, stock, référence. La fiche reste le contenu, le produit porte la vente. Le type de produit dit ce que l'achat entraîne — un colis à expédier, une formation à ouvrir, un questionnaire à donner.
Référencement compris : les fiches publiées entrent dans le plan du site et dans llms.txt.

L'ordre à respecter

type de produit → modèle de fiche → page gabarit → fiche → produit
↳ métadonnées

La boutique L'éditeur de pages