Installer le plugin Magento

Avec l'extension Magento, votre configurateur configento.app fonctionne directement sur la page produit de votre boutique Magento. Vos clients configurent, voient le prix immédiatement et ajoutent le produit au panier comme d'habitude. Magento gère la commande, les taxes et l'expédition. La configuration apparaît dans le panier, la commande, l'e-mail de commande et la vue de la commande dans l'administration.

Prérequis

• Magento Open Source ou Adobe Commerce 2.4, jusqu'à la version 2.4.9 incluse
• PHP 7.4 à 8.4, avec les extensions json et curl
• Composer et un accès à la ligne de commande de votre serveur Magento
• Un identifiant pour le portail de service (service.configento.app) avec une commande de service active dans l'offre Professional ou Ultimate. L'offre Basic ne permet pas de connecter un plugin de boutique.
• Au moins un composant publié. Votre boutique affiche toujours le dernier état publié.

Magento 1 n'est plus développé. Ce guide concerne uniquement Magento 2.

Fonctionnement

1. Vous installez l'extension via Composer.
2. Un administrateur Magento se connecte une fois à Configento avec son identifiant du portail de service. La boutique et la commande de service sont alors liées – l'extension renseigne elle-même l'ID client, la clé et le jeton.
3. Vous ajoutez à chaque produit configurable une option personnalisée de type configento.app et y choisissez le composant.
4. Le configurateur se charge sur la page produit. Au clic sur Ajouter au panier, Magento reprend le prix configuré.

Étape 1 : installer l'extension

L'extension provient du dépôt Composer de justSelling. Vous trouvez aussi la commande correspondante dans l'administration Configento sous Paramètres → Intégrations, sur la carte Magento 2.

Placez-vous dans le répertoire principal de votre installation Magento et exécutez :

composer config repositories.configento composer https://www.justselling.de/repo/mage2/
composer require justselling/configento:^5.1

Activez ensuite le module et reconstruisez Magento :

bin/magento maintenance:enable
bin/magento module:enable Justselling_Configento
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy de_DE en_US
bin/magento cache:flush
bin/magento maintenance:disable

• setup:di:compile et setup:static-content:deploy ne sont nécessaires qu'en mode production. Indiquez dans static-content:deploy les langues de vos boutiques.
• En mode développeur, setup:upgrade et cache:flush suffisent.

Sans Composer

Si vous ne pouvez pas utiliser Composer, téléchargez le fichier ZIP de la version souhaitée sur www.justselling.de/repo/mage2/ et décompressez-le dans app/code/Justselling/Configento/. Exécutez ensuite les mêmes commandes bin/magento que ci-dessus. Vous devrez alors installer chaque mise à jour manuellement – Composer est donc la méthode recommandée.

Étape 2 : se connecter à Configento

1. Dans l'administration Magento, ouvrez le menu justSelling → configento.app → configento.app.
2. Lors du premier accès, Connect to Configento s'affiche. Cliquez sur Sign in to Configento.
3. Vous arrivez sur le portail de service. Connectez-vous avec votre identifiant du portail.
4. Sous Quel client / quelle commande de service ?, choisissez la commande de service avec laquelle la boutique doit fonctionner. Seules les commandes de service actives dans l'offre Professional ou Ultimate sont proposées.
5. Confirmez l'autorisation. Les boutons s'appellent actuellement encore en anglais Approve (confirmer) et Deny (refuser).
6. De retour dans Magento, vous voyez Connected to Configento as … et, en dessous, l'administration Configento. Vous y créez et modifiez vos composants sans quitter Magento.

Lors de la première connexion, l'extension renseigne automatiquement les identifiants de la boutique et signale l'activation à configento.app. Vous n'avez à saisir ni ID client ni jeton de sécurité.

Plusieurs administrateurs

La connexion s'applique par utilisateur administrateur Magento. Chaque personne qui veut ouvrir l'administration Configento dans Magento se connecte une fois elle-même. Vous voyez ainsi par la suite qui est connecté et pouvez retirer des accès individuels (voir Gérer les connexions).

Authentification classique

Les installations qui fonctionnaient déjà avant la version 5 peuvent conserver l'ancienne authentification avec ID client, Secure Key et jeton de sécurité. Pour cela, réglez Use legacy authentication sur Yes dans la configuration. Pour les nouvelles installations, laissez ce paramètre désactivé.

Étape 3 : lier un produit à un composant

1. Ouvrez le produit dans l'administration Magento.
2. Ouvrez la section des options personnalisées (Customizable Options) et ajoutez une option.
3. Donnez un titre à l'option, par exemple « Configuration ». Il apparaît dans le panier avant le récapitulatif.
4. Choisissez comme Option Type l'entrée configento.app.
5. Dans le champ Template, choisissez le composant. La liste affiche les composants de votre commande de service connectée avec leur nom.
6. Enregistrez le produit.

Le configurateur apparaît maintenant sur la page produit. Un composant peut être associé à autant de produits que vous le souhaitez.

Liste vide ? La liste des composants provient de configento.app. Si elle est vide, la boutique n'est pas encore connectée (étape 2) ou la commande de service n'a pas encore de composant.

Ce qui se passe dans la boutique

• Page produit : les composants utilisant le moteur frontend V3 sont intégrés directement dans la page. La boutique affiche le prix et le récapitulatif à l'endroit habituel, les images produit apparaissent dans la galerie. Les composants utilisant le moteur Legacy fonctionnent comme avant. Les deux peuvent coexister dans la même boutique.
• Panier : le prix configuré s'applique au panier, aux taxes, à l'expédition et à la commande. La configuration s'affiche sous forme de liste sous l'article.
• Liste de souhaits et achat immédiat : la configuration est enregistrée avec l'article. Via Modifier dans le panier ou la liste de souhaits, le configurateur s'ouvre à nouveau avec la sélection enregistrée.
• Commande : la configuration figure dans la confirmation de commande et dans la vue de la commande dans l'administration.

Paramètres de l'extension

Ouvrez les paramètres via justSelling → configento.app → Configuration. Les libellés de l'extension sont en anglais – nous les citons ici tels que vous les voyez.

Configento Connections

General

Development mode, Backend URL, Frontend URL, Cloud Base URL et CORS: Allow Private Network sont destinés au développement et restent désactivés ou vides dans la boutique en production.

Product View

New configurator (V3)

À partir de la version 5.0.0-beta21. S'applique aux produits dont le composant utilise le nouveau configurateur (V3).

Cart, Checkout and Backend

Asset Synchronisation

Price verification

Le configurateur calcule le prix dans le navigateur. Avec la vérification des prix, votre boutique fait recalculer chaque prix par configento.app, avec le même mode de calcul, au moment de l'ajout au panier. Personne ne peut ainsi envoyer un prix manipulé dans le panier.

Pour basculer :

1. Commencez avec Shadow et laissez la boutique fonctionner normalement pendant quelques jours.
2. Recherchez configento.v3.price.divergence dans le journal Magento. Chaque entrée est une configuration pour laquelle le navigateur et le serveur ont calculé différemment – la cause est le plus souvent un taux de TVA différent ou une valeur que seule la boutique connaît.
3. Ce n'est que lorsqu'aucun écart n'apparaît plus que vous passez à Enforce.

Seuls les composants utilisant le moteur frontend V3 sont vérifiés. Les composants utilisant le moteur Legacy sont ignorés et calculés comme avant.

Statut de l'abonnement dans le backend

À partir de la version 5.0.0-beta25, l'extension affiche en haut du backend Magento un message système avec le lien Manage subscription vers le portail de service lorsque votre abonnement configento.app demande une action. L'extension n'a pas de traduction française ; les messages s'affichent en anglais :

Lorsque configento.app ne sert plus votre boutique, les pages produit affichent la phrase This product cannot be configured at the moment. au lieu du configurateur. L'extension vérifie le statut au plus une fois par heure ; après un renouvellement, le message peut donc mettre jusqu'à une heure à disparaître.

Gérer les connexions

• Dans Magento : sous Configento Connections, dans la configuration, vous voyez tous les administrateurs connectés et déconnectez des connexions individuelles avec Disconnect.
• Dans le portail de service : sous Connexions, vous voyez toutes les boutiques connectées de votre commande de service avec l'hôte de la boutique, le plugin, l'utilisateur ayant établi la connexion et la dernière utilisation. Révoquer y déconnecte complètement une boutique.

Mise à jour

Avec Composer, vous récupérez la dernière version ainsi :

composer update justselling/configento
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy de_DE en_US
bin/magento cache:flush

La version installée s'affiche en haut de la configuration de l'extension. Les changements de chaque version figurent dans les notes de version livrées avec l'extension.

Dépannage

Vérifiez ces points dans l'ordre :

1. « Le plugin de boutique ne peut être connecté qu'à une commande Professional ou Ultimate » – votre commande de service est dans l'offre Basic ou n'est pas active. Changez d'offre dans le portail de service ou choisissez une autre commande de service.
2. L'administration Configento dans Magento n'affiche que « Connect to Configento » – cet utilisateur administrateur ne s'est pas encore connecté. La connexion s'applique par utilisateur.
3. Le champ « Template » n'affiche aucun composant – la boutique n'est pas encore connectée, ou la commande de service n'a pas encore de composant.
4. Le configurateur n'apparaît pas sur la page produit – vérifiez que le produit possède l'option de type configento.app et que le composant est publié. Videz ensuite le cache Magento et rechargez la page sans le cache du navigateur.
5. Les modifications du composant n'arrivent pas dans la boutique – la boutique affiche le dernier état publié. Publiez le composant dans l'administration Configento.
6. Erreur à la compilation ou après une mise à jour – exécutez à nouveau setup:upgrade, setup:di:compile et cache:flush. En mode production, les nouvelles classes manquent sinon après une mise à jour.
7. « We could not confirm the price for your configuration » – la vérification des prix est réglée sur Enforce, et configento.app n'était pas joignable ou n'a pas pu calculer le composant. Repassez sur Shadow et consultez le journal.
8. Autres indications – activez le Debug mode et consultez la console du navigateur. L'extension écrit en outre dans var/log/configento.log, et les messages de connexion dans var/log/configento-oauth.log.

Si rien de tout cela n'aide, contactez le support via le chat du portail de service. Joignez directement la version de l'extension et les entrées de journal correspondantes.

Étapes suivantes

• Créer votre premier composant
• Installer le plugin Shopware
• Intégration extrait HTML
• Interface JavaScript (V3)