#Journal des changements
Ce que la plateforme a gagné, perdu ou corrigé, à la date où c’est arrivé. Les entrées sont tirées de l’historique du dépôt, pas d’une feuille de route : chacune correspond à du code qui tourne.
#Ce que ce journal couvre
Trois choses, et rien d’autre :
- le format des thèmes — ce qu’un thème peut lire, écrire et rendre ;
- le CLI — ses commandes, ses options, ses confirmations ;
- l’API HTTP — ses routes, ses portées, ses codes d’erreur.
Ce qui bouge dans le CMS lui-même — l’interface, la facturation, l’assistant — n’y figure que si un développeur peut s’en apercevoir depuis son éditeur.
Webcosa est un service : il n’existe qu’une version en ligne, celle d’aujourd’hui. Un thème n’épingle donc pas une version du format, et il n’y a rien à mettre à jour. En contrepartie, ce journal est le seul endroit qui dise ce qui a changé sous les pieds d’un thème déjà écrit — les entrées marquées rupture sont celles qui demandent une action.
#18 novembre 2026
Aucune rupture. Le moteur rend la même page, à l’octet, plus vite. Le moteur d’un site publié garde ses gabarits analysés (coquille, sections, snippets) tant que le thème ne change pas : un snippet rendu dans une boucle n’est plus réanalysé à chaque tour, et la borne de 512 Ko s’applique à chaque source analysée. Le rendu est synchrone de bout en bout ; les 3 secondes restent appliquées par LiquidJS, de l’intérieur, et la course contre un minuteur, qui ne pouvait rien couper, est retirée. Le compteur d’imbrication des sections est porté par chaque rendu. Le détail est sur la page du bac à sable.
#17 novembre 2026
Aucune rupture. La fiche Google reliée (contact.reseaux.googleBusiness,
désormais réglable aussi depuis Agentique › Fiche Google) devient la carte
de l'entreprise : hasMap porte le lien de la fiche au lieu du lien vers ses
coordonnées, pour une entreprise située — le nœud reste identique sans fiche
reliée. Un lien d'avis collé (g.page/r/<id>/review) est ramené à la fiche
(g.page/r/<id>) : sameAs ne porte jamais le formulaire d'avis. Trois routes
d'API rejoignent l'atelier : /api/fiche-google,
/api/fiche-google/photos (le pack photo en ZIP) et /api/bing/webmaster.
Rien ne change pour un thème.
Chaque page d'un site porte aussi <meta name="generator" content="Webcosa">,
posé par la plateforme avec le reste de la tête (voir
la coquille) : votre coquille n'a pas à l'écrire.
Dans article.contenu, un lien vers un autre site n'est plus qualifié
nofollow d'office : il sort en rel="noopener", dans un nouvel onglet, comme
chez les autres CMS, puisque c'est le propriétaire du site qui l'écrit. Un lien
payé ou d'affiliation se qualifie lui-même : attrs.rel de la marque link
accepte sponsored, nofollow et ugc, et rien d'autre. Le badge « Fait avec
Webcosa » et le contenu des visiteurs restent qualifiés.
Le mode maquette (CLI et API de l'atelier) :
webcosa site creer --maquette --prospect="…" [--expire] [--whatsapp] [--devis],
webcosa site maquette (état, modification, --prolonger, --retirer) et
webcosa site acces --code=…|auto — le code d'accès se pose désormais sans
ouvrir le CMS. Route GET|PUT|DELETE /api/sites/maquette. Sur une maquette, la
plateforme pose après le thème un filigrane, des freins à la copie et une barre
wc-mq-* (position: fixed, aucun effet sur animation-timeline ni sur
@view-transition), et retire la capsule « Fait avec Webcosa ». Rien ne change
pour un thème qui n'est pas une maquette.
#16 novembre 2026
Aucune rupture. Chaque page indexable d'un site a sa version
Markdown, à son adresse suivie de .md (/index.md pour l'accueil),
annoncée dans la tête par <link rel="alternate" type="text/markdown"> et
dans llms.txt. Elle traduit le <main> de votre coquille : un thème qui
enveloppe son contenu dans un <main>, et y laisse ses menus hors de lui ou
sous aria-hidden, donne aux assistants une page propre. La tête de
l'accueil porte aussi msvalidate.01 quand le client a validé son site
dans Bing Webmaster Tools.
Aucune rupture. Les photos de la médiathèque notées par leur empreinte
sont servies par le site lui-même : srcset sur /_m/<empreinte>/<largeur>
(160 à 2 048 px, jamais au-delà de l'original), en AVIF ou en WebP selon le
navigateur, sous la même porte de qualité que le dépôt. Votre balise <img>
garde sa forme — aucune <picture> ne l'enveloppe — et un srcset que vous
écrivez vous-même reste respecté. Le préchargement de l'image principale suit
le fetchpriority="high" que vous posez ; un SVG ou une image de 96 px au plus
n'est jamais préchargé. Côté API, POST /api/fichiers/televerser refuse une
vidéo (415 video_refusee) et rend le fichier déjà présent quand le même
contenu est déposé deux fois.
#3 novembre 2026
Aucune rupture. Un site peut parler plusieurs langues : la langue par
défaut à la racine, chaque langue ajoutée sous son sous-répertoire (/en,
/en/<page>, /en/blog). Trois objets Liquid : langue, site.langues et
page.traductions (un sélecteur qui mène à la page équivalente) ; articles et
blog suivent la langue de la page. La plateforme pose <html lang>, la
canonique de chaque langue, les hreflang réciproques et x-default,
og:locale:alternate et inLanguage, et le plan porte les xhtml:link. Côté
CLI : site langues lister|ajouter, page ecrire --langue --traduction-de,
blog creer --langue --traduction-de, traduction_de dans le frontmatter
d'article ecrire ; côté API : GET|POST /api/sites/langues, langue et
traduction_de sur POST /api/pages, PATCH /api/pages/<id>,
POST /api/blogs et PUT /api/posts. Un site d'une langue ne change pas.
#1er novembre 2026
Aucune rupture. L'auteur d'un article peut être une personne :
seo.auteur: { nom, url } dans la fiche de l'entreprise
(PATCH /api/parametres/seo, ou webcosa entreprise completer --seo=…). Le
BlogPosting la porte en author (@type: Person), l'entreprise en
publisher ; sans elle, l'entreprise signe comme avant.
Aucune rupture. POST /api/assistant-site, l'assistant d'un site, appelé
depuis le site lui-même (même origine). Corps { question, passages: [{ titre, url, texte }] } — question de 300 signes au plus, 1 à 6 passages de 1 200
signes, url un chemin du site ; réponse { reponse, liens: [{ titre, url }] },
les liens pris parmi les passages et /contact. Le site envoie les passages
que sa recherche a trouvés ; la réponse n'est tirée que d'eux. Ouvert site par
site ; 403 origine_refusee, 403 assistant_non_ouvert, 400 invalid_input,
429 trop_de_demandes, 503 assistant_indisponible (le site garde alors sa
recherche).
Aucune rupture. Les redirections d’un site vont à leur cible en un
saut, quelle que soit la forme de l’ancienne adresse : écrite avec sa barre
finale (/blog/ancien-article/), elle n’est plus d’abord ramenée à
/blog/ancien-article ; imbriquée (/realisations/projet), elle n’est plus
servie par la page de son premier segment. Une adresse sans redirection
répond comme avant.
Aucune rupture. Le blog et les redirections s’écrivent avec une clé
d’API : lister et lire en portée lecture, écrire en portée atelier.
PUT /api/posts crée ou met à jour un article par son adresse, le corps en
Markdown ou en HTML converti dans le format de l’éditeur, sa date de
publication d’origine gardée ; GET /api/blogs, GET /api/posts/<id> et
GET /api/redirections sont nouvelles, les autres routes du blog et des
redirections acceptent désormais une clé. Au CLI : blog lister|creer,
article lister|lire|ecrire|publier, redirection lister|ecrire|supprimer.
Voir Atelier et
le CLI de l’atelier.
Aucune rupture. asset_url ajoute à l’adresse l’empreinte du contenu
du fichier : {{ 'motif.svg' | asset_url }} rend
/theme-assets/<id>/motif.svg?v=3f9a1c0b7e42, et les url() d’une feuille
posée dans la page reçoivent la leur. Quand l’empreinte correspond au fichier
d’un site en ligne, la route le sert un an, immuable, depuis le CDN ; modifier
le fichier change l’adresse. L’adresse sans ?v=, écrite à la main, répond
comme avant (private, max-age=60). Voir Assets.
#11 octobre 2026
Aucune rupture. Les sections que Cosa écrit dans votre thème (genere-*)
passent un contrôle de plus : leur mouvement ne cache rien au repos et ne
déplace rien, chaque chiffre et chaque texte est du texte dans le HTML (un
compteur CSS n’est qu’un décor muet par-dessus le vrai chiffre), un seul
<h1> par page, des titres sans niveau sauté, de vrais <a href>. Ce qui doit
se voir à l’entrée dans l’écran s’y déclenche (animation-timeline: view())
et se joue dans le temps (@container style()). Voir
Les sections.
Aucune rupture. Les images déposées — par l’écran Fichiers, un sélecteur
d’image, webcosa media televerser ou POST /api/fichiers/televerser — sont
compressées par le serveur avant d’être écrites, et gardées seulement si la
mesure (SSIM) les dit visuellement identiques à l’original ; sinon l’original
reste. Les coordonnées GPS et les autres métadonnées partent toujours. La
réponse de l’API porte un champ compression, et le chemin rendu peut changer
d’extension. Voir l’API de l’atelier.
Aucune rupture. image_picker, le nom Shopify d’image, est désormais lu
comme lui : un thème importé garde son champ d’image dans le panneau, au lieu
d’un réglage écarté et d’un « type inconnu » au journal. Le nom à écrire reste
image — l’éditeur de code le conseille d’un clic, et le vérificateur du
dépôt l’exige. Voir image.
Aucune rupture. Le rendu de la plateforme ajoute à votre page, après votre
thème : aria-current="page" dans vos <nav>, le titre de la page en <h1>
quand votre page n’en a aucun (ou n’a que « Le titre de la page »),
autocomplete, type="email"/"tel" et un champ piège sur les formulaires
qui envoient à /api/contacts, et une mention courte sous les sections d’avis
(qui les publie, où en signaler un). L’image du haut de page n’est plus
différée, et toute photo de la médiathèque passe par la retaille. Voir
ce que la plateforme fait de votre page. Côté référencement,
la carte de partage est recadrée en 1 200 × 630 et le plan du site n’a plus
ni changefreq ni priority — voir la coquille.
Toujours sans rupture, font_face déclare aussi une face de repli aux
mesures de la police — "Inter Var Repli", une police locale (Arial, Times
New Roman ou Courier New) redressée par size-adjust et ascent-override,
descent-override, line-gap-override — et font_famille la place juste
après la famille. Le texte affiché avant l’arrivée du fichier occupe déjà sa
place : la page ne saute plus à la bascule. Rien à changer dans un thème qui
emploie les deux filtres. Voir font_famille.
#10 octobre 2026
Aucune rupture. Une publication est désormais relue, puis annoncée aux moteurs — voir Publier. Et les adresses d’un site n’ont plus qu’une forme.
#Relue par l’adresse du site, annoncée à IndexNow
Après chaque écriture qui change ce que voit un visiteur, la plateforme relit
l’adresse touchée comme un robot sans JavaScript (200, canonique, pas de
noindex accidentel, tête dans le <head>) et, pour une page ou un article
publié, retiré ou renommé sur un site ouvert aux moteurs, l’annonce à IndexNow
(Bing, et par lui la recherche de ChatGPT et Copilot). Chaque site sert son
fichier de clé à /<clé>.txt. Rien ne change pour votre thème.
#Des refus structurels
POST /api/pages et le renommage par PATCH /api/pages/<id> refusent en
409 adresse_reservee une page à une adresse que la plateforme sert avant
elle : blog, legal, password, api, theme-assets, h, d, p, s,
o, index, page, et les cibles des robots malveillants (wp-*, *.php).
Une telle page n’était jamais vue. devis, galerie, rendez-vous, avis,
newsletter restent libres. Une redirection qui fermerait une boucle est
refusée — /A et /a/ sont la même adresse ; une redirection vers une adresse
déjà redirigée pointe directement au bout de la chaîne.
#Les adresses, la 404, indexable
- Une 404 dans votre coquille. Une adresse inconnue d’un site répond 404 posée
dans votre thème — en-tête, menu, pied,
page.templatevaut"404"—, avec un document neutre aux couleurs du thème, comme les pages légales. Têtenoindex. indexable.PATCH /api/pages/<id>accepte{ "indexable": false }: la page reste servie, ennoindex, follow, hors du plan du site et dellms.txt.- Une forme par adresse. Une adresse en majuscules, à barre finale, en
.htmlou enindex.htmlredirige en une seule 308 vers sa forme propre (site par site, en cours de déploiement) ; une page se lit à son chemin entier (/tarifs/xn’est plus la pagetarifs). Un lien de votre thème vers/page/quelque-chosequi servaitpagecessera de le faire : écrivez l’adresse exacte.
#8 octobre 2026
Aucune rupture, et deux changements visibles. Le blog de tous les sites
(/blog, /blog/<blog>, /blog/<blog>/<article>) passe dans le thème — votre
coquille, votre en-tête, votre menu, votre pied —, comme les pages légales la veille.
Et la tête SEO devient tout entière l’affaire de la plateforme : ce que votre
coquille écrit dans son head à ce sujet est retiré en ligne.
#Le blog dans votre coquille
Sans templates/blog.json ni templates/article.json — le cas des neuf thèmes
livrés —, la plateforme pose son propre document dans content_for_layout :
un seul <h1>, un <article> daté et signé de l’entreprise, des cartes pour
les listes, à la police de titres et à l’accent de votre thème (ses variables
--f-titre ou --titre-police, --accent ou --g-accent), sous des règles
toutes préfixées wc-blog. Les gabarits du thème, quand il en déclare,
gardent la main. Voir Les templates.
#La tête SEO appartient à la plateforme
Sur le site en ligne, la plateforme retire de la tête de la coquille le
<title>, la description, les balises robots, la canonique, l’Open Graph, les
cartes Twitter et tout application/ld+json — ceux qu’elle pose d’après le CMS
font foi. L’aperçu, lui, sert votre coquille telle quelle. L’éditeur de code
souligne ces balises (tete-seo) ; le <title> de la coquille n’y est qu’un
conseil. Voir La coquille.
#Quatre objets pour lire la tête publiée
site.url (l’origine publique, absolue), canonical_url, page.titre_seo et
page.description_seo : la tête que la page publie, en lecture, pour un lien
de partage ou une adresse en pied de page. site.adresse reste le préfixe des
liens. canonical_url quitte la liste des absents. Voir
Objets.
#Des images qui ne font plus sauter la page
Les photos de la médiathèque reçoivent width et height, mesurés au dépôt,
et les visuels de démonstration aussi — avec une règle height: auto de
spécificité nulle, que toute règle de votre feuille qui fixe une hauteur emporte.
Le navigateur réserve leur place avant qu’elles arrivent.
#Une seule adresse par site : son origine
Une seule adresse par site : son origine, le domaine
principal servi (vérifié, certificat en place), sinon <slug>.webcosa.site.
La canonique, og:url, le graphe JSON-LD, sitemap.xml, le Sitemap: de
robots.txt et llms.txt la citent toutes ; les autres noms du site — www,
sous-domaine, ancienne adresse Webcosa, cms.webcosa.com/s/<slug> — y
redirigent en une 308, recherche conservée. robots.txt répond sur chaque
nom. Le changement s’allume site par site (quelques sites témoins d’abord) :
un webcosa site verifier peut donc compter un saut de moins d’un jour à
l’autre. Voir La coquille
et Le groupe site.
#Le texte d’exemple de votre thème ne part plus chez Google
La description de repli d’une page, son image et la FAQ du graphe JSON-LD ne
lisent plus que ce que le client a saisi : ni les défauts de votre schéma,
ni un gabarit resté tel que l’installation l’a posé. Un site neuf n’annonce
plus « Un travail soigné… » comme description, ni une FAQ d’exemple ; il
publie le résumé ou l’accroche de son propriétaire, ou rien. Les mêmes faits
servent la balise, le graphe, le plan et llms.txt — l’article, par exemple,
a désormais le même résumé et la même date de modification dans les deux.
#theme-color, langue, plan
La plateforme pose theme-color (le fond de page de votre thème : papier,
fond ou canevas) ; celle de votre coquille était sans effet. og:locale,
inLanguage et le pays de l’adresse suivent la langue et le pays du site
(français et France par défaut). robots.txt ne cite plus que Sitemap:. Le
plan liste l’accueil même quand c’est votre templates/index.json qui le sert
seul, et date chaque page de la dernière modification de son gabarit. Voir
La coquille.
#7 octobre 2026
Aucune rupture, mais un changement visible : les pages légales de tous les
sites (/legal/mentions-legales, /legal/confidentialite) passent désormais
dans le thème — votre coquille, votre en-tête, votre menu, votre pied —, au lieu
d’une page blanche de la plateforme. Rien à faire : elles reçoivent un document
neutre qui hérite de vos couleurs, de votre police de titres et de votre accent, sous
des règles toutes préfixées wc-politique.
#Les politiques, et templates/politique.json
Un site publie maintenant jusqu’à six politiques, écrites par le client dans
Paramètres › Politiques : mentions légales, confidentialité, conditions
générales de vente (/legal/cgv), retour et remboursement (/legal/retours),
conditions d’utilisation (/legal/conditions-utilisation), cookies
(/legal/cookies). Un thème qui veut les dessiner lui-même déclare
templates/politique.json et lit l’objet politique
— cle, titre, contenu, mis_a_jour, adresse. Pas de repli sur
page.json. Voir Les templates.
#Une route de plus dans l’atelier
PUT /api/parametres/politiques/<cle> écrit une politique (un document
Tiptap), DELETE la rend au modèle. Voir L’atelier.
#Les pages publiques gardées plus longtemps
Les pages d’un site — sur son sous-domaine et désormais sur son domaine
personnalisé — sont servies par le réseau de diffusion et gardées plusieurs
heures au lieu d’une minute. Toute écriture par l’API ou le CLI (page, article,
menu, réglage, fichier de thème, domaine) purge le site aussitôt : rien ne
change pour qui publie. Ce qui change : une page ne se refait plus à presque
chaque visite, et une écriture faite hors de l’API ne se voit qu’à l’échéance.
'now' | date reste juste d’un jour à l’autre : aucune page ne survit à
minuit. Voir Publier.
#Une adresse changée redirige toujours
PATCH /api/pages/<id> avec un nouveau slug pose désormais toujours une
308 de l’ancienne adresse vers la nouvelle : ni la formule, ni le rôle, ni
rediriger n’en décident plus (rediriger est accepté et ignoré). Les
redirections qui menaient à l’ancienne adresse sont raccourcies, sans chaîne
ni boucle. Dans le CMS, un article dont l’adresse change et un blog renommé
font de même. Et PATCH … { "status": "published" } (ou is_home) sur un
site inactif répond 402 site_inactif, comme …/publish : une page ne passe
plus en ligne par la porte d’à côté. Voir L’atelier.
#date à l’heure de Paris
date, date_fr et l’objet annee comptent désormais en Europe/Paris, et
plus à l’heure du serveur (temps universel) : {{ 'now' | date: '%w' }}
désignait la veille entre minuit et 2 h du matin, et l’année changeait une
heure trop tard. date_fr lit aussi 'now', et accepte un format comme
date ({{ 'now' | date_fr: '%Y' }} rendait vide). Voir
Les filtres.
#etablissement enfin rempli
L’objet etablissement — les coordonnées de
Paramètres › Coordonnées — était déclaré mais restait vide sur tous les sites :
le rendu ne le transmettait pas. Il est rempli partout (pages, blog, pages
légales, aperçus). Un thème qui s’en sert comme repli
(section.settings.telephone | default: etablissement.telephone) affiche
désormais le numéro du client quand le champ de la section est vide — il
n’affichait rien.
#5 octobre 2026
Aucune rupture. Un thème qui ne déclare ni templates/blog.json ni
templates/article.json — c’est le cas des huit thèmes d’origine — rend
exactement comme avant, blog compris.
#Des sections écrites par Cosa
L’éditeur de thème sait faire écrire par Cosa une section que le thème n’a
pas. Elle arrive dans le thème comme un fichier sections/genere-<nom>.liquid,
ouvert par un commentaire de provenance, aux styles tous rangés sous
#cosa-{{ section.id }} et sans JavaScript. Rien ne change pour un thème
existant ; si vous en trouvez un dans un thème que vous maintenez, c’est une
section comme une autre. Voir Les sections.
#Le blog, rendu par le thème
Deux gabarits de plus, au modèle de Shopify : templates/article.json rend un
article (/blog/<blog>/<article>), templates/blog.json les listes (/blog
et /blog/<blog>). Avec eux, deux objets : article
— titre, extrait, adresse, image, date, contenu et son blog — et
blog — titre, description, adresse, articles,
blogs. Ils n’existent que sur ces vues.
Jusqu’ici, le blog était toujours servi dans la page de la plateforme : sans
l’en-tête, le menu, le pied ni les polices du thème. C’est encore le cas quand
le gabarit manque, et il n’y a pas de repli sur page.json : c’est le
fichier qui décide. Voir Les templates.
#L’éditeur de code du CMS souligne ce qui casse en silence
« Modifier le code » d’un thème passe à un vrai éditeur : complétion des objets,
des filtres et des tags que le moteur connaît — et des id du {% schema %}
après section.settings., des réglages globaux après settings., des snippets
après {% render ' —, multi-curseur, repli, mise en forme du JSON.
Il vérifie pendant qu’on tape, avec la même analyse qu’à l’enregistrement, et
signale ce que le moteur laisse passer sans un mot : un filtre ou un objet de
Shopify (les absents), un réglage lu mais jamais déclaré, un
snippet ou une section qui n’existe pas, 'assets/theme.css' | asset_url, un
type de réglage inconnu, un <script> en ligne, une police ou une image
d’un autre domaine. Rien ne change pour un thème déjà écrit : ce sont des
avertissements, et l’enregistrement ne refuse toujours que les erreurs de
syntaxe (les fichiers).
L’assistant du CMS s’y ouvre aussi : il explique un fichier, corrige un problème souligné ou modifie une sélection, et propose chaque changement en différence, à accepter morceau par morceau. Il n’écrit et n’enregistre rien lui-même.
#Les photos retaillées gardent leurs proportions
Depuis le 1er octobre, les photos de la médiathèque servies en plusieurs
largeurs (srcset) étaient recadrées en une tranche verticale, puis étirées :
elles paraissaient zoomées sur un détail. Elles sont de nouveau réduites à
leurs proportions d’origine. Rien à changer dans un thème.
#Les liens internes d’un article
Dans article.contenu, un lien vers une autre page du site (une adresse qui
commence par /) est désormais un lien ordinaire. Il sortait en
rel="noopener nofollow" et dans un nouvel onglet, comme un lien externe :
Google ne suivait pas le maillage interne de l’article. Les liens vers
d’autres sites, eux, ne changent pas.
#Les robots d’IA et llms.txt, site par site
Chaque site client sert désormais un /llms.txt : sa fiche (adresse,
téléphone, horaires de Paramètres › Coordonnées), ses pages publiées et ses
articles, aux adresses canoniques. Il répond 404 si le site est protégé par un
code, masqué des moteurs ou sans page publiée.
Son robots.txt ne change pas d’un octet tant que le client laisse la
plateforme décider. Depuis l’écran Agentique du CMS, il peut fermer
ChatGPT, Perplexity, Claude, Gemini ou l’entraînement des modèles : leurs
robots reçoivent alors un groupe Disallow: / à part, et les autres
continuent de lire User-agent: *. Côté API, l’onglet ia de
/api/parametres/<onglet> porte ce réglage — voir Atelier.
Rien à changer dans un thème : ces fichiers sont posés par la plateforme,
comme le plan du site.
Le même jour, le llms.txt s’est enrichi de ce que le client écrit dans
l’écran Agentique : son métier (une ligne Activité), la date de la
dernière mise à jour du contenu (Mis à jour le : AAAA-MM-JJ), et une section
## Questions fréquentes — ses questions-réponses validées, une ### par
question, placée avant les listes de liens. Aucune n’y entre sans sa
validation, et rien de tout cela ne paraît sur ses pages : pour les montrer, il
pose une section de questions fréquentes — qui donne alors aussi à la page ses
données structurées FAQPage, puisqu’elles y sont visibles. Rien à changer
dans un thème.
#siAbsent : écrire un fichier sans jamais en écraser un
PUT /api/themes/<id>/fichiers accepte un champ facultatif siAbsent. Avec
lui, un chemin déjà pris par un autre contenu répond 409 fichier_existe, et
le même contenu répond 200 sans rien écrire. Sans lui, rien ne change : le
PUT remplace. C’est ce qu’emploie Cosa pour ajouter une section à un thème.
Voir Fichiers.
#garde : n’écrire que sur ce qu’on a lu
PATCH /api/menus et PATCH /api/parametres/<onglet> remplacent l’objet
entier. Ils acceptent désormais un champ facultatif
garde: { site, majLe } — l’identifiant du site visé et l’updated_at lu
avant d’écrire (null si l’objet n’existait pas). Si le site courant n’est
pas celui-là, la route répond 409 autre_site ; si l’objet a changé depuis,
409 modifie_entre_temps — et rien n’est écrit. Sans garde, rien ne change.
C’est ce qu’emploient les propositions de Cosa, qui peuvent être confirmées
longtemps après avoir été calculées. Voir Atelier.
#Du 7 au 11 août 2026
Aucune rupture. Tout ce qui suit est un ajout : un thème écrit avant ces dates rend exactement comme avant, et n’a rien à reprendre.
#Les polices, servies par la plateforme
10 août. Un quatorzième type de réglage, font_picker. Sa valeur est
l’identifiant d’une famille du catalogue de la plateforme — dix-neuf, servies
depuis /polices/ — ou systeme, qui n’en télécharge aucune. Le thème
nomme une police, il ne la transporte pas : assets/ n’accepte toujours
que .css et .svg.
Deux filtres maison vont avec, et il faut les deux.
<style>
{{ settings.police_titres | font_face }}
</style>
{%- assign pile_titres = settings.police_titres | font_famille -%}
--titre-police: {% if pile_titres != blank %}{{ pile_titres }}{% else %}var(--texte-police){% endif %};font_face écrit la règle @font-face — le fichier, les graisses,
font-display: swap ; font_famille rend la pile complète, la famille puis
son repli système. Un identifiant hors catalogue rend une chaîne vide,
jamais une erreur — et c’est par là que passe systeme : le thème teste
!= blank et pose le repli qu’il veut, comme ci-dessus.
#Les éditions
7 août avec Aplomb, généralisées le 11. config/theme.json accepte un
tableau editions : plusieurs habillages complets du même thème, chacun ne
posant que des valeurs de réglages — jamais une structure, jamais une
section, jamais un gabarit. Depuis le 11 août, une édition peut aussi
déclarer les metiers auxquels elle va, ce qui relie l’habillage au
contenu dans l’aperçu du Store. Le tableau editions lui-même reste
facultatif : un thème sans édition s’installe avec ses réglages par
défaut, comme avant. Voir Ajouter un thème au catalogue.
#Quatre thèmes d’origine de plus
Aplomb le 7 août, puis Cadence, Épure et Scène le 10. Le catalogue en compte huit.
#5 août 2026
La journée où la plateforme est devenue programmable. Tout ce qui suit est arrivé le même jour, dans cet ordre.
#Les thèmes Liquid
Un site peut désormais être rendu par un thème au format Shopify plutôt que
par les composants React du CMS. Six dossiers, layout/theme.liquid comme
coquille, des sections déclarées par un bloc {% schema %}, et des templates
JSON qui les composent.
layout/ .liquid
sections/ .liquid
snippets/ .liquid
assets/ .css .svg
config/ .json
templates/ .jsonLes deux moteurs cohabitent, et c’est délibéré. Un site qui a un thème publié passe par Liquid ; tous les autres continuent exactement comme avant. Aucun site en ligne n’a changé d’apparence ce jour-là — c’est ce qui a permis d’installer les thèmes sans fenêtre de maintenance. Voir l’anatomie d’un thème.
#Quatre thèmes d’origine
Origo d’abord : trente-cinq sections, sept gabarits de page, et de quoi tout régler sans toucher au code — couleurs, typographie, arrondi, largeur, densité. C’est le thème que reçoit tout le monde. Puis Forge, Vela et Piazza, plus typés.
Ils ont été renommés le jour même : leurs premiers noms étaient français et ne se prononçaient nulle part ailleurs. Un thème est un objet de catalogue, il voyage.
#page.demande — remercier sans JavaScript
Le formulaire de contact des thèmes postait dans le vide : il avait l’air de marcher et n’enregistrait rien. Il enregistre maintenant, et la page se rend à nouveau avec un objet de plus :
{% if page.demande == 'merci' %}
<p class="merci">Merci, votre message est parti.</p>
{% elsif page.demande == 'erreur' %}
<p class="erreur">L’envoi a échoué. Réessayez dans un instant.</p>
{% endif %}La valeur est lue dans la chaîne de requête après la redirection. C’est ce qui
permet à une section de remercier sans une ligne de script — et c’est cohérent
avec le refus du .js dans assets/.
#Le bac à sable prend ses bornes
Un thème s’exécute sur le serveur qui rend aussi les sites de tous les autres. Quatre bornes sont posées : rendu plafonné à 3 secondes, source analysée à 512 Ko, objets créés à 10⁸, imbrication de sections à 6 niveaux.
Deux détails valent d’être connus, parce qu’ils viennent de défauts réels :
- les 3 secondes sont appliquées deux fois. Une simple course contre un minuteur ne coupait rien : un rendu synchrone bloque le fil d’exécution de Node, donc le minuteur ne s’exécutait jamais ;
- le compteur de profondeur vit dans une fermeture, hors de portée du
thème. Tant qu’il vivait dans le contexte Liquid,
{% assign _profondeur = 0 %}suffisait à le remettre à zéro — un compteur qui surveille du code ne doit pas être écrit par ce code.
Le détail complet est sur la page du bac à sable.
#asset_url ne trouvait aucune feuille de style
Rupture — c’est le correctif qui demande peut-être une action de votre part.
Le filtre ajoutait le segment assets/ à l’adresse qu’il produisait, alors que
la route des fichiers de thème n’en veut pas :
| Adresse produite | |
|---|---|
| Avant | /theme-assets/<id>/assets/theme.css — 404 |
| Après | /theme-assets/<id>/theme.css |
La route est /theme-assets/<id>/<fichier>, un seul segment de nom, et c’est
elle qui remet le préfixe assets/ pour interroger la base. Conséquence :
aucun site sur thème Liquid n’avait jamais chargé sa feuille de style depuis
que les thèmes existaient. Le défaut ne levait aucune erreur — la page rendait
quand même, en HTML nu, ce qui ressemble à un thème mal écrit plutôt qu’à une
adresse fausse.
asset_url prend le nom seul du fichier, jamais son chemin.
{{ 'theme.css' | asset_url | stylesheet_tag }}Si un thème écrit {{ 'assets/theme.css' | asset_url }}, il fabrique
maintenant une adresse à deux segments qui ne correspond à aucune route :
retire le préfixe. Voir la page des assets.
#Le CLI
scripts/theme.mjs transporte les fichiers d’un thème entre un dossier local et
un site. Node 20.13 ou plus, aucune dépendance, un seul fichier qu’on peut
copier
ailleurs que dans ce dépôt.
node scripts/theme.mjs connexionnode scripts/theme.mjs recuperer --theme=Atelier --dossier=~/themes/ateliernode scripts/theme.mjs suivreSix commandes — connexion, lister, recuperer, pousser, suivre,
publier — chacune avec un alias anglais. Trois garde-fous qui n’ont pas été
ajoutés après coup :
poussersignale les fichiers distants absents en local, il ne les supprime pas.--supprimerles retire, après les avoir listés et demandé confirmation ;recupererliste les fichiers locaux divergents avant de les écraser ;suivrerefuse un thème publié sans--oui-je-sais, et propose de le dupliquer.
Il n’y a pas de serveur d’aperçu local, et il n’y en aura pas : la raison tient en trois paragraphes. Référence complète des commandes sur cette page.
#Les clés d’API
Le CLI ne connaît pas les cookies du navigateur : il s’authentifie avec une clé,
créée dans le CMS sous Paramètres → Clés d’API. Deux portées seulement —
lecture pour lire, themes pour tout.
Le secret (wc_ suivi de 43 caractères) ne s’affiche qu’une fois. La base
n’en garde que l’empreinte : personne, pas même nous, ne peut le rendre. Une clé
perdue se révoque et se remplace.
Le site visé se désigne par l’en-tête X-Webcosa-Site-Cible. Le suffixe
-Cible n’est pas décoratif : X-Webcosa-Site, sans lui, est un en-tête que le
proxy pose lui-même et purge de toute requête entrante. L’envoyer revient à
ne rien envoyer, et à écrire dans le premier site venu. Voir
l’authentification.
#L’éditeur de code, dans le CMS
Les fichiers d’un thème s’éditent aussi depuis le navigateur, avec la coloration
syntaxique et le refus de supprimer les trois fichiers indispensables
(layout/theme.liquid, templates/index.json, config/settings_schema.json).
C’est le chemin du dépannage, pas celui du travail quotidien : le CLI garde votre Git, vos raccourcis et votre éditeur. Les deux écrivent dans la même table.
#Le Store prend son adresse
Le catalogue des thèmes vit désormais sur store.webcosa.com, servi par le même
déploiement mais sur son propre hôte — et ouvert aux moteurs de recherche.
Ajouter un thème au catalogue passe par
le guide dédié ; rien n’y monte automatiquement depuis un
site.
#Cette documentation
dev.webcosa.com : les pages de référence et les guides, la recherche en
⌘K, et un bouton « Copier la page » qui rend le markdown de la page pour le
coller dans un assistant.
Deux écarts ont été relevés en l’écrivant, et documentés tels quels plutôt que corrigés en silence :
theme_basecommentaire de codeLe commentaire annonçait une base /t/<theme> ; la vraie base est
/theme-assets/<id>, et /t/… n’existe nulle part. C’est la première ligne
qu’on lit en enquêtant sur un 404 d’asset_url — elle envoyait chercher une
route absente.
TAILLE_MAX524288Comparé à la longueur de la chaîne, donc à des unités de code UTF-16, pas à
des octets. Un fichier plein d’accents passe la barre un peu plus tard qu’un
ls -l ne le laisse croire. Sans conséquence pratique : la borne existe pour
arrêter une archive malveillante, pas pour discipliner une feuille de style.
#Avant le 5 août 2026
Rien à signaler ici, et c’est exact : il n’y avait pas de surface développeur. Les sites étaient rendus par les composants React du registre du CMS, réglés depuis l’éditeur visuel. Aucun thème, aucun Liquid, aucune API publique, donc rien qu’un thème écrit aujourd’hui puisse regretter.
Ces sites-là existent toujours et continuent de rendre comme avant. C’est ce que recouvre l’expression « les deux moteurs » dans le reste de la documentation : un site passe par Liquid le jour où on lui publie un thème, jamais avant.
Vous avez trouvé un comportement qui contredit une page de cette documentation ?
C’est un défaut, et il se corrige dans les deux sens — soit le code, soit la
page. Écrivez à bonjour@webcosa.com avec l’adresse de la page.

