Aller au contenu
Webcosa Développeurs

#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.

Il n’y a pas de numéros de version

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.template vaut "404" —, avec un document neutre aux couleurs du thème, comme les pages légales. Tête noindex.
  • indexable. PATCH /api/pages/<id> accepte { "indexable": false } : la page reste servie, en noindex, follow, hors du plan du site et de llms.txt.
  • Une forme par adresse. Une adresse en majuscules, à barre finale, en .html ou en index.html redirige en une seule 308 vers sa forme propre (site par site, en cours de déploiement) ; une page se lit à son chemin entier (/tarifs/x n’est plus la page tarifs). Un lien de votre thème vers /page/quelque-chose qui servait page cessera 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.

layout/theme.liquid — Origoliquid
<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.

L’arborescence admise
layout/     .liquid
sections/   .liquid
snippets/   .liquid
assets/     .css .svg
config/     .json
templates/  .json

Les 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 :

sections/contact.liquidliquid
{% 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.

Ce qu’il faut vérifier dans vos thèmes

asset_url prend le nom seul du fichier, jamais son chemin.

liquid
{{ '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 suivre

Six 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 :

  • pousser signale les fichiers distants absents en local, il ne les supprime pas. --supprimer les retire, après les avoir listés et demandé confirmation ;
  • recuperer liste les fichiers locaux divergents avant de les écraser ;
  • suivre refuse 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 code

Le 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_MAX524288

Comparé à 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.

Astuce

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.