Boutique — documentation Sillon

Ce qu'il fait

Boutique en ligne complète : produits physiques avec stock et TVA, catégories multiples hiérarchiques, étiquettes, attributs enregistrés, statut brouillon/publié, image de mise en avant, prix promo barré, référencement unifié via le hub SEO (module seo, filtre seo.items), comptes clients, panier, checkout, livraison par zones (types de livraison, blocs de prix, classes d'expédition) et paiement par prestataires branchables (Stripe, PayPal, Mollie, PayPlug, Lyra/Systempay fournis nativement, personnalisables via le filter shop.payment.providers) — sans jamais coder le paiement lui-même. Bâtie sur un tronc aveugle au type de produit (résolveur de prix unique, accomplissement par type de ligne, paiement partiel), extensible par satellites cumulables (variantes, digital, promo, factures, B2B…). Aucune connexion avec le module Catalogue : tables et admin propres de bout en bout.

Produits avec stock, TVA, catégories multiples hiérarchiques et attributs enregistrés
Éditeur façon boutique pro : brouillon/publié, image de mise en avant, prix promo barré, score SEO
Comptes clients + commande invité (au choix)
Livraison par zones : types de livraison (domicile, retrait, point relais…), forfait, grille au poids, gratuité dès un montant, classes d'expédition
Checkout en 2 étapes + commandes avec échéancier de paiement
Paiement par prestataires branchables : Stripe, PayPal, Mollie, PayPlug et Lyra fournis
Statuts de commande à vous : étapes sur mesure, e-mail au client à chaque étape, compteur « à préparer » et chiffre encaissé qui suivent vos étapes
Tableau de bord des ventes : encaissé du mois, panier moyen, commandes à préparer
Statistiques par période (chiffre d'affaires, panier moyen, meilleures ventes) et alerte e-mail quand un stock passe sous le seuil
Au premier clic sur « Boutique », un formulaire de mise en route pose les réglages (TVA, paiement, livraison) et active les satellites utiles

Où le trouver

Les écrans que ce module ajoute à l'administration, une fois activé.

Boutique /admin/shop

Ses réglages

Ils se modifient depuis l'administration. La clé est donnée pour qui pilote le site en ligne de commande ou par l'API.

Réglage	Clé	Type	Par défaut
Autoriser la commande sans compte (invité) — historique, piloté par shop.checkout.compte	`shop.guest_checkout`	bool	`oui`
Le compte client à la commande (invite \| creation \| obligatoire)	`shop.checkout.compte`	string	`(vide)`
Régime fiscal du site (ue_assujetti, ue_franchise, hors_ue)	`shop.vat.regime`	text	`ue_assujetti`
Miroir du régime : TVA européenne calculée (seul ue_assujetti l'allume)	`shop.vat.enabled`	bool	`oui`
Taux de TVA du site (%) — étage 1 de la cascade site → catégorie → produit	`shop.vat.default_rate`	float	`20`
Les prix des fiches produit sont saisis TTC (décoché = HT, la TVA s'ajoute)	`shop.vat.prices_include_tax`	bool	`oui`
Afficher les prix en TTC sur le site (décoché = HT, mention « HT » ajoutée)	`shop.vat.display_include_tax`	bool	`oui`
Préfixe des numéros de commande (vide : pas de préfixe)	`shop.order.number_prefix`	string	`CMD`
L'année dans les numéros de commande	`shop.order.number_annee`	bool	`oui`
Nombre de chiffres des numéros de commande (complétés par des zéros)	`shop.order.number_chiffres`	int	`6`
Page des CGV (lien de la case à cocher)	`shop.cgv_url`	string	`/cgv`
Panier multi-classes : tarif retenu (max\|sum)	`shop.shipping.multi_class_rule`	string	`max`
Masquer les méthodes payantes quand une livraison offerte (seuil « dès X € ») est atteinte	`shop.shipping.hide_others_when_free`	bool	`oui`
Message affiché au checkout pour un produit non livrable vers la destination (jetons {produit} et {pays})	`shop.shipping.uncovered_message`	string	`Le produit {produit} ne peut pas être livré vers {pays}.`
Purge des paniers abandonnés après (jours)	`shop.cart.gc_days`	int	`60`
Seuil « stock bas » (unités)	`shop.stock.low_threshold`	int	`5`
Masquer du catalogue les produits en rupture	`shop.stock.hide_out_of_stock`	bool	`non`
Affichage du stock côté client (always\|low_only\|never)	`shop.stock.display_mode`	string	`low_only`
Prévenir par e-mail quand un produit passe sous le seuil	`shop.stock.notify`	bool	`non`
Destinataire des alertes de stock (vide = e-mail de contact du site)	`shop.stock.notify_email`	string	`(vide)`
Tentatives de commande autorisées par quart d'heure et par visiteur (0 = pas de limite)	`shop.checkout.rate_limit`	int	`12`
Page de politique de confidentialité liée au checkout (vide = pas de lien)	`shop.privacy_url`	string	`(vide)`
Après un ajout au panier : rester sur la page (stay) ou aller au panier (cart)	`shop.cart.after_add`	string	`stay`
Adresse de la page Panier (requise pour « aller au panier » après un ajout)	`shop.cart.url`	string	`(vide)`
Image de remplacement des produits sans photo (nom de fichier dans /assets/img/shop/)	`shop.product.placeholder_image`	string	`(vide)`
Motif d'URL publique d'un produit (ex : /boutique/{slug})	`shop.product_url`	string	`(vide)`

Ses droits

Ce que chaque rôle peut faire par défaut. Modifiable rôle par rôle depuis l'administration.

Droit	Clé	Administrateur	Éditeur
Voir la boutique (commandes, produits)	`shop.read`	✓	✓
Créer / modifier les produits	`shop.products.manage`	✓	✓
Gérer les commandes (statuts, création manuelle)	`shop.orders.manage`	✓	—
Voir les comptes clients (données personnelles)	`shop.customers.read`	✓	—
Régler livraison, paiement et réglages boutique	`shop.config.manage`	✓	—

Ses satellites

Des modules qui se greffent sur celui-ci et s'activent séparément. Chacun a sa page.

Abonnements Vendez des abonnements : un 4e type de produit (jamais une variation) qui porte des PLANS (mensuel, annuel, hebdo, période fixe…
Achats en direct La petite bulle « Camille vient de commander… », en bas de page. Elle lit vos VRAIES commandes payées
Avis produits Avis produits avec notes, photos et modération : note globale (ou moyenne de sous-notes que vous nommez), badge « achat vérifié »…
Cartes cadeaux Vendez des cartes cadeaux, ou offrez un avoir à un client. Chaque carte a son code, son solde et son journal
Catégories de clients Catégories de clients pro (« Revendeur 1 », « Gros compte »…) avec picto+couleur, prix, conditionnement, conditions de paiement…
Connexion comptabilité Branche la boutique sur votre vrai logiciel de comptabilité. La descente : votre compta vient chercher les ventes d'une période…
Connexion sécurisée Ajoute une vérification par email à la connexion des comptes clients : après le mot de passe, un code à 6 chiffres (valable 10…
Contenus réutilisables Bibliothèque de contenus courts (guide des tailles, entretien) écrits une fois puis rattachés aux produits.
Devis & conditions de paiement Devis (+ conversion en commande en un clic, wording dédié sur ses 2 emails de création), échéancier de paiement MANUEL (N…
Documents & factures Génère un document imprimable (facture / devis / bon de livraison / avoir) pour n'importe quelle commande de la Boutique — HTML…
Douane & expédition internationale Prépare les déclarations douanières de vos envois hors Union européenne. Renseignez le code SH (la nomenclature douanière) et le…
Expédition & étiquettes Le socle d'expédition de votre boutique : préparez une expédition depuis la commande sur un écran de vérification pré-rempli…
Flux catalogue Envoie vos produits à Google Shopping, Facebook, Instagram, TikTok et Pinterest. Vous collez une adresse une fois dans chaque…
Passerelles (webhooks) Envoie vos événements de commande vers une URL externe : votre logiciel de comptabilité crée sa facture tout seul quand une…
Promotions Créez des codes promo (« ETE2026 ») que vos clients saisissent au panier ou au checkout
Questions de la commande Ajoutez vos propres questions au tunnel de commande : une date souhaitée (« pour quand ? »), une référence, une précision, un…
Tarifs dégressifs Des paliers de quantité PUBLICS sur un produit simple (a partir de 150 : 8 euros l'unite, a partir de 300
TVA du pays du client (guichet OSS) Gère la TVA de vos ventes aux particuliers de l'Union européenne. Le module compte votre chiffre d'affaires transfrontalier de…
TVA à l'international Applique les deux régimes de vente à l'étranger. Vos clients PROFESSIONNELS de l'Union européenne
Téléchargements Vendez des fichiers téléchargeables (PDF, ZIP, ebooks, audio/vidéo…) : choisissez le type « Produit téléchargeable » sur…
Variations Déclinez un produit en plusieurs variations (tailles, couleurs…) : cochez, sur chaque attribut — enregistré OU LIBRE, converti…
Vente internationale Ouvre la vente à l'étranger : le client choisit son pays, et le formulaire d'adresse s'adapte — l'ordre des champs, leurs noms…
Import Reprenez un catalogue existant : déposez le fichier exporté de votre ancienne boutique (WooCommerce ou n'importe quel tableau…

Ce qu'il suppose

Ce module a besoin de :

comptes *
categories *

Le désactiver arrêterait aussi :

Piloter par une IA

Ce que ce module sait faire quand on le lui demande en langage naturel, et ce que chaque action engage.

produits lecture seule

Liste les produits de la boutique (lecture seule) : nom, slug, description, prix (centimes + price_display formaté), catégorie, stock, images, url publique absolue. La réponse porte la devise du site (currency ISO 4217, symbol) et site_url. Params : category_slug (optionnel), limit (max 50).

« quels produits j'ai en boutique ? »
produit_champs lecture seule

Détaille un produit : ses textes modifiables, et ses données commerciales en LECTURE SEULE (prix, stock, statut). À lire avant de modifier.

« qu'est-ce qu'il y a sur la fiche du produit 12 ? »
produit_modifier écrit, annulable

Modifie le NOM, l'ACCROCHE ou la DESCRIPTION d'un produit. Écriture journalisée : annulable. Ne touche JAMAIS au prix, au stock, au statut ni aux variations — ce sont des décisions commerciales, prises depuis la fiche produit.

« réécris la description du produit 12 en plus court » « change l'accroche de la bougie parfumée »
commandes lecture seule réservée à votre accès MCP (clé maître)

Liste les commandes récentes de la boutique (lecture seule) : numéro, email, statut, total, date. Params : status (optionnel), limit (max 50).
commande lecture seule réservée à votre accès MCP (clé maître)

Une commande en entier : client, lignes (variante, options, texte personnalisé), ce que le client a précisé, livraison et suivis, totaux, règlements, note interne, message au client, et les statuts qu'on peut poser. Par « id » ou « numero ».

« qu'a commandé la cliente de la commande CMD-2026-0042 ? »
commande_noter écrit, annulable

Écrit dans la NOTE INTERNE d'une commande (jamais vue du client) : à la suite par défaut, ou en remplaçant. Journalisée : annulable. Ne touche ni au statut, ni aux montants, ni aux lignes.

« note sur la commande 42 que la cliente a choisi le calendrier version chats »
commande_message_client confirmation demandée

Pose le MESSAGE AU CLIENT d'une commande : il s'affiche sur sa page commande et part par e-mail, comme depuis la fiche. Remplace le précédent. Un e-mail part : confirmation demandée.
commande_suivi confirmation demandée

Ajoute un NUMÉRO DE SUIVI à une commande (une commande peut en avoir plusieurs). Le transporteur de la commande sert par défaut. Selon les réglages, le statut avance et le client est prévenu : confirmation demandée.
commande_statut confirmation demandée

Change le STATUT d'une commande, comme le sélecteur de la fiche (les e-mails réglés sur le statut partent). Refusés : Payée et Partiellement payée (passer par commande_encaisser), Remboursée, Corbeille, Devis. Confirmation demandée.
commande_encaisser confirmation demandée

Note un RÈGLEMENT REÇU hors ligne (virement, chèque, espèces) sur une commande en attente de paiement, comme « Paiement manuel » de la fiche ; jamais plus que ce qui reste à régler. La commande avance d'elle-même. Confirmation demandée.
commande_creer confirmation demandée

Crée une COMMANDE (ou un DEVIS si le pack commercial est actif), comme « Nouvelle commande » de l'admin. Les prix viennent du catalogue, jamais de l'appel ; les e-mails suivent les règles de l'admin (le client choisit son moyen de paiement en réglant). Une pièce qui engage la boutique : confirmation demandée.

« fais une commande de 2 tasses Tsukoozu pour Camille Martin, livraison Colissimo »

Ses points de branchement

Pour greffer du code sans toucher au module : ce qu'il annonce, et ce qu'il écoute.

Ce qu'il annonce 77

shop.remboursement.avoir_possible: Filtre (bool) — un satellite sait rembourser EN AVOIR (bon d'achat) : la fenêtre « Rembourser » le propose. Args: [bool $possible]
shop.remboursement.avoir: Filtre — émet le bon d'achat d'un remboursement en avoir ; rend {ok, id, code, errors}, null sans écouteur. Args: [null, array $order, int $montantCents, string $motif, ?int $actorId]
shop.commandes.gestes_groupes: Event — la barre des commandes cochées (liste des commandes) s'affiche. Un satellite y ÉCRIT un bouton submit avec `formaction` vers son écran : les cases ids[] et le jeton CSRF partent avec. Args: aucun.
shop.compte.donnees: Filter — CE QUE LES SATELLITES DÉPOSENT POUR L'ESPACE CLIENT. Args: [array $extras, array $client]. Clés connues : `abonnements` (shop-abonnements, chacun DÉJÀ enrichi de `statut_libelle` et `fichiers`), `licences_abonnement` et `licences_seules` (shop-licences). ⚠️ L'ORDRE COMPTE : les licences se calculent à partir des abonnements, d'où les priorités 10 puis 20. Même raison d'être que `shop.produit.donnees` : la Boutique appelait ces satellites par leur nom de classe jusqu'au 2026-09-28.
shop.connexion.etat: Filter — L'ÉTAT DE LA CONNEXION, dit par le satellite qui le connaît. Args: [array $etat]. Clés : `code_en_attente` (bool) et `minutes` (durée de validité). Sert à la page de connexion de la boutique, qui affiche le formulaire de code à six chiffres à la place des autres quand un code est en attente.
shop.produit.donnees: Filter — CE QUE LES SATELLITES DÉPOSENT POUR LA FICHE PRODUIT. Args: [array $extras, array $raw, ?array $front] — $raw est le produit BRUT (avec son `type`), $front celui que la vue affiche. Chaque satellite ajoute SA clé et rend le tableau : `variants` (shop-variants), `abonnement` (shop-abonnements), `avis_resume` (shop-avis). Une clé absente vaut « pas concerné » et la vue n'affiche alors aucun bloc. 🔴 EXISTE POUR RÉTABLIR LE SENS DE LA DÉPENDANCE : jusqu'au 2026-09-28 la vue appelait ces trois satellites par leur nom de classe, donc retirer un satellite obligeait à modifier la Boutique. Le BALISAGE, lui, reste dans la vue : les classes `s-shop-*` sont le contrat des thèmes.
shop.product.url_publique: Filter — l'adresse publique d'un produit, pour les liens de l'admin vers le site. Args: [string $url, array $product]. Défaut du socle : /boutique/<slug>. Rendre '' pour retirer le lien.
shop.price.line: Filter — LE résolveur de prix. Args: [array $line, array $product, int $qty, array $ctx]
shop.shipping.item: Filter — UNE LIGNE À EXPÉDIER : ce qu'elle pèse et dans quelle classe elle part. Args: [array $ligne, array $source] — $ligne = ['product' => array, 'qty' => int], $source = la ligne de panier ou de commande (avec ses `options`). Un satellite corrige `product` (`weight_g`, `shipping_class_id`) et rend la ligne : shop-variants y pose le poids et la classe de la DÉCLINAISON choisie. Lue par le calcul du port (`Shipping::shippableItems`) ET par le poids de l'étiquette (shop-expedition). Zéro écouteur = le produit seul, comme avant (2026-09-30).
shop.catalogue.precharger: Action — LA PAGE DE CATALOGUE VA ÊTRE TARIFÉE : voici ses produits. Args: [array<int> $productIds, array<int, array> $categoriesParProduit]. Un satellite qui lit la base dans `shop.price.line` charge ici, en une fois, ce que sa part du prix demandera pour chaque produit ; son écouteur de prix lit alors sa mémoire au lieu de la base. Appelée par `Products::frontList()` (2026-09-30 : shop-pro coûtait 46 requêtes sur 51 pour 17 produits). Un satellite qui ne l'écoute pas reste juste, simplement plus lent.
shop.price.mention: Filter — la phrase affichée au client quand le prix n'est pas celui qu'il attendait (taxe d'un autre pays, taxe retirée). Le socle voit un taux tombé à zéro mais PAS pourquoi : deux régimes s'y cachent (autoliquidation intra-UE, export hors UE) et ils ne se disent pas pareil. Celui qui a exonéré fournit sa mention, comme il fournit celle de la facture via shop.documents.snapshot. Rendre $mention inchangé pour se taire. Args: [?string $mention, array $line, array $ctx, string $pays]
shop.vat.export_detaxe: Filter — LA GARDE DE COHÉRENCE de l'affichage (#103) : le socle demande si la détaxe export aura RÉELLEMENT lieu pour cette destination avant d'afficher un prix hors taxes — sinon il montrerait moins que ce qu'il encaisse. shop-tva-intra répond selon son interrupteur export et sa carte du territoire fiscal. Zéro écouteur = zéro détaxe = affichage TTC. Args: [bool $deja, string $pays]
shop.shipping.rate: Filter — tarif de livraison résolu. Args: [?array $rate, array $method, ?array $zone, array $classes, array $cart]
shop.shipping.product_excluded: Filter bool — un produit doit-il être EXCLU du calcul de classe/zone de livraison ? Args: [bool, array $product]. Défaut false.
shop.cart.validate: Filter — erreurs bloquantes du panier au checkout. Args: [array $errors, array $cart, array $ctx]
shop.cart.add.validate: Filter — validation + enrichissement à L'AJOUT au panier (Cart::add(), juste avant l'écriture de la ligne). Args: [array $result{errors: string[], options: array}, array $product, int $qty] — $qty = quantité RÉSULTANTE de la ligne (existante + cet ajout). Le satellite pousse ses erreurs dans $result['errors'] (fail closed, la moindre erreur bloque l'ajout) et peut remplacer $result['options'] par une version enrichie (ex. libellé lisible) — utilisée UNIQUEMENT pour le JSON stocké sur une ligne NOUVELLE, jamais pour le hash d'identité (toujours calculé sur les options brutes de l'appelant).
shop.cart.added: Event — un ajout au panier a RÉUSSI (Cart::add(), après l'écriture). Args: [array $product, int $qty, array $options] — $qty = ce que CE geste a ajouté, $options = les options brutes de l'appelant (variant_id d'une déclinaison). Les pixels publicitaires y notent l'« ajout au panier ».
shop.checkout.consentements: Event — rendu HTML direct sous la case des CGV du passage en caisse (écho). Args: [array $cart]. La newsletter y pose la case « Je ne souhaite pas recevoir vos nouveautés » quand elle inscrit les clients à leur commande ; elle lit la case dans `shop.cart.validate`.
shop.checkout.usage_donnees: Filter string — la phrase « Vos données servent à traiter votre commande… » au-dessus du lien de confidentialité. Args: [string $phrase, array $cart]. Un module qui se sert des coordonnées pour autre chose la réécrit (la newsletter : « … et, sauf refus de votre part, à vous envoyer nos nouveautés »).
shop.cart.needs_shipping: Filter bool — le panier requiert-il une livraison ? Args: [bool, array $cart]
shop.order.created: Event — commande créée (pending_payment), web (Checkout::place()) ou manuelle (Orders::createManual()). Args: [array $order]
commande.creee: Event neutre — commande créée (Checkout::place() + Orders::createManual()). Args: [array $order]
paiement.recu: Event neutre — commande intégralement réglée (Orders::markPaid(), après shop.order.paid). Args: [array $order]
commande.a_livrer: Event neutre — commande DUE, à livrer : émis par markPaid() (après paiement.recu) ET par Orders::livrer() (commande due sans paiement propre, ex. box d'abonnement). Les satellites de LIVRAISON écoutent celui-ci, jamais paiement.recu. Args: [array $order]
numero_suivi.ajoute: Event neutre — n° de suivi nouvellement renseigné (Orders::updateAdmin()). Args: [array $order]
devis.accepte: Event neutre — devis converti en commande (Orders::convertToOrder(), bouton fiche §4). Args: [array $order]
shop.order.status_changed: Event — statut modifié (Orders::setStatus() ou Payments::register()/registerManual()). Args: [array $order, string $from, string $to]
shop.order.ready_to_fulfill: Filter bool — la commande peut-elle être accomplie ? Émis par Orders::markPaid() (admin ou Payments, dès qu'intégralement réglée). Args: [bool, array $order]
shop.order.paid: Event — commande intégralement payée (après ready_to_fulfill). Args: [array $order]
shop.fulfill.<type>: Event dynamique — accomplissement d'une ligne payée, une fois par type de ligne présent. Args: [array $order, array $line]
shop.order.shipping.actions: Event — actions transporteur COURTES, dans le RAIL sous le bloc Livraison ; rendu HTML direct (écho, pattern do_action §5bis). Un écran de travail va sur shop.order.main.panels. Args: [array $order]
shop.order.public.livraison: Event — rendu HTML direct sous la ligne de livraison de la page « Ma commande » du CLIENT (écho, patron do_action). Args: [array $order]. Là où se lit le LIEU quand le mode ne suffit pas : shop-expedition y affiche le point relais que le client a choisi.
shop.order.adresses.apres: Event — rendu HTML direct sous les deux adresses de la fiche commande (écho, patron do_action). Args: [array $order]. Là où se lit la DESTINATION RÉELLE quand elle n'est pas l'adresse de livraison : shop-expedition y affiche le point relais choisi par le client.
shop.order.main.panels: Event — un écran de travail en BAS DE LA COLONNE PRINCIPALE de la fiche commande (préparation d'expédition, par exemple) ; rendu HTML direct (écho). Le rail porte les leviers courts, la colonne porte ce qui se travaille. Args: [array $order]
shop.order.editor.fields: Event — rendu HTML direct dans le formulaire commande-creer.php (écho, pattern do_action). Args: [array $post, string $section] — $section = 'document_type'|'payment_modality' (deux points d'ancrage distincts dans le même formulaire).
shop.order.editor.save: Event — après un Orders::createManual() réussi. Args: [int $orderId, array $post] — le satellite y persiste document_type + échéancier (sa propre logique, table shop_order_installments).
shop.order.fiche.banner: Event — RÉORG FICHE COMMANDE (2026-07-23) : rendu HTML direct tout en haut de la fiche commande, AVANT la rangée de statuts (écho, pattern do_action). Args: [array $order] — bandeau devis + bouton Convertir SEUL (remplace shop.order.fiche.panels pour cette partie ; le seul cas légitime d'info avant le contenu réel de la commande).
shop.order.payment.panels: Event — RÉORG FICHE COMMANDE (2026-07-23) : rendu HTML direct À L'INTÉRIEUR de la carte Règlement du socle, entre « Moyen de paiement » et « Règlements reçus » (écho, pattern do_action). Args: [array $order] — panneau échéancier (remplace shop.order.fiche.panels pour cette partie).
shop.order.documents.actions: Event — RÉORG FICHE COMMANDE (2026-07-23) : rendu HTML direct dans la colonne de DROITE de la fiche commande (rail Statut/Informations), sous forme de boutons (écho, pattern do_action). Args: [array $order] — boutons Télécharger/Générer facture/devis/BL (remplace le panneau-section shop-documents posé sur shop.order.fiche.panels).
shop.order.creation_email: Filter — email de création avant envoi (Orders::sendConfirmationEmail()/sendMerchantNotification(), appelées par Orders::sendCreationEmails()). Args: [array $email{to,subject,body,footer_note}, array $order, string $kind] — $kind = 'customer'|'merchant'.
shop.order.fiche.status_row: Filter bool — affiche la rangée de pictos de statut sur la fiche commande ? Args: [bool, array $order] — un satellite (shop-commercial) renvoie false pour un devis (sa seule sortie = le bouton Convertir du bandeau).
shop.order.fiche.action: Filter — dispatch générique d'une action satellite postée depuis la fiche commande (commande.php, action=satellite_action, sub_action=<identifiant propre au satellite>). Args: [array $result{ok,errors,message}, string $subAction, int $orderId, array $post, int $actorId]. Zéro écouteur = flash d'erreur générique ("Action inconnue.").
shop.hub.tiles: Filter — vignettes du hub Boutique (modules/shop/admin/index.php), appliqué juste avant la bucketisation par groupe (HubDashboard::bucketize()). Args: [array $tiles]. Un satellite avec son propre écran admin (ex. shop-documents) y ajoute la sienne, avec sa clé 'group' (quotidien|gerer|reglages — défaut 'gerer' si absente/invalide). Zéro écouteur = hub inchangé.
shop.order.public.actions: Event — rendu HTML direct sur la page commande CLIENT (modules/shop/views/commande.php, prise front DATA-ONLY — aucun <style>). Args: [array $order] (Orders::findByToken()). Un satellite y échoit ses liens publics par access_token (ex. « Télécharger ma facture »).
shop.stock.decrement: Filter bool $handled — décrément de stock d'une ligne payée. Args: [bool, array $order, array $line]
shop.payment.providers: Filter — adaptateurs PaymentProvider disponibles [slug => classe]. Args: [array $providers]
shop.checkout.champs: Event — rendu HTML direct à la dernière étape du tunnel, APRÈS la livraison et AVANT le paiement, panier dématérialisé compris (écho, patron do_action). Args: [array $cart]. Le satellite y pose ses champs, les valide sur `shop.cart.validate` et les range sur `shop.order.created`.
shop.regles_vente.champs: Event — rendu HTML direct dans le formulaire de Boutique → Règles de vente, sous la section Commande (écho). Args: aucun. Les champs postés reviennent par `shop.regles_vente.save`.
shop.regles_vente.save: Filter — Boutique → Règles de vente enregistrée. Args: [array $erreurs, array $post, int $actorId]. Le satellite enregistre SES champs et ajoute ses erreurs (phrases) à la liste : non vide, l'écran les affiche.
shop.commandes.colonnes: Filter — les colonnes en plus de la liste des commandes, EN LOT pour la page. Args: [array $colonnes, array<int> $orderIds]. Rendre clé => ['label' => string, 'valeurs' => [id => texte], 'triable' => bool, 'compact' => bool (valeur courte, sur une ligne)]. Du texte, jamais du HTML.
shop.commandes.ordre: Filter — le tri de la liste par une colonne d'un satellite (?tri=<clé>). Args: [?array $ids, string $cle]. Rendre les ids dans l'ordre voulu (les autres commandes suivent), ou null pour une clé qui n'est pas la sienne.
shop.order.livraison.infos: Filter — des lignes [label, valeur] dans la carte Livraison de la fiche commande, sous la méthode. Args: [array $lignes, array $order]. Du texte, jamais du HTML.
shop.order.recap.lignes: Filter — des lignes [label, valeur] dans le récapitulatif des e-mails de commande (Orders::renderSummaryHtml). Args: [array $lignes, array $order]. Un thème qui compose son propre récapitulatif les relit par Orders::lignesRecap($order).
shop.order.anonymized: Event — une commande vient d'être anonymisée (RGPD, Orders::anonymizeForCustomer). Args: [int $orderId]. Un satellite y efface ce qu'il a rangé de personnel sur la commande.
shop.checkout.livraison.apres: Event — rendu HTML direct APRÈS le choix du mode de livraison et AVANT le paiement (écho, patron do_action). Args: [array $options, array $cart]. Là où un satellite demande une précision qui DÉPEND du mode retenu : shop-expedition y pose le choix du point relais.
shop.checkout.payment_terms: Filter — conditions de paiement AFFICHÉES au client au checkout (pas des choix : il lit « paiement à 30 jours » et choisit son moyen normalement). shop-pro y met celles de sa catégorie. Args: [array $terms, array $cart]
shop.vat.display_include_tax: Filter — le prix affiché est-il TTC (true) ou HT (false) ? Défaut = réglage du site ; shop-pro l'inverse pour une catégorie de clients. Args: [bool $includeTax, array $product, array $ctx]
shop.product.types: Filter — types de produit du sélecteur. Args: [array $types]
shop.editor.fields: Event — champs satellites dans l'éditeur produit. Args: [array $product]
shop.editor.save: Event — après save produit réussi. Args: [int $id, array $post]
shop.product.front: Filter — enrichit le DTO de la fiche FRONT (Products::front). Args: [array $dto, array $rawProduct] (shop 1.60)
shop.products.front.rows: Filter — les LIGNES brutes d'une liste front (Products::frontList), avant que les cartes soient construites. Args: [array $rows]. Un satellite y corrige des colonnes de shop_products EN UNE SEULE REQUÊTE groupée, et peut poser trois clés que la carte transmet : `promo_sur_option` (bool), `remise_max_pct` (int) et `prix_varie` (bool, les déclinaisons n'ont pas toutes le même prix effectif : le thème écrit « dès »). ⚠️ Il ne force PAS `sale_price_cents` du parent : une option en promo ne fait pas un produit soldé, et `on_sale` doit rester la vérité du produit. shop-variants y remonte le prix « à partir de » réel d'un produit variable. Doit renvoyer les mêmes lignes, dans le même ordre, sans en ajouter ni en retirer (shop 1.61)
shop.category.editor.fields: Event — champs satellites dans l'éditeur de catégorie. Args: [array $category]
shop.category.editor.save: Event — après save catégorie réussi. Args: [int $id, array $post]
shop.product.deleted: Event — produit supprimé (filet satellites). Args: [int $id]
shop.list.filters: Event — onglets de filtre liste produits. Args: []
shop.list.ids: Filter — restriction d'ids liste produits. Args: [?array $ids, array $get]
shop.list.row.badges: Filter — badges HTML d'une ligne produit (liste admin). Args: [string $html, array $product]
shop.customer.editor.fields: Event — rendu HTML direct sur la fiche client (client.php), form-section satellite autonome (écho, pattern do_action). Args: [array $client] (Customers::find()).
shop.customer.editor.fields.save: Event — après un POST client.php avec action='save_satellite_fields' (dispatch générique, MÊME patron que shop.editor.save : chaque satellite reçoit $_POST en entier et se garde via son propre champ marqueur — plusieurs satellites peuvent cohabiter sur ce même point d'accroche). Args: [int $customerId, array $post, ?int $actorId].
shop.editor.base_price_hidden_for_types: Filter array<string> — types de produit pour lesquels le champ Prix du socle doit être CACHÉ dans l'éditeur produit (patron data-type-only). Args: [array $hiddenTypes, array $product]. Défaut [].
shop.editor.type_change_warnings: Filter — avertissements précis (fragments de phrase, ex. "ses 4 variations"/"son fichier") de ce que CE produit perd en quittant son type ACTUEL, affichés dans la pop-up de confirmation de produit-editer.php AVANT tout changement réel. Args: [array $warnings, array $product{id,type}]. Défaut [] (zéro écouteur = aucune donnée type-spécifique à perdre = pas de pop-up, changement direct).
shop.editor.type_changed: Event — après un Products::save() réussi dont le type a RÉELLEMENT changé (comparé au type enregistré AVANT le POST) : chaque satellite efface UNIQUEMENT sa donnée type-spécifique devenue incompatible avec le NOUVEAU type (jamais l'universel ni les attributs, gérés indépendamment par Products::save()). Inconditionnel — fiable même en dégradation sans JS (la pop-up n'est qu'un avertissement avant coup). Args: [int $productId, string $oldType, string $newType, int $actorId].
shop.customer.category_options: Filter — options catégorie DATA-ONLY pour le filtre Catégorie + le sélecteur « changer de catégorie » (masse/création). Chaque option : [id, name, is_default, icon_svg, bg, fg]. Args: [array $options]. Défaut [].
shop.customer.list.categories: Filter — catégories de PLUSIEURS clients EN BLOC (évite le N+1 par ligne), uniquement les assignations EXPLICITES (absent = Standard implicite). Args: [array $map, array $customerIds]. Défaut []. Map : customer_id => option (même forme que ci-dessus).
shop.customer.list.ids: Filter — restriction d'ids liste clients (même patron que shop.list.ids), ex. filtre Catégorie (`?ccat=`). Args: [?array $ids, array $get]. Défaut null (pas de restriction).
shop.customer.category.bulk_assign: Event — changement de catégorie EN MASSE depuis la liste clients (sélection + bouton « Changer la catégorie »). Args: [array $customerIds, ?int $categoryId, ?int $actorId].

Ce qu'il écoute 10

emails.catalogue: priorité 10
emails.apercu: priorité 10
dashboard.blocs: priorité 10
media.usages.counts: priorité 10
media.usages: priorité 10
seo.coverage: priorité 10
seo.image_du_contenu: priorité 40
guide.boutique.prete: priorité 10
seo.items: priorité 40
admin.alerts: priorité 40

Ses prises front

Les morceaux de page que ce module fournit, et les classes qu'ils posent. Un thème les habille par ces classes : il ne recopie pas le balisage, sinon il rate les corrections des versions suivantes.

views/checkout.php 48 classes

s-shop-checkout
s-shop-checkout-actions
s-shop-checkout-adresses-enregistrees
s-shop-checkout-cgv
s-shop-checkout-champ
s-shop-checkout-compte-note
s-shop-checkout-condition
s-shop-checkout-condition-desc
s-shop-checkout-condition-label
s-shop-checkout-conditions
s-shop-checkout-confidentialite
s-shop-checkout-confirmer
s-shop-checkout-connexion-requise
s-shop-checkout-continuer
s-shop-checkout-dematerialise
s-shop-checkout-email
s-shop-checkout-error
s-shop-checkout-etape1
s-shop-checkout-etape2
s-shop-checkout-facturation-adresse
s-shop-checkout-facturation-toggle
s-shop-checkout-hp
s-shop-checkout-input
s-shop-checkout-livraison-adresse
s-shop-checkout-livraison-desc
s-shop-checkout-livraison-indisponible
s-shop-checkout-livraison-methodes
s-shop-checkout-livraison-option
s-shop-checkout-modifier
s-shop-checkout-note
s-shop-checkout-optionnel
s-shop-checkout-paiement
s-shop-checkout-paiement-echeance
s-shop-checkout-paiement-instructions
s-shop-checkout-paiement-label
s-shop-checkout-paiement-option
s-shop-checkout-paiement-picto
s-shop-checkout-produits-non-livrables
s-shop-checkout-recap-ligne
s-shop-checkout-recap-lignes
s-shop-checkout-recap-nom
s-shop-checkout-recap-prix
s-shop-checkout-recap-qty
s-shop-checkout-recap-sous-total
s-shop-checkout-recap-taxes
s-shop-checkout-recap-total-du
s-shop-checkout-textarea
s-shop-checkout-vide

views/commande.php 43 classes

s-shop-commande
s-shop-commande-adresse-livraison
s-shop-commande-adresse-titre
s-shop-commande-attente-paiement
s-shop-commande-carte-cadeau-notice
s-shop-commande-detail
s-shop-commande-echeance
s-shop-commande-echeance-label
s-shop-commande-echeance-montant
s-shop-commande-echeance-statut
s-shop-commande-echeancier
s-shop-commande-introuvable
s-shop-commande-ligne
s-shop-commande-ligne-labels
s-shop-commande-ligne-nom
s-shop-commande-ligne-prix
s-shop-commande-ligne-qty
s-shop-commande-lignes
s-shop-commande-livraison
s-shop-commande-message-vendeur
s-shop-commande-message-vendeur-texte
s-shop-commande-message-vendeur-titre
s-shop-commande-numero
s-shop-commande-paiement-consignes
s-shop-commande-paiement-flash
s-shop-commande-paiement-instructions
s-shop-commande-paiement-moyen
s-shop-commande-payer
s-shop-commande-payer-submit
s-shop-commande-promo-notice
s-shop-commande-remise
s-shop-commande-statut
s-shop-commande-suivi
s-shop-commande-suivi-contenu
s-shop-commande-suivi-lien
s-shop-commande-suivi-num
s-shop-commande-suivi-transporteur
s-shop-commande-suivis
s-shop-commande-suivis-liste
s-shop-commande-suivis-titre
s-shop-commande-total
s-shop-commande-tva
s-shop-ligne-variante

views/compte.php 102 classes

s-shop-abonnement-echeance
s-shop-abonnement-fichier
s-shop-abonnement-fichier-lien
s-shop-abonnement-fichier-nom
s-shop-abonnement-fichiers
s-shop-abonnement-nom
s-shop-abonnement-prix
s-shop-abonnement-resilier
s-shop-abonnement-resilier-submit
s-shop-abonnement-statut
s-shop-adresse-carte
s-shop-adresse-champ
s-shop-adresse-contact
s-shop-adresse-contact-herite
s-shop-adresse-defaut
s-shop-adresse-defaut-livraison
s-shop-adresse-email
s-shop-adresse-etat
s-shop-adresse-facturation
s-shop-adresse-facturation-definir
s-shop-adresse-facturation-retirer
s-shop-adresse-form
s-shop-adresse-input
s-shop-adresse-label
s-shop-adresse-localite
s-shop-adresse-modifier
s-shop-adresse-nom
s-shop-adresse-nouvelle
s-shop-adresse-rue
s-shop-adresse-societe
s-shop-adresse-submit
s-shop-adresse-supprimer
s-shop-adresse-supprimer-submit
s-shop-adresse-titre
s-shop-adresse-type
s-shop-compte
s-shop-compte-abonnement
s-shop-compte-abonnements
s-shop-compte-abonnements-liste
s-shop-compte-abonnements-titre
s-shop-compte-adresse
s-shop-compte-adresses
s-shop-compte-adresses-note
s-shop-compte-commande
s-shop-compte-commande-date
s-shop-compte-commande-lien
s-shop-compte-commande-numero
s-shop-compte-commande-statut
s-shop-compte-commande-total
s-shop-compte-commandes
s-shop-compte-commandes-liste
s-shop-compte-commandes-titre
s-shop-compte-commandes-vide
s-shop-compte-deconnexion
s-shop-compte-deconnexion-submit
s-shop-compte-error
s-shop-compte-infos
s-shop-compte-infos-aide
s-shop-compte-infos-champ
s-shop-compte-infos-email-form
s-shop-compte-infos-form
s-shop-compte-infos-input
s-shop-compte-infos-submit
s-shop-compte-infos-titre
s-shop-compte-licences
s-shop-compte-licences-titre
s-shop-compte-mdp
s-shop-compte-mdp-champ
s-shop-compte-mdp-form
s-shop-compte-mdp-input
s-shop-compte-mdp-optionnel
s-shop-compte-mdp-submit
s-shop-compte-mdp-titre
s-shop-compte-requiert-connexion
s-shop-compte-success
s-shop-connexion-optionnel
s-shop-licence
s-shop-licence-code
s-shop-licence-copier
s-shop-licence-echeance
s-shop-licence-etat
s-shop-licence-generer
s-shop-licence-generer-submit
s-shop-licence-label
s-shop-licence-label-input
s-shop-licence-regenerer
s-shop-licence-regenerer-submit
s-shop-licence-reset
s-shop-licence-reset-submit
s-shop-licence-site
s-shop-licences-echeance
s-shop-licences-libres
s-shop-licences-liste
s-shop-licences-offre
s-shop-licences-plan
s-shop-licences-quota
s-shop-licences-total
s-shop-licences-utilisees
s-shop-password-eye
s-shop-password-generer
s-shop-password-regles
s-shop-password-wrap

views/connexion.php 28 classes

s-shop-connexion
s-shop-connexion-champ
s-shop-connexion-code
s-shop-connexion-code-champ
s-shop-connexion-code-form
s-shop-connexion-code-intro
s-shop-connexion-code-renvoyer
s-shop-connexion-code-renvoyer-btn
s-shop-connexion-deja
s-shop-connexion-email
s-shop-connexion-error
s-shop-connexion-hp
s-shop-connexion-input
s-shop-connexion-inscription
s-shop-connexion-login
s-shop-connexion-nom
s-shop-connexion-optionnel
s-shop-connexion-oubli
s-shop-connexion-password
s-shop-connexion-password-confirm
s-shop-connexion-prenom
s-shop-connexion-submit
s-shop-connexion-success
s-shop-connexion-telephone
s-shop-password-eye
s-shop-password-generer
s-shop-password-regles
s-shop-password-wrap

views/panier.php 24 classes

s-shop-ligne-variante
s-shop-panier
s-shop-panier-actions
s-shop-panier-checkout
s-shop-panier-error
s-shop-panier-image
s-shop-panier-label
s-shop-panier-labels
s-shop-panier-ligne
s-shop-panier-lignes
s-shop-panier-nom
s-shop-panier-option
s-shop-panier-options
s-shop-panier-qty
s-shop-panier-qty-input
s-shop-panier-qty-submit
s-shop-panier-retirer
s-shop-panier-retirer-submit
s-shop-panier-success
s-shop-panier-total
s-shop-panier-total-ligne
s-shop-panier-vide
s-shop-panier-vider
s-shop-panier-vider-submit

views/pays.php 8 classes

s-pays
s-pays-choix
s-pays-nom
s-pays-option
s-pays-option<?=
s-pays-radio
s-pays-titre
s-pays-valider

views/produit.php 61 classes

s-shop-abo
s-shop-abo-champ
s-shop-abo-champ-case
s-shop-abo-champ-choix
s-shop-abo-champ-option
s-shop-abo-champ-texte
s-shop-abo-plan
s-shop-abo-plan-essai
s-shop-abo-plan-nom
s-shop-abo-plan-prix
s-shop-abo-plan-radio
s-shop-abo-plans
s-shop-abo-plans-titre
s-shop-attribut
s-shop-attribut-nom
s-shop-attribut-valeurs
s-shop-badge
s-shop-badge-favori
s-shop-badge-promo
s-shop-badge-rupture
s-shop-badge-stock
s-shop-categorie-item
s-shop-etiquette
s-shop-produit-achat
s-shop-produit-ajouter
s-shop-produit-ajouter-qty
s-shop-produit-ajouter-qty-label
s-shop-produit-ajouter-submit
s-shop-produit-attributs
s-shop-produit-badges
s-shop-produit-categorie
s-shop-produit-categories
s-shop-produit-champ-libre
s-shop-produit-desc
s-shop-produit-detail
s-shop-produit-etiquettes
s-shop-produit-excerpt
s-shop-produit-fiche
s-shop-produit-galerie
s-shop-produit-image
s-shop-produit-image-avant
s-shop-produit-images
s-shop-produit-input
s-shop-produit-nom
s-shop-produit-non-commandable
s-shop-produit-prix
s-shop-produit-prix-barre
s-shop-produit-prix-mention
s-shop-produit-supplement
s-shop-produit-variantes
s-shop-variante-axe
s-shop-variante-axe-nom
s-shop-variante-description
s-shop-variante-epuise
s-shop-variante-item
s-shop-variante-part
s-shop-variante-radio
s-shop-variante-statut
s-shop-variante-valeur
s-shop-variante-valeur-libelle
s-shop-variantes-catalogue

views/produits.php 23 classes

s-shop-badge
s-shop-badge-favori
s-shop-badge-promo
s-shop-badge-rupture
s-shop-cat-image
s-shop-categorie
s-shop-categorie-'
s-shop-categorie-<slug>
s-shop-categorie-desc
s-shop-categorie-titre
s-shop-categorie<?=
s-shop-produit
s-shop-produit-ajouter
s-shop-produit-ajouter-submit
s-shop-produit-badges
s-shop-produit-excerpt
s-shop-produit-image
s-shop-produit-nom
s-shop-produit-prix
s-shop-produit-prix-barre
s-shop-produit-prix-mention
s-shop-produits
s-shop-produits-liste

Ses données

Les tables que ce module crée. Désactiver un module ne les efface pas : ses données restent en base et reviennent s'il est réactivé.

Les tables 39

shop_addresses
shop_attribute_values
shop_attributes
shop_carriers
shop_cart_items
shop_carts
shop_category_images
shop_category_shipping
shop_category_vat
shop_customer_tokens
shop_customers
shop_order_installments
shop_order_items
shop_order_statuses
shop_order_tracking
shop_orders
shop_orders_counters
shop_payment_methods
shop_payment_providers
shop_payments
shop_product_attributes
shop_product_categories
shop_product_images
shop_product_tags
shop_products
shop_shipping_bloc_categories
shop_shipping_bloc_classes
shop_shipping_bloc_products
shop_shipping_bloc_rates
shop_shipping_blocs
shop_shipping_classes
shop_shipping_methods
shop_shipping_rates
shop_shipping_types
shop_shipping_zone_rules
shop_shipping_zones
shop_status_icons
shop_tags
shop_tax_rates