Aller au contenu principal
Sur cette page▾

Le plug-in connecte le configurateur à une boutique WooCommerce. Il est en accès anticipé : il n’est pas dans le répertoire de plug-ins WordPress, il n’a pas de prix affiché, et il n’a pas encore été exécuté de bout en bout contre un WordPress et un WooCommerce réels dans notre environnement de test ; essayez-le donc d’abord sur une boutique de préproduction.

Ce qu’il fait

  • Ajoute un bouton Order cut to size (vous pouvez en changer le libellé) aux fiches produit que vous choisissez.
  • Ouvre le configurateur en fenêtre contextuelle, en panneau latéral ou dans la page, avec le panneau du produit déjà sélectionné.
  • Place le résultat dans le panier WooCommerce sous la forme d’une seule ligne, tarifée à partir du devis vérifié.
  • Conserve l’identifiant de commande CutOptim et le hachage du devis sur la ligne de commande, et affiche sur la commande un court récapitulatif lisible « Cut to size ».
  • Reçoit les webhooks signés de CutOptim et ajoute une note à la commande WooCommerce.

Installation et configuration

Prérequis : WordPress 6.0 ou ultérieur, PHP 7.4 ou ultérieur, et WooCommerce.

  1. Installez et activez WooCommerce, puis le plug-in.
  2. Ouvrez WooCommerce > CutOptim Configurator et saisissez l’identifiant du tenant, la clé publiable et la clé secrète. La clé secrète peut aussi être définie dans wp-config.php sous le nom CUTOPTIM_API_SECRET. Les clés proviennent de la console ; la clé publiable ne fonctionne que sur les adresses web que vous y avez listées pour elle.
  3. Choisissez comment le configurateur s’ouvre, le libellé du bouton, et les catégories de produits qui reçoivent le bouton (aucune sélection signifie tous les produits associés).
  4. Associez les produits aux panneaux (voir ci-dessous).
  5. Pour les notes de commande, saisissez le secret du webhook dans le plug-in et ajoutez à votre configuration l’adresse de webhook indiquée par la page de réglages (voir les commandes). Plusieurs secrets, un par ligne, sont autorisés afin de pouvoir faire tourner un secret.

Associer un produit à un panneau

Le bouton n’apparaît que sur un produit qui représente un panneau de votre catalogue CutOptim. Le plug-in résout le panneau dans cet ordre :

  1. les champs CutOptim board et CutOptim thickness (mm) propres au produit dans les données du produit ;
  2. une règle SKU to board dans les réglages, une par ligne, par exemple MDF-18 = MDF raw | 18 ou PLY-* = Birch plywood ; un SKU exact l’emporte sur un préfixe, et une ligne commençant par # est un commentaire ;
  3. les attributs de produit cutoptim_material et cutoptim_thickness.

Un nom de panneau contenant du balisage ou une épaisseur hors de la plage 0 à 200 mm est écarté, pas corrigé. Lorsqu’un panneau est associé, le configurateur s’ouvre sur la liste de coupe.

Comment le prix arrive dans le panier

Le configurateur dans le navigateur signale la commande, mais un chiffre venant du navigateur n’est jamais cru. La seule voie du plug-in vers le panier est une route REST sur votre propre serveur. Cette route :

  1. envoie le devis signé à CutOptim pour vérification avec votre clé secrète, et refuse s’il n’est pas valide ;
  2. contrôle que le devis correspond aux lignes que le client a vues ;
  3. contrôle la devise par rapport à celle de la boutique, et refuse en cas de différence ;
  4. ajoute une ligne de panier tarifée à partir des totaux vérifiés, TTC ou HT selon le réglage de taxe de votre boutique.

Si quoi que ce soit échoue, rien n’est ajouté et le client est invité à réessayer. Au paiement, l’identifiant de commande CutOptim et le hachage du devis sont copiés sur la ligne de commande. Une confirmation par webhook n’est prise en compte que si son hachage de plan correspond à celui stocké sur la ligne.

Les contrôles et les appels d’API qui les sous-tendent figurent dans la référence de l’API du configurateur.

Limites

  • Accès anticipé. Absent du répertoire WordPress ; essayez-le d’abord en préproduction.
  • Devise. La devise de la boutique et celle de la configuration CutOptim doivent être identiques.
  • Langue. Les textes propres au plug-in (réglages et messages) sont en anglais ; le widget du configurateur lui-même est disponible en dix langues.
  • Paiement. Le paiement, le stock, la taxe et la livraison relèvent de WooCommerce.
  • Notes de commande. Le plug-in accepte les événements de statut de commande ; le service n’envoie un événement de statut que lorsque vous changez le statut d’une commande dans la console.

FAQ

Que fait le plug-in WooCommerce ?
Il ajoute un bouton Order cut to size aux produits que vous choisissez. Le client saisit ses pièces, voit le plan de coupe et un prix issu de vos règles, et le résultat entre dans le panier WooCommerce sous la forme d’une seule ligne. Le panier, le paiement, le stock, la taxe et la livraison restent dans WooCommerce ; CutOptim n’encaisse aucun paiement.
Un client peut-il modifier le prix depuis la console du navigateur ?
Non. Le plug-in n’a qu’une seule voie d’entrée dans le panier, une route sur votre propre serveur. Cette route demande à CutOptim de vérifier le devis signé avec votre clé secrète, contrôle que le devis correspond aux lignes que le client a vues, et n’ajoute qu’ensuite une ligne de panier tarifée à partir des totaux vérifiés. Un prix envoyé par le navigateur n’est jamais utilisé.
Est-il disponible dans le répertoire de plug-ins WordPress ?
Pas encore. Il est en accès anticipé. Il n’est pas encore distribué publiquement ; pour l’essayer, contactez-nous via la page de contact. Le test de bout en bout du plug-in avec WordPress et WooCommerce n’a pas encore été exécuté : considérez-le comme une version à essayer d’abord dans une boutique de préproduction.
Comment indiquer au plug-in quel produit correspond à quel panneau ?
De trois façons, vérifiées dans cet ordre : les champs CutOptim board et CutOptim thickness (mm) propres au produit dans les données du produit, une règle de SKU dans les réglages du plug-in, comme MDF-18 = MDF raw | 18 ou une règle de préfixe comme PLY-* = Birch plywood, et les attributs de produit cutoptim_material et cutoptim_thickness. Un produit sans panneau résolu n’a pas de bouton.
Pourquoi mon article n’a-t-il pas été ajouté au panier ?
Le prix n’a pas pu être confirmé. Causes fréquentes : la devise de la boutique diffère de celle de votre configuration CutOptim (il n’y a pas de conversion), la clé secrète ou l’identifiant du tenant est erroné, ou le devis a expiré. Le client voit un message et peut réessayer.
Prend-il en charge d’autres plateformes de boutique, comme Shopify ?
Non. WooCommerce est le seul plug-in de plateforme. Pour toute autre boutique, votre développeur applique les étapes documentées de vérification et de webhook avec le code de référence, décrites sur la page des plateformes sur mesure.

Mis à jour: 19 octobre 2026