Le plugin Shopify connecte votre configurateur configento.app directement à vos pages produits Shopify. Les acheteurs configurent, voient le prix se mettre à jour en temps réel et finalisent leur achat via le checkout natif Shopify — sans quitter votre boutique.
Prérequis
- Boutique Shopify utilisant un thème Online Store 2.0 (p. ex. Dawn, Sense, Refresh, Origin ou thèmes premium actuels). Les thèmes legacy sans templates JSON ne sont pas pris en charge.
- Compte configento.app actif
- Au moins un composant configurateur dans le backend configento.app (
admin.configento.app)
Shopify Plus n'est pas nécessaire — le plugin fonctionne sur tous les plans Shopify.
Installation
- Rechercher « Configento Configurator » dans le Shopify App Store.
- Cliquer sur Ajouter l'application.
- Confirmer l'écran des autorisations.
- Shopify vous redirige automatiquement vers l'Admin Intégré du plugin.
Configuration initiale
Après l'installation, l'Admin Intégré s'ouvre directement dans votre backend Shopify.
Étape 1 — Relier votre compte configento.app
- Se connecter au Portail de service (
service.configento.app). - Cliquer sur « Créer une connexion Shopify » → configento.app génère un code d'onboarding à 6 chiffres (valable 15 minutes).
- Saisir le code dans l'Admin Intégré Shopify → Connecter.
- Le statut passe à « Connecté à : \<votre compte> ».
Note : La connexion est 1-pour-1 (une boutique Shopify ↔ un compte configento.app). Pour relier la boutique à un autre compte, désinstaller et réinstaller l'application.
Étape 2 — Relier un produit à un composant configurateur
Dans l'Admin Intégré → onglet « Produits » :
- La liste de tous les produits Shopify avec leur assignation configurateur actuelle s'affiche.
- Par produit : sélectionner un composant configento.app dans le menu déroulant.
- La sélection est immédiatement enregistrée comme métachamp sur le produit.
Alternative : Le métachamp peut aussi être défini directement dans l'Admin Shopify : ouvrir un produit → Métachamps → Espace de noms configento, Clé component_id, Type single_line_text_field, Valeur = ID du composant (numérique, p. ex. 10244).
Étape 3 — Placer le bloc d'application thème
Le bloc configurateur doit être activé une fois par thème :
- Dans l'Admin Intégré, cliquer sur « Ajouter le bloc thème ».
- Shopify ouvre l'éditeur de thème et ajoute automatiquement le bloc Configento au template de la page produit.
- Important : Glisser-déposer le bloc entre la description du produit et l'élément de prix.
- Enregistrer.
Paramètres du bloc dans l'éditeur de thème :
| Paramètre | Par défaut | Description |
|---|---|---|
| URL du backend Configento | https://admin.configento.app |
Ne modifier que si justSelling indique explicitement un autre hôte |
| Sélecteur CSS du prix thème | vide | La détection automatique fonctionne pour la plupart des thèmes |
| Placer automatiquement le configurateur au-dessus du prix | activé | Déplace le bloc avant l'élément de prix au chargement |
| Afficher le résumé de la configuration | désactivé | Affiche un résumé textuel sous le configurateur |
| Texte de chargement | vide | Sélection automatique de la langue (DE/EN/ES/FR) |
Ce qui se passe lors de l'achat
- L'acheteur ouvre la page produit — le configurateur se charge automatiquement.
- L'acheteur fait ses sélections — le prix se met à jour en temps réel.
- L'acheteur clique sur « Ajouter au panier » — la configuration est sauvegardée et les attributs choisis apparaissent dans le panier.
- Le checkout s'effectue via le checkout natif Shopify — tous les moyens de paiement, codes de réduction et fonctionnalités Shopify restent disponibles.
Support multilingue
Le plugin prend en charge l'allemand, l'anglais, l'espagnol et le français. Le configurateur suit automatiquement la langue de la boutique Shopify. Les autres langues utilisent l'anglais par défaut.
Modifier une configuration sauvegardée
Le plugin active automatiquement un lien « Modifier » sur la page panier. Les acheteurs peuvent revenir à la page produit et ajuster leur configuration — tant que le checkout n'a pas été finalisé. Ce comportement peut être désactivé dans l'éditeur de thème sous « Intégrations d'applications ».
Résolution des problèmes
Le configurateur ne s'affiche pas :
| Symptôme | Cause | Solution |
|---|---|---|
| Zone complètement vide | Bloc d'application thème non activé | Admin Intégré → « Ajouter le bloc thème » |
| Texte de chargement permanent | ID de composant manquant ou invalide | Admin Intégré → « Produits » → assigner un composant |
| Message d'erreur après 8 secondes | Cloud configento.app inaccessible | Vérifier status.configento.app |
Prix incorrect dans le panier :
| Symptôme | Cause | Solution |
|---|---|---|
| Pas de supplément dans le panier | Cart Transform Function inactive | Rouvrir l'Admin Intégré |
| Différence de prix entre la page produit et le panier | Pont devise/taxe mal configuré | Vérifier l'onglet Tarification dans l'Admin Intégré |
La connexion échoue :
| Symptôme | Cause | Solution |
|---|---|---|
| « Code invalide ou expiré » | Code de plus de 15 minutes | Générer un nouveau code dans le Portail de service |
| « Boutique déjà connectée » | Connexion existante avec un autre compte | Désinstaller et réinstaller l'application |