Aller au contenu

#L'atelier : construire un site pour quelqu'un d'autre

Un partenaire construit des sites pour des clientes et les leur remet — comme une boutique de développement qu'on transfère au marchand. Le CLI couvre tout le parcours depuis son poste : le devis, le site, son contenu, sa mise en ligne, son transfert. Rien de tout cela ne demande d'ouvrir le CMS.

L'espace partenaire vit sur partner.webcosa.com : un accueil (l'encaissé, ce qui attend un geste, le journal des changements de cette documentation), la liste des sites typée (Développement, En cours de transfert, Collaboration) avec la fiche de chacun, les clientes, les devis, les clés d'API — et chaque site s'y ouvre dans le CMS d'un clic. Le CLI et l'espace lisent les mêmes tables : un site créé, un devis envoyé ou un transfert parti d'ici y apparaît aussitôt.

Il faut une clé d'API de portée atelier (Paramètres de l'espace partenaire, ou Réglages → Clés d'API du CMS), qui ne se délivre qu'à un compte partenaire ou agence. lecture ⊂ themes ⊂ atelier : une seule clé suffit pour tout, thèmes compris.

npm i -g https://dev.webcosa.com/cli/webcosa.tgzwebcosa connexion

#Le parcours, dans l'ordre

ÉtapeCommande
Le deviswebcosa devis creer --fichier=devis.json, puis webcosa devis envoyer --numero=WC-…
Le sitewebcosa site creer --nom="…" --theme=vela --metier=…
Le thèmewebcosa theme recuperer, éditer, webcosa theme pousser
Les pageswebcosa page ecrire --adresse=… --fichier=gabarit.json --publier
Le menuwebcosa menu definir --fichier=menus.json
La fichewebcosa entreprise completer --contact=… --legal=… --seo=…
Les photoswebcosa media televerser --fichier=photo.jpg
Le blogwebcosa blog creer --nom=Guides --slug=guides, puis webcosa article ecrire --fichier=article.md --publier
Les anciennes adresseswebcosa redirection ecrire --fichier=redirections.csv
Montrerwebcosa site publier, puis webcosa site acces --code=auto
Une maquette pour un prospectwebcosa site creer --nom="…" --maquette --prospect="…" — voir Les maquettes
Remettrewebcosa site transferer --courriel=… --formule=depart|pro [--presence]

Toutes les commandes acceptent --json : c'est la forme qu'un assistant lit.

#site — les commandes de l'atelier

site creer crée un site en atelier : il appartient au partenaire, a toutes les capacités, et rien n'est facturé tant qu'il n'est pas transféré. La commande pose un .webcosa.json dans le dossier courant : les suivantes visent ce site sans option.

webcosa site creer --nom="Miette d'Or" --theme=fondant --metier=boulangerie✓ Site créé : Miette d'Or (miette-d-or) En atelier : rien n'est facturé tant qu'il n'est pas transféré. .webcosa.json posé ici : les prochaines commandes visent ce site.
CommandeCe qu'elle fait
site creer --nom --theme --metier [--adresse] [--cliente --formule --presence --devis]un site en atelier, avec un thème du catalogue ; avec --cliente, « pour une cliente » : le transfert sera prérempli
site creer … --maquette --prospect [--expire] [--whatsapp] [--devis]le même site, posé en maquette pour un prospect (voir plus bas)
site lister [--json]les sites accessibles, leur état, leur formule
site publiermet le site en ligne (draft → live)
site acces [--code=…|auto] [--message] [--retirer]le code que la porte du site demande (8 caractères au moins ; auto en tire un, dictable au téléphone) ; sans option, celui en place ; --retirer ouvre le site
site maquette [--prospect --expire --prolonger --whatsapp --devis] [--retirer]pose, modifie ou retire le mode maquette ; sans option, son état et ses visites
site transferer [--courriel --formule --presence] [--message] [--devis] [--simuler]envoie « Reprenez votre site » ; sans option, reprend ce qui a été posé à la création
site transfert etat | renvoyer | annulerle transfert en cours
site langues lister [--json]la langue par défaut et les langues ajoutées, avec l'adresse de leur accueil (clé lecture)
site langues ajouter --langue=en [--json]ajoute une langue, servie sous /en/ dès que ses pages sont publiées

Un thème inconnu est refusé (theme_inconnu, avec la liste), pas remplacé en silence.

Où vivent les textes : dans le thème publié, fichier templates/<adresse>.json (sections, réglages, blocs). La table des pages ne porte que le routage. page ecrire fait donc les deux : la ligne de routage si elle manque, puis le gabarit.

webcosa page lire --adresse=accueil # la forme d'un gabaritwebcosa page ecrire --adresse=prestations --fichier=gabarits/prestations.json --titre="Prestations" --publierwebcosa menu definir --fichier=menus.jsonwebcosa entreprise lire # les champs attenduswebcosa entreprise completer --contact=contact.json --legal=legal.jsonwebcosa media televerser --fichier=photos/atelier.jpg

Les options qui attendent du JSON (--fichier, --contact…) acceptent un chemin de fichier ou du JSON en ligne. Les réglages possibles d'une section sont dans le {% schema %} de sections/<type>.liquid du thème.

#Un site en plusieurs langues

La langue par défaut est servie à la racine ; chaque langue ajoutée, sous son sous-répertoire, sur le même domaine. Une page anglaise porte sa langue dans son adresse (en/agency) et son gabarit est templates/en.agency.json ; l'accueil anglais est la page en (templates/en.json). --traduction-de relie une page à celle de la langue par défaut qu'elle traduit : chacune annonce alors l'autre (hreflang), et le sélecteur du thème (page.traductions) mène de l'une à l'autre.

webcosa site langues ajouter --langue=enwebcosa page ecrire --langue=en --adresse=accueil --fichier=gabarits/en.json --titre="Home" --publierwebcosa page ecrire --langue=en --adresse=agency --traduction-de=agence --fichier=gabarits/en.agency.json --titre="The agency" --publierwebcosa blog creer --nom=Insights --slug=insights --langue=en --traduction-de=journal

Une adresse dans une langue que la page n'a pas répond 404 : jamais la page d'une autre langue. Aucune redirection selon la langue du navigateur.

#blog, article, redirection — reprendre un blog

Un article vit à /blog/<blog>/<article>. Avec un seul blog, sa liste est à /blog ; à partir de deux, /blog liste les blogs et chacun vit à /blog/<blog>. Lire demande une clé lecture, écrire la portée atelier.

webcosa blog creer --nom=Guides --slug=guideswebcosa article ecrire --fichier=contenu/blog/guides/mon-article.md --publierwebcosa article lister --blog=guideswebcosa redirection ecrire --fichier=redirections.csv # depuis,vers

article ecrire crée l'article ou le met à jour s'il existe à cette adresse : la commande se rejoue, et rien ne change si le fichier n'a pas changé. Le corps est du Markdown (.md, tableaux compris) ou du HTML (.html), converti par le serveur dans le format de l'éditeur ; ce qui est retiré est dit. Le frontmatter :

---
titre: "Agence ou freelance Shopify : comment choisir"
slug: "agence-vs-freelance-shopify"
blog: "comparatifs"
description: "Le résumé que Google affiche."
extrait: "Le texte des cartes du blog (sinon : la description)."
couverture: "https://….supabase.co/storage/v1/object/public/site-media/<site>/couv.jpg"
couverture_alt: "Ce que montre la photo"
publie: "2026-02-06"
modifie: "2026-02-06"
---
CommandeCe qu'elle fait
blog lister [--json]les blogs, leur adresse publique, leurs articles publiés et brouillons
blog creer --nom --slug [--description] [--langue --traduction-de]un blog ; déjà là à cette adresse, il est laissé tel quel ; --langue=en : il vit sous /en/blog
article lister [--blog] [--json]les articles, brouillons compris
article lire --slugl'article en JSON, corps compris
article ecrire --fichier [--blog] [--slug] [--titre] [--traduction-de] [--publier]crée ou met à jour l'article par son adresse ; sa langue est celle de son blog, traduction_de (frontmatter) le relie à l'article qu'il traduit
article publier --slugmet l'article en ligne
redirection lister [--json]les redirections du site
redirection ecrire --fichier=x.csvécrit un CSV depuis,vers par le moteur de redirections (un saut, ni chaîne ni boucle) ; une ligne refusée est dite, code de sortie 1
redirection supprimer --depuis=/ancienne [--force]retire une redirection, après confirmation

Les images — couverture comprise — doivent être dans la médiathèque du site : la politique des sites bloque toute autre origine. Déposez-les d'abord (webcosa media televerser --json) et écrivez l'adresse rendue ; une image d'ailleurs est refusée, nommément.

Les dates. publie est gardée telle quelle (une date seule est lue à midi UTC) ; une date future est refusée. modifie ne vaut qu'à la création, et seulement si l'article est publié dans le même geste (--publier) : toute mise à jour ultérieure, publication comprise, pose la date du jour.

#Les maquettes

Une maquette est un site en atelier montré à un prospect avant toute signature : quelques pages, ses propres photos, son nom. Rien n'est facturé ; s'il signe, on transfère le site et il devient le sien, tel quel.

webcosa site creer --nom="Studio Lumière" --theme=vela --metier=architecte --maquette --prospect="Atelier Durand" --whatsapp="06 12 34 56 78"webcosa site acces --code=autowebcosa site publier✓ Site créé : Studio Lumière (studio-lumiere) En atelier : rien n'est facturé tant qu'il n'est pas transféré. Maquette pour Atelier Durand visible jusqu'au 8 décembre 2026 (21 jours) 0 visite · 0 page vue · pas encore ouverte WhatsApp : +33612345678 · Activer → un courriel à vous ! Aucun code d'accès : personne ne peut voir cette maquette. webcosa site acces --code=auto

Ce que la plateforme fait d'un site en maquette — par-dessus le thème, sans qu'un fichier du thème puisse le retirer :

  • le code d'accès est exigé, même décoché dans le CMS ; sans code posé, personne n'y entre. La porte ne nomme pas le prospect ;
  • les robots restent dehors : noindex, nofollow dans la page et en en-tête (X-Robots-Tag), hors du plan du site, de llms.txt et d'IndexNow ;
  • des freins à la copie : pas de sélection de texte, pas de glisser ni de menu « enregistrer l'image » (toucher long, clic droit), page blanche à l'impression. Une capture d'écran, elle, ne s'empêche pas ;
  • une barre discrète en bas, « Ce site peut être le vôtre » : Activer mène à la page de signature du devis rattaché (--devis), sinon à un courriel au partenaire ; WhatsApp ouvre une conversation avec votre numéro, préremplie « Bonjour, j'ai vu la maquette de ⟨site⟩ » ;
  • une notification dans la cloche du CMS quand le prospect saisit le code, puis à ses visites — une au plus par visiteur et par heure, avec la page et l'heure. L'aperçu du site dans le CMS ne compte pas, ni les robots et outils (curl, navigateurs sans tête, aperçus de lien) ;
  • un lien de vérification : site maquette (sans option) et l'onglet « Maquettes » de l'espace partenaire donnent une adresse, valable un jour, pour ouvrir votre maquette sans compter la visite ni sonner votre cloche. Le navigateur qui l'ouvre est reconnu pour la journée, code d'accès compris.

L'échéance vaut 21 jours (--expire=14 ou --expire=2026-12-08 ; --prolonger=7 repousse celle en cours ; trois mois au plus). À l'heure dite, la porte se ferme ; la nuit suivante, le site est dépublié et les fichiers qu'il a déposés sont effacés — les photos d'un prospect ne se gardent pas sans signature. Prolonger rouvre la maquette ; republier le site et redéposer les photos restent à faire.

Un devis déjà envoyé avant d'être rattaché à la maquette : renvoyez-le (webcosa devis envoyer) pour qu'« Activer » mène à sa signature — son lien n'est gardé qu'en empreinte. Le transfert (site transferer, puis la reprise) retire tout : échéance, barre. Le site reste tel quel, avec son code d'accès jusqu'à la reprise.

L'espace partenaire les liste dans Sites → Maquettes : prospect, échéance, dernier accès, visites ; on y prolonge de 21 jours ou on retire le mode d'un clic.

#devis — émettre, envoyer, suivre

Le devis s'écrit dans un fichier JSON — cliente, objet, formule prévue, inclus, délais, mise en route (99 € par défaut) — et se rend en PDF à l'envoi. La cliente le lit, le signe (son nom, son accord, un code reçu à son adresse) et règle sur signature.webcosa.com. Le partenaire est prévenu à chaque étape.

webcosa devis creer --fichier=clients/miette-d-or/devis.jsonwebcosa devis envoyer --numero=WC-2026-0001webcosa devis etat --numero=WC-2026-0001 # état, PDF, et la chronologie : envoyé, ouvert, code demandé, signé, refusé…webcosa devis lister

Au transfert du site, --devis=<id> relie le site au devis.

#Le transfert, et ce qui change

webcosa site transferer --courriel=marie@exemple.fr --formule=depart --presence --devis=WC-2026-0001 Envoyer à marie@exemple.fr le lien « reprenez votre site » — formule Solo + Présence. Une fois repris, le site vous échappe : vous restez éditeur, la cliente paie et décide. Envoyer ? (o/N) o ✓ Lien envoyé à marie@exemple.fr. Valable jusqu'au 24/09/2026.

La cliente reçoit un courriel avec un bouton. Elle n'a pas de compte : un code à six chiffres, envoyé à l'adresse du transfert, lui en ouvre un. En reprenant le site, elle en devient propriétaire, le site s'endort (page « Site indisponible ») et elle choisit sa formule — celle prévue est présélectionnée. Le premier paiement le met en ligne.

Le partenaire reste éditeur : sa clé pousse encore le thème et écrit les pages, mais la facturation et l'équipe lui sont fermées (403 role_insuffisant). La cliente peut le retirer depuis l'écran Équipe.

Le lien vaut quatorze jours ; site transfert renvoyer en fabrique un nouveau (l'ancien meurt), trois fois par jour au plus.