Nalu

WooCommerce embarque une API REST publique, la Store API. Elle fait partie du coeur depuis 2021, ajoutée pour le panier en blocs, et elle répond sur les produits, les catégories, les attributs et les stocks sans aucune authentification. Nalu la lit au moment du build, depuis un serveur, sur /wp-json/wc/store/v1/products, et transforme la réponse en HTML statique.

C'est toute l'intégration. Aucune extension à installer sur WordPress, aucune clé d'API à émettre, aucun GraphQL à ajouter, aucune permission à accorder. Si vous cherchez le champ où coller la clé, il n'existe pas. La seule valeur que le thème demande est WOO_STORE_URL, l'adresse que vous tapez déjà dans un navigateur. La Store API v1 arrive avec WooCommerce 5.9 : toute boutique encore mise à jour est prête.

Le build lit le catalogue page par page : WordPress plafonne une requête à cent produits et en renvoie cent au lieu d'une erreur. Les catégories deviennent les rayons, les attributs de produit deviennent les filtres, et le point d'entrée collection-data fournit la fourchette de prix et les comptages de stock des filtres. Un produit variable garde ses options, et la combinaison choisie porte son identifiant de variation.

Le panier vit dans le navigateur et n'appelle jamais la Store API pour ajouter, retirer ou compter une ligne. Au paiement, il repasse ses lignes à WooCommerce en une seule adresse, et WooCommerce reconstruit le panier puis recalcule la TVA, la livraison et les totaux. Un fichier facultatif, déposé dans wp-content/mu-plugins, autorise ce passage de relais ; sans lui le catalogue se construit et se référence quand même.

Laissez WOO_STORE_URL vide et Nalu sert son catalogue de démonstration hors ligne : huit produits sur quatre rayons, qui exercent les quatre types de produits WooCommerce. C'est l'état du zip à l'ouverture : on décompresse et on lance. Quand la boutique existe, pnpm woo:check la lit en Node simple et dit si le catalogue est lisible. Mettez une adresse injoignable et le build s'arrête au lieu de servir la démonstration en silence : un vrai site sur un catalogue fictif est pire que rien.

Le catalogue est figé au moment du build. Publiez un produit dans WooCommerce et il n'est sur la vitrine qu'après une reconstruction ; c'est vrai aussi d'un prix ou d'un état de stock. C'est le prix du HTML statique, et une page qui n'énumère que des avantages ne se lit pas.

La réponse est une reconstruction que personne n'a à déclencher : un crochet de déploiement chez votre hébergeur, appelé par un webhook WooCommerce quand un produit change, ou programmée. Nalu ne fournit ni l'un ni l'autre : les deux appartiennent à l'hébergeur, pas à un thème. Le stock est le point à peser le plus sérieusement : une boutique qui se vide en quelques minutes veut un intervalle court. Les prix sont la partie tranquille, WooCommerce recalcule chaque total au paiement.