Passer au contenu principal
Un thème Liquid est un paquet de fichiers texte, rendu côté serveur avec Liquid. Si vous connaissez les thèmes Shopify, la structure vous sera familière.

Dossiers

Chaque thème doit contenir layout/theme.liquid, templates/index.json et config/settings_schema.json.

Sections et schema

Une section déclare ses paramètres et ses blocs dans un bloc {% schema %}. L’éditeur visuel construit son formulaire de paramètres à partir de celui-ci.
sections/hero.liquid
Les valeurs des paramètres de texte enrichi et HTML sont nettoyées côté serveur lors de leur enregistrement.

Objets

Filtres

Échappez chaque texte de produit et de client avec | escape. Les titres et descriptions sont rédigés par des personnes.

Balises

Blocs d’application : add_to_cart, buy_now, cart_count, cart_drawer, checkout_button, powered_by, variant_picker.

Pages de la plateforme

Le paiement, le panier, la connexion, le compte et le suivi de commande s’exécutent toujours sur PapelShip. Vous pouvez concevoir la page qui les entoure avec un template contenant exactement un bloc verrouillé :
templates/checkout.liquid
Le bloc doit se trouver directement dans le template, et non dans un snippet. Le JavaScript du thème n’est jamais chargé sur ces pages, et les champs de carte sont toujours ceux de la plateforme.

Publication

Les enregistrements sont des brouillons : la boutique en ligne conserve la version publiée jusqu’à ce que vous publiiez.
  1. Modifiez une copie dans l’éditeur de code ou dans l’éditeur visuel. L’enregistrement (Ctrl+S) valide le fichier et conserve une version ; l’autre éditeur affiche immédiatement la modification.
  2. Prévisualisez la copie dans l’éditeur.
  3. Cliquez sur Publish dans l’un ou l’autre éditeur. Il liste les fichiers non publiés et valide d’abord tous les fichiers du thème.
Les agents IA peuvent enregistrer des brouillons, mais ne peuvent pas publier. Consultez Agents IA (MCP).