Installer le plugin PrestaShop

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 9 (le module est conçu pour PrestaShop 9.0 et supérieur ; les versions plus anciennes ne peuvent pas l'installer)
• 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, la vue 360°, 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 9, bouton Télécharger le module. 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

1. 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.
2. 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 configento

Le nom technique du module est configento. Veillez ensuite à ce que le dossier appartienne à l'utilisateur du serveur web.

Se connecter à configento.app

Vous établissez la connexion une seule fois depuis le back-office. Vous n'avez pas besoin de copier de jeton.

1. Ouvrez Catalogue → configento.app.
2. Vous voyez la carte Mit configento.app verbinden (le module affiche pour l'instant cette carte et ses boutons en allemand). Cliquez sur Verbinden.
3. Vous êtes redirigé vers le portail de service. Connectez-vous et confirmez la connexion.
4. Vous revenez ensuite dans le back-office, et l'administration de configento.app s'ouvre directement dans la page.

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 Mit configento.app verbinden 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 Verbindung trennen (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.

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 lors de la connexion, mais ne les autorise pas lui-même :

1. Dans l'administration de configento.app, ouvrez Paramètres → Domaines.
2. La section Signalés par les boutiques connectées liste les domaines signalés de votre boutique PrestaShop.
3. 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. Si un nouveau domaine s'ajoute plus tard, saisissez-le vous-même sous Paramètres → Domaines ou connectez à nouveau le module. Pour en savoir plus : Paramètres globaux.

Associer un produit à un composant

1. Ouvrez le produit dans le back-office.
2. Le module ajoute la section configento.app au produit.
3. Sous Component, 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é.
4. Enregistrez le produit.

Un produit a exactement un composant. Pour le dissocier, choisissez — not linked — 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.

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.

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.

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 :

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
• le bouton Télécharger la configuration (JSON) avec la configuration complète sous forme de fichier, par exemple pour la fabrication

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 :

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

Verbindung trennen 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 supprime ses connexions, les associations entre produits et composants et les configurations enregistrées des paniers ouverts. Les commandes conservent leur récapitulatif et leur image d'aperçu.

Avant de désinstaller, dissociez le composant de chaque produit (— not linked —) et cliquez une fois sur Verbindung trennen. Sinon, les produits restent « configurables » pour PrestaShop, et l'autorisation dans le portail de service reste en place.

Dépannage

1. Un message d'erreur apparaît après « Verbinden », ou le portail refuse la connexion – vérifiez que les URL simplifiées (Friendly URLs) de votre boutique sont activées. Sans elles, le module ne peut pas construire l'adresse de retour exigée par le portail de service.
2. « 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.
3. 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.
4. « 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.
5. 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.
6. « 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 ».
7. « 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.
8. 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.
9. « 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.
10. 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.

Étapes suivantes

• Créer votre premier composant
• Moteur frontend : Legacy ou V3
• Configurer les prix
• Paramètres globaux