#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
| Étape | Commande |
|---|---|
| Le devis | webcosa devis creer --fichier=devis.json, puis webcosa devis envoyer --numero=WC-… |
| Le site | webcosa site creer --nom="…" --theme=vela --metier=… |
| Le thème | webcosa theme recuperer, éditer, webcosa theme pousser |
| Les pages | webcosa page ecrire --adresse=… --fichier=gabarit.json --publier |
| Le menu | webcosa menu definir --fichier=menus.json |
| La fiche | webcosa entreprise completer --contact=… --legal=… --seo=… |
| Les photos | webcosa media televerser --fichier=photo.jpg |
| Le blog | webcosa blog creer --nom=Guides --slug=guides, puis webcosa article ecrire --fichier=article.md --publier |
| Les anciennes adresses | webcosa redirection ecrire --fichier=redirections.csv |
| Montrer | webcosa site publier, puis webcosa site acces --code=auto |
| Une maquette pour un prospect | webcosa site creer --nom="…" --maquette --prospect="…" — voir Les maquettes |
| Remettre | webcosa 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.| Commande | Ce 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 publier | met 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 | annuler | le 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.
#page, menu, entreprise, media — le contenu
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.jpgLes 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=journalUne 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,versarticle 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"
---| Commande | Ce 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 --slug | l'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 --slug | met 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=autoCe 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, nofollowdans la page et en en-tête (X-Robots-Tag), hors du plan du site, dellms.txtet 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 listerAu 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.

