Avec le module PrestaShop, votre configurateur configento.app s'affiche directement sur la fiche produit de votre boutique PrestaShop. Vos clients composent le produit, voient immédiatement le prix total et ajoutent la configuration terminée au panier habituel. La commande, la taxe et la livraison passent ensuite normalement par PrestaShop. Vous modifiez vos composants dans l'administration intégrée, sans quitter le back-office.
Prérequis
- PrestaShop 8.1, 8.2 ou 9. Les versions plus anciennes ne peuvent pas installer le module. La nomenclature à la commande n'existe que sous PrestaShop 9.
- Les URL simplifiées (Friendly URLs) doivent être activées dans votre boutique. C'est seulement à cette condition que le module peut se connecter à configento.app – voir Dépannage.
- Un accès au back-office PrestaShop avec le droit d'installer des modules
- Un identifiant pour le portail de service pour le service auquel vous souhaitez connecter la boutique
- Au moins un composant publié – les brouillons non publiés ne peuvent pas être sélectionnés dans la boutique
Quel moteur frontend s'exécute
Le module PrestaShop charge toujours le moteur V3. Le paramètre Moteur frontend du composant ne joue ici aucun rôle. Les fonctions qui n'existent que dans Legacy – comme l'accordéon, l'autocomplétion ou la quantité prédéfinie – ne sont donc pas disponibles dans PrestaShop. Vous trouverez la vue d'ensemble sous Moteur frontend : Legacy ou V3.
Télécharger le module
Vous obtenez le module dans configento.app sous Paramètres → Intégrations, carte PrestaShop 8.1 / 9, bouton Télécharger le module. Un seul fichier pour toutes les versions prises en charge. Vous recevez un fichier ZIP – ne le décompressez pas.
Si l'onglet est verrouillé, acceptez d'abord le contrat de traitement des données sous Paramètres → Traitement des données.
Installer le module
Dans le back-office
- Ouvrez le gestionnaire de modules de votre back-office PrestaShop et téléversez le fichier ZIP du module. Ne le décompressez pas auparavant.
- Installez le module configento.app.
Lors de l'installation, le module ajoute son propre élément de menu configento.app dans la rubrique Catalogue.
En ligne de commande
Si vous avez accès à la ligne de commande, copiez le dossier décompressé configento dans le répertoire modules/ de votre boutique et exécutez dans le répertoire de la boutique :
php bin/console prestashop:module install configentoLe nom technique du module est configento. Veillez ensuite à ce que le dossier appartienne à l'utilisateur du serveur web.
Mettre à jour
Téléversez une nouvelle version de la même façon que la première. PrestaShop reconnaît le module installé et effectue la mise à jour ; la connexion, les associations et les réglages sont conservés.
Se connecter à configento.app
Vous établissez la connexion une seule fois depuis le back-office. Vous n'avez pas besoin de copier de jeton.
- Ouvrez Catalogue → configento.app.
- Vous voyez la carte Se connecter à configento.app. Cliquez sur Connecter.
- Vous êtes redirigé vers le portail de service. Connectez-vous et confirmez la connexion.
- Vous revenez ensuite dans le back-office, et l'administration de configento.app s'ouvre directement dans la page.
Si les URL simplifiées sont désactivées, un message au-dessus de la carte indique où les activer.
Lors de la connexion, le module met en place tout ce dont la fiche produit a besoin : il récupère les identifiants de votre boutique et signale les domaines de votre boutique à configento.app (voir Autoriser le domaine de la boutique).
Chaque utilisateur du back-office se connecte individuellement. La connexion vaut pour le compte utilisateur qui l'a établie, pas pour toute la boutique. Si un collègue travaille avec son propre identifiant, il verra à nouveau la carte Se connecter à configento.app la première fois qu'il ouvrira Catalogue → configento.app.
Au-dessus de l'administration intégrée figurent l'adresse e-mail de votre identifiant du portail et le bouton Déconnecter.
Modifier les composants dans le back-office
Une fois connecté, Catalogue → configento.app ouvre l'administration de configento.app directement dans le back-office. Vous y créez des composants, gérez caractéristiques, valeurs, prix et règles et les publiez – exactement comme sous admin.configento.app. Les bases sont décrites dans Créer votre premier composant.
Si la page reste ouverte longtemps, la session de l'administration intégrée finit par expirer. Le module la renouvelle alors en arrière-plan ; vous n'avez pas besoin de recharger la page.
Autoriser le domaine de la boutique
Le configurateur ne se charge que sur les domaines autorisés pour votre service. Le module signale les domaines de votre boutique, mais ne les autorise pas lui-même :
- Dans l'administration de configento.app, ouvrez Paramètres → Domaines.
- La section Signalés par les boutiques connectées liste les domaines signalés de votre boutique PrestaShop.
- Choisissez le type, par exemple Production, puis cliquez sur Ajouter à la licence.
Les adresses de boutique actives sont signalées, y compris les autres boutiques d'un multiboutique – lors de la connexion et chaque fois que vous ajoutez ou modifiez une URL de boutique dans PrestaShop. Il ne vous reste alors qu'à ajouter le nouveau domaine à la licence. Pour en savoir plus : Paramètres globaux.
Associer un produit à un composant
- Ouvrez le produit dans le back-office.
- Le module ajoute la section configento.app au produit.
- Sous Composant, sélectionnez le composant dans la liste. Le champ de recherche au-dessus vous permet de le trouver par titre ou par ID. La liste affiche les composants publiés de votre service connecté.
- Enregistrez le produit.
Un produit a exactement un composant. Pour le dissocier, choisissez — non lié — et enregistrez.
Si la liste ne peut pas être chargée – par exemple parce que votre compte utilisateur n'est pas encore connecté –, la section affiche à la place un simple champ. Saisissez-y l'ID du composant, tel qu'il figure sur sa vignette dans la vue d'ensemble des composants.
Dans un multiboutique, l'association vaut pour la boutique dans laquelle vous modifiez actuellement le produit.
Réglages du module
Dans le gestionnaire de modules, Configurer sur le module configento.app ouvre ses réglages. Dans la section Panier et commande :
| Réglage | Effet | Par défaut |
|---|---|---|
| Refuser les configurations à 0 | Une configuration qui coûte 0 ou moins ne va pas dans le panier. Cela protège contre une règle erronée du configurateur et contre les requêtes manipulées. Le client voit « Cette configuration ne peut pas être ajoutée au panier. » | activé |
| Ajouter la référence à la ligne de commande | Le numéro d'article que configento.app construit à partir des valeurs choisies est ajouté à la référence de la ligne de commande – BANNER devient par exemple BANNER-PVC-OEILLETS. Ainsi, la commande, la facture et les exports vers l'ERP désignent exactement ce qui a été configuré. |
activé |
Dans la section Nomenclature, vous activez la nomenclature à la commande. Sous PrestaShop 8, l'interrupteur est verrouillé et porte la mention Nécessite PrestaShop 9.
Dans un multiboutique, les réglages valent pour la boutique sélectionnée en haut du back-office.
Ce qui se passe dans la boutique
Sur la fiche produit
- Le configurateur apparaît juste sous le prix, au-dessus de la zone d'achat.
- Prix : Le prix affiché est celui du produit plus le supplément de la configuration. Le prix dans la zone d'achat de votre thème suit chaque sélection. Le calcul utilise le taux de taxe que PrestaShop applique à ce produit.
- TTC ou HT : Le configurateur affiche les prix comme votre boutique. Si le groupe de clients du visiteur voit les prix hors taxes – par exemple un groupe B2B – ou si les taxes sont désactivées dans la boutique, les suppléments sont eux aussi HT, et PrestaShop ajoute lui-même la taxe, comme pour le prix du produit. Sinon, le configurateur calcule TTC avec le taux de taxe du produit. Ainsi, un même composant fonctionne dans des boutiques aux réglages de taxes très différents.
- Devise : Si votre boutique propose plusieurs devises, le configurateur affiche le prix total et les suppléments des différentes valeurs dans la devise du visiteur. La conversion utilise les taux de votre boutique. La devise dans laquelle le composant tient ses prix doit pour cela être créée dans votre boutique.
- Déclinaison : Si le client choisit une autre déclinaison, par exemple une autre taille, le configurateur continue avec son prix comme prix de base et avec ses attributs. C'est la déclinaison choisie qui va dans le panier.
- Image du produit : Si votre composant génère une image de produit combinée, elle apparaît comme première image distincte dans la galerie d'images de votre thème, avec sa propre miniature. Vos clients peuvent passer de vos photos à la configuration ; dès qu'ils modifient quelque chose, l'affichage revient sur la configuration. Les thèmes sans galerie d'images affichent l'image à la place de la photo du produit.
- Quantité : Si le client modifie la quantité, la configuration est conservée.
Contenus de pages CMS
Les textes que vous voulez gérer à un seul endroit – par exemple des informations de livraison ou de montage – se créent dans PrestaShop sous forme de page CMS et s'insèrent dans les textes de votre composant avec l'espace réservé $content[…]. Entre crochets figure l'identifiant de la page :
- son URL simplifiée, par exemple
$content[livraison] - ou son ID, par exemple
$content[4]
Le configurateur affiche le contenu de la page dans la langue du visiteur. Seules les pages actives de la boutique courante comptent ; si aucune page ne correspond, l'emplacement reste vide. Le module demande à configento.app quels espaces réservés un composant utilise et garde la réponse en mémoire dix minutes. Un identifiant nouvellement inséré apparaît donc dans la boutique au plus tard après dix minutes – ou tout de suite si vous videz le cache de PrestaShop. Les modifications du texte de la page CMS elle-même sont visibles immédiatement.
Ajouter au panier
Le bouton Ajouter au panier de votre thème ajoute la configuration au panier, et non le produit seul. Auparavant, le configurateur vérifie les champs obligatoires et va à la première caractéristique manquante.
configento.app recalcule le prix sur le serveur au moment de l'ajout. Ce qui est affiché dans le navigateur ne peut donc pas arriver manipulé dans le panier. L'article va ensuite directement dans le panier.
Panier, commande et paiement
- La ligne affiche deux indications : Configuration avec le récapitulatif de la sélection et Aperçu avec l'image de produit combinée.
- Le panier, le tunnel de commande, la confirmation de commande et la commande affichent l'image combinée au lieu de la photo du catalogue. Les invités sans compte client la voient également via la référence de commande.
- Le supplément est inclus dans le prix de la ligne. PrestaShop calcule la taxe comme d'habitude.
Modifier la configuration
Chaque ligne configurée du panier comporte le lien Modifier la configuration. Il ramène à la fiche produit, et le configurateur affiche la sélection enregistrée. Lorsque le client ajoute la configuration modifiée au panier, elle remplace l'ancienne ligne.
Listes de produits
Dans les listes de catégories et de recherche, PrestaShop masque le bouton d'achat direct pour les produits configurables, afin que personne n'ajoute le produit au panier sans configuration. Le bouton vers la fiche produit s'y appelle Configurer maintenant.
Liste d'envies
Les configurations ne peuvent pas être ajoutées à la liste d'envies. La liste d'envies de PrestaShop ne retient que le produit, pas la sélection faite dans le configurateur.
Données produit dans les formules
Les caractéristiques du type de données Attribut de produit lisent des valeurs du produit PrestaShop, afin qu'une formule puisse calculer par exemple avec la largeur, le poids ou la taille. Comme code, saisissez dans la caractéristique :
| Source | Code | Exemple |
|---|---|---|
| Champ du produit | Nom du champ dans PrestaShop | weight, width, height, depth, reference, ean13, price, manufacturer_name |
| Caractéristique (feature) du produit | Nom de la caractéristique | Matière |
| Attribut de la déclinaison choisie | Nom du groupe d'attributs | Taille renvoie p. ex. XL |
Si un code existe plusieurs fois, la source située plus haut dans le tableau l'emporte. Les noms des caractéristiques et des groupes d'attributs s'appliquent dans la langue du visiteur – dans une boutique multilingue, donnez-leur le même nom dans toutes les langues, sinon la caractéristique reste vide dans les autres langues.
Lorsque le client change de déclinaison, les caractéristiques reçoivent les valeurs de la nouvelle déclinaison. La vérification du prix lors de l'ajout au panier calcule avec les mêmes valeurs. Le module ne transmet jamais le prix d'achat, les données fournisseur, l'emplacement en stock ni les descriptions, car les valeurs figurent dans le code source de la fiche produit. Pour en savoir plus sur ce type de données : Caractéristiques de calcul.
Commandes dans le back-office
Sur la page de commande du back-office, le module affiche la carte Configurations (configento.app). Pour chaque ligne configurée, vous voyez :
- le produit et la quantité, le composant et le Supplément vérifié – le prix confirmé par configento.app lors de l'ajout
- toutes les caractéristiques avec leur valeur, y compris celles que le client n'a pas vues, comme des calculs masqués. Elles portent la mention non visible pour le client.
- l'image de produit combinée, si le composant en génère une
- Fichiers envoyés : tout ce que le client a téléversé dans le configurateur, prêt à télécharger
- le bouton Télécharger la configuration (JSON) avec la configuration complète sous forme de fichier, par exemple pour la fabrication
Les fichiers envoyés restent dans la boutique. À la première ouverture de la commande, le module les copie de configento.app dans votre boutique (dossier upload/configento/, non accessible depuis le web). Les fichiers font ainsi partie de la commande et sont conservés même lorsque votre abonnement configento.app prend fin. Ils se téléchargent via le back-office, uniquement par les utilisateurs ayant accès aux commandes.
Si Ajouter la référence à la ligne de commande est activé, la référence de la ligne de commande porte en plus le numéro d'article de la configuration (voir Réglages du module).
Nomenclature à la commande
À partir du module 0.5.0, uniquement sous PrestaShop 9. Si votre ERP ne connaît que des articles unitaires, la boutique commande, au lieu du produit configuré, les articles dont la référence correspond aux numéros d'article du configurateur – par exemple film, œillets et impression au lieu d'une bâche. Dans le panier, le client voit toujours le produit configuré. Vous l'activez dans les réglages du module avec Créer la nomenclature à la commande ; l'onglet configento.app du produit indique alors si chaque numéro d'article correspond à un article. Tous les détails : Nomenclatures par numéros d’article.
Multiboutique
Le module fonctionne avec le multiboutique de PrestaShop :
- Connexion : Si une seule boutique est sélectionnée en haut du back-office, la connexion vaut pour cette boutique. Chaque boutique peut ainsi être reliée à son propre service configento.app. Si vous vous connectez avec Toutes les boutiques, la connexion vaut pour toutes les boutiques et remplace la leur.
- Les associations entre produit et composant valent par boutique.
- Les réglages du module valent par boutique.
- Les domaines de toutes les boutiques actives sont signalés (voir Autoriser le domaine de la boutique).
Statut de l'abonnement dans le back-office
Lorsqu'une action est nécessaire concernant votre abonnement configento.app, le module affiche un message en haut de chaque page du back-office, avec le lien Gérer l'abonnement vers le portail de service :
| Message | Signification |
|---|---|
| Ta période d'essai se termine le … | La période d'essai se termine dans les 7 prochains jours. |
| Ton abonnement n'est plus actif. Les configurateurs fonctionnent encore dans ta boutique jusqu'au … | L'abonnement a pris fin. Le configurateur continue de fonctionner jusqu'à la date indiquée. |
| Ton abonnement n'est plus actif. Renouvelle-le pour que les configurateurs continuent de fonctionner dans ta boutique. (ou Ta période d'essai est terminée. Souscris un abonnement …) | L'abonnement ou la période d'essai a expiré, mais le configurateur fonctionne encore. Renouvelez avant qu'il ne soit désactivé. |
| … Les configurateurs ne sont plus disponibles dans ta boutique. | La période d'essai ou l'abonnement a expiré. |
Si configento.app ne dessert plus votre boutique, les fiches produit affichent la phrase Ce produit ne peut pas être configuré pour le moment. à la place du configurateur. Ainsi, aucun client ne se retrouve devant un configurateur qui ne se charge pas. Le module vérifie le statut au plus une fois par heure ; après un renouvellement, le message peut donc mettre jusqu'à une heure à disparaître.
Se déconnecter
Déconnecter au-dessus de l'administration intégrée déconnecte votre compte utilisateur – dans le module et dans le portail de service.
Important : Tant qu'un autre utilisateur du back-office est encore connecté, le configurateur continue de fonctionner dans la boutique. Lorsque le dernier utilisateur connecté se déconnecte, le module supprime aussi les identifiants de la boutique – le configurateur disparaît alors de toutes les fiches produit jusqu'à ce que quelqu'un se reconnecte.
Désinstaller le module
Lors de la désinstallation, le module fait le ménage : il libère tous les produits associés, qui peuvent de nouveau être achetés comme des produits normaux, et supprime les identifiants, les réglages, les connexions, les associations entre produits et composants et les configurations enregistrées des paniers ouverts. Les commandes conservent leur récapitulatif, leur image d'aperçu et les fichiers copiés.
Cliquez une fois sur Déconnecter avant de désinstaller. Sinon, l'autorisation dans le portail de service reste en place.
Dépannage
- Un message d'erreur apparaît après « Connecter », ou le portail refuse la connexion – vérifiez que les URL simplifiées (Friendly URLs) de votre boutique sont activées (Paramètres de la boutique → Trafic & SEO). Sans elles, le module ne peut pas construire l'adresse de retour exigée par le portail de service.
- « Connecté, mais le jeton de boutique n’a pas pu être récupéré » – la connexion est établie, mais les identifiants pour la fiche produit manquent. Déconnectez-vous et reconnectez-vous.
- Aucun configurateur n'apparaît sur la fiche produit – soit aucun composant n'est associé au produit, soit plus aucun utilisateur du back-office n'est connecté. Vérifiez les deux sous Catalogue → configento.app et sur le produit. Dans un multiboutique, vérifiez que la boutique du visiteur est connectée.
- « Le composant n’a pas pu être chargé (HTTP 401) » – le domaine de votre boutique n'est pas autorisé. Voir Autoriser le domaine de la boutique.
- La liste des composants manque sur le produit, il n'y a qu'un champ de saisie – votre compte utilisateur n'est pas connecté ou le portail de service n'était pas joignable à ce moment-là. Connectez-vous sous Catalogue → configento.app ou saisissez directement l'ID du composant.
- « Le prix n’a pas pu être vérifié pour le moment. Merci de réessayer dans un instant. » – la vérification du prix chez configento.app était brièvement injoignable, ou la devise du composant n'est pas créée dans votre boutique. Rien n'a été ajouté au panier ; le client peut réessayer tout de suite. Si le message revient sans cesse, cherchez dans le journal de votre boutique les entrées « configento: Preisprüfung nicht verfügbar ».
- « Cette configuration n’est plus valable. Merci de la recomposer. » – le composant a été modifié pendant que le client configurait. La seule solution est de recharger la page et de recomposer la configuration.
- « Cette configuration ne peut pas être ajoutée au panier. » – la configuration coûte 0 ou moins, et Refuser les configurations à 0 est activé. Vérifiez les prix et les règles du composant. Le journal de votre boutique consigne chaque tentative refusée.
- L'image de la configuration manque dans le panier – le composant ne génère pas d'image de produit combinée. Le panier affiche alors la photo du catalogue.
- « Ce produit ne peut pas être configuré pour le moment. » – votre abonnement configento.app ne dessert plus la boutique. Voir Statut de l'abonnement dans le back-office.
- Une caractéristique de type attribut de produit reste vide – le code ne correspond pas, ou la caractéristique ou le groupe d'attributs porte un autre nom dans la langue du visiteur. Voir Données produit dans les formules.
- Un espace réservé
$content[…]reste vide – il n'existe aucune page CMS active avec cette URL simplifiée ou cet ID dans la boutique et la langue du visiteur, ou vous venez tout juste d'insérer l'identifiant. Voir Contenus de pages CMS. - Un fichier envoyé manque dans la commande – configento.app n'était pas joignable à l'ouverture de la commande. Rouvrez la commande plus tard ; le module récupère alors les fichiers manquants. Il ne copie pas les fichiers de plus de 50 Mo.