#Publier

Un thème installé, importé, dupliqué ou poussé arrive toujours en brouillon. Il faut un second geste pour qu’il remplace celui que voient les visiteurs. Ce guide dit ce que ce geste change exactement, ce qui se passe pour quelqu’un qui charge la page pendant, comment revenir en arrière, et pourquoi le thème publié refuse d’être supprimé.

#Brouillon et publié

Un site a au plus un thème publié — la base le garantit par un index partiel, ce n’est pas une convention. Tous les autres sont des brouillons, en nombre libre.

#Ce que publier change réellement

Trois écritures, dans cet ordre, et rien d’autre.

1. L’ancien thème est démis

   Tous les thèmes du site dont le rôle vaut publie repassent en brouillon. L’ordre compte et il est contraint : il faut démettre avant de promouvoir, sinon deux thèmes publiés coexistent le temps d’une instruction et l’index de la base refuse la seconde écriture.

2. Le nouveau est promu

   Son rôle passe à publie et son maj_le est mis à l’heure. Ses fichiers ne bougent pas — ils étaient déjà en base depuis le pousser, l’installation ou l’import. Publier ne déplace aucun octet.

3. Une page d’accueil est garantie

   Si le site n’a pas de page marquée comme accueil, elle est créée. Publier un thème, c’est mettre un site en ligne ; sans page d’accueil, l’écran « Pages » reste vide et le référencement n’a nulle part où poser un titre.

   Cette création est sans conséquence sur la publication : elle a lieu après, et si elle échoue, le thème reste bien en ligne. Une page qui ne se crée pas ne doit pas faire échouer un thème qui, lui, fonctionne.

Ce que publier ne change pas, et qui surprend :

• Ni le contenu, ni les pages, ni le menu, ni les articles. Ils n’appartiennent pas au thème. Changer de thème change l’habillage, pas ce qu’il y a dedans.
• Ni les réglages de l’ancien thème. Ils vivent dans le config/settings_data.json de ce thème-là et l’attendent s’il revient.
• Aucun fichier. Un brouillon publié puis démis retrouve exactement l’état dans lequel il était.

#Ce que voit un visiteur pendant

Rien de particulier, et c’est voulu.

Les pages publiques sont rendues à chaque requête — pas de cache à purger, pas de régénération à attendre. Une requête arrivée avant la mise à jour rend l’ancien thème et se termine normalement ; la suivante rend le nouveau. Il n’y a pas d’état intermédiaire dans lequel le site serait vide ou cassé : le basculement est un changement de ligne en base, et les deux thèmes sont complets de part et d’autre.

Concrètement : quelqu’un qui lit une page ne voit rien ; il verra le nouveau thème au clic suivant.

#Publier

« Forge » est déjà le thème publié.

curl -X PATCH https://cms.webcosa.com/api/themes \
  -H "Authorization: Bearer wc_…" \
  -H "X-Webcosa-Site-Cible: mon-client" \
  -H "content-type: application/json" \
  -d '{"id":"22222222-2222-4222-8222-222222222222","publier":true}'

#Revenir en arrière

Publier l’ancien. Il n’y a pas d’autre mécanisme, et il n’en faut pas d’autre : l’ancien thème est redevenu un brouillon au moment où le nouveau a été promu, avec tous ses fichiers et tous ses réglages intacts.

1. Retrouver l’ancien

   $node scripts/theme.mjs lister id nom version rôle modifié 22222222 Forge v2 1.0.0 publié il y a 2 min 11111111 Forge 1.0.0 brouillon il y a 4 j

2. Le republier

   $node scripts/theme.mjs publier --theme=11111111

   Ou, dans le CMS, le bouton Publier de sa ligne dans les brouillons.

3. Vérifier

   Recharge l’adresse publique. Le retour est immédiat, pour la même raison que l’aller : pas de cache à purger.

#Pourquoi le thème publié ne se supprime pas

{
  "error": "theme_publie",
  "message": "Ce thème est celui que voient tes visiteurs. Publie-en un autre avant de le retirer."
}

409, et c’est délibéré. Supprimer le thème publié éteindrait l’apparence du site en un clic, sans rien pour la remplacer — et il n’y a pas de corbeille : le code et les modifications partiraient définitivement. La garde force le geste qu’on voudrait de toute façon, dans l’ordre où on le voudrait : publier l’autre d’abord, retirer ensuite.

Deux gardes voisines relèvent de la même logique :

#Retirer un brouillon

Une fois qu’un autre thème est en ligne, le retrait ne demande rien de particulier. Site web → menu à trois points → Retirer le thème, avec la confirmation qui va bien : « Tout le code de ce thème sera effacé, y compris tes modifications. Télécharge-le d’abord si tu veux pouvoir y revenir. »

Prends l’avertissement au sérieux : Télécharger exporte le thème entier en un fichier JSON, réimportable tel quel. C’est la seule sauvegarde qui existe.

#La suite