Avec le plugin Shopware, votre configurateur apparaît directement sur la page produit de votre boutique Shopware. Vos clients composent le produit, voient le prix immédiatement et ajoutent la configuration terminée au panier Shopware habituel. La commande se déroule ensuite tout à fait normalement dans Shopware.
Prérequis
- Shopware 6.7 (le plugin actuel est conçu pour la version 6.7)
- PHP 8.2 à 8.5
- Un accès à l'administration Shopware avec le droit d'installer des extensions
- Un identifiant pour le portail de service pour le service auquel vous voulez connecter la boutique
- Au moins un composant publié – les brouillons non publiés ne peuvent pas être choisis dans la boutique
Vous utilisez une version plus ancienne de Shopware 6 ? Contactez alors le support avant l'installation.
Télécharger le plugin
Vous obtenez le plugin dans configento.app sous Paramètres → Intégrations.
Si l'onglet est verrouillé, acceptez d'abord le contrat de traitement des données sous Paramètres → Traitement des données.
La carte affichée dépend de votre compte :
| Vous voyez … | Signification | Connexion dans le plugin |
|---|---|---|
| une carte Shopware 6.7 avec le bouton Télécharger le plugin | Votre boutique se connecte via votre identifiant du portail de service. Vous n'avez pas besoin de jeton de sécurité. | Connect to Configento (recommandé) |
| une carte Shopware 6 avec un interrupteur, un jeton de sécurité et un lien de téléchargement du plugin | Votre compte utilise encore l'authentification classique. | Saisir manuellement Customer ID, Secure Key et Security Token – voir Authentification classique |
Téléchargez le fichier ZIP et ne le décompressez pas.
Installer le plugin
Dans l'administration Shopware
- Ouvrez Extensions → My extensions.
- Importez le fichier ZIP via Upload extension.
- Installez et activez le plugin configento.app Plugin.
- Videz le cache Shopware.
En ligne de commande
Si vous avez accès à la console Shopware, copiez le dossier décompressé JustsellingProductConfigurator dans custom/plugins/ et exécutez dans le répertoire de Shopware :
bin/console plugin:refresh
bin/console plugin:install --activate JustsellingProductConfigurator
bin/console cache:clearLe nom technique du plugin est JustsellingProductConfigurator. D'anciens guides indiquent ici un autre nom, qui ne fonctionne pas.
Se connecter à Configento
Vous établissez la connexion une seule fois depuis l'administration Shopware. Vous n'avez pas besoin de copier de jeton.
- Ouvrez la configuration du configento.app Plugin dans la gestion des extensions.
- Dans la carte General, sous Configento connection, se trouve le bouton Connect to Configento. Cliquez dessus.
- Vous êtes redirigé vers le portail de service. Connectez-vous et confirmez la connexion.
- Vous revenez ensuite dans l'administration Shopware. Sous Configento connection figure maintenant Connected as avec votre identifiant du portail.
Laissez l'interrupteur Use legacy authentication désactivé.
Lors de la connexion, le plugin renseigne lui-même les identifiants nécessaires à la page produit. Vous les trouvez dans la carte General en tant que Customer ID, Secure Key et Security Token. Vous n'avez rien à y modifier.
Chaque utilisateur administrateur se connecte individuellement. La connexion s'applique à l'utilisateur Shopware qui l'a établie. Si un collègue travaille avec son propre identifiant Shopware, il voit à la première ouverture du configurateur le message Connect to Configento et clique sur Connect now.
Vous vérifiez la connexion existante à tout moment avec Test connection.
Modifier les composants dans l'administration Shopware
Après la connexion, la section Catalogue du menu principal de Shopware contient l'entrée configento.app. configento.app s'y ouvre directement dans l'administration Shopware. Vous modifiez donc vos composants sans quitter la boutique.
Lier un produit à un composant
- Ouvrez le produit dans l'administration Shopware.
- Passez à l'onglet configento.app.
- Cliquez sur Add component.
- Sous Component name, choisissez le composant. La liste affiche les composants de votre service connecté avec leur nom.
- Facultatif : saisissez un Headline. Il s'affiche au-dessus du récapitulatif de la configuration sur la page produit (voir Paramètres du plugin).
- Enregistrez le produit.
Un produit a exactement un composant. Si un composant est déjà lié, le bouton Add component disparaît. Pour lier un autre composant, retirez l'ancien avec Remove component, puis ajoutez le nouveau.
Si un composant n'apparaît pas dans la liste, il n'est généralement pas encore publié. Publiez-le dans configento.app et rouvrez le produit.
Quel moteur frontend s'exécute
À partir de la version 5.2.0, le plugin charge pour chaque composant le moteur frontend adapté. V3 s'exécute si vous l'avez réglé pour le composant, si le composant contient une caractéristique qui nécessite V3 ou si votre compte fonctionne sans le cloud classique. Sinon, c'est Legacy. Le paramètre Configurator version vous permet de le fixer pour toute la boutique, voir Configurateur dans la boutique. Ce qui distingue les deux moteurs : Moteur frontend : Legacy ou V3.
Avec V3, en plus :
- Le prix en haut de la page produit inclut la configuration et change à chaque choix.
- Si le composant génère une image produit combinée, elle remplace les photos du produit sur la page produit. Dans le panier, au paiement et dans la commande, elle sert d'image de la ligne.
- Le panier facture toujours le prix que configento.app calcule pour la configuration – indépendamment de la vérification des prix.
- Le lien sur le produit dans le panier ouvre le configurateur avec la sélection enregistrée. Le client la modifie et ajoute à nouveau le produit au panier.
Autoriser le domaine de la boutique
V3 ne se charge que sur les domaines autorisés pour votre service. À partir de la version 5.2.3, le plugin signale les domaines de vos canaux de vente à configento.app lors de la connexion, mais ne les autorise pas lui-même. Reprenez-les dans l'admin de configento.app sous Paramètres → Domaines, dans la section Signalés par les boutiques connectées, avant de passer un composant en V3. Si un domaine s'ajoute plus tard, saisissez-le vous-même ou connectez à nouveau le plugin. Pour en savoir plus : Paramètres globaux.
Ce qui se passe dans la boutique
- Le client ouvre la page produit. Le configurateur apparaît dans la zone d'achat et y remplace le bouton habituel d'ajout au panier.
- Le client compose le produit. Le prix est recalculé à chaque sélection.
- Avec le bouton d'ajout au panier, le produit et sa configuration arrivent dans le panier Shopware. Les caractéristiques choisies s'affichent sous le produit.
- Shopware traite la commande normalement. Dans la commande, dans l'administration Shopware, vous voyez la configuration sur la ligne de commande.
Le prix du panier correspond au prix du produit Shopware plus les suppléments de la configuration. Si vous saisissez un prix de base dans Shopware, il s'ajoute donc au prix de la configuration. Si le configurateur doit déterminer l'intégralité du prix, réglez le prix Shopware sur 0.
La boutique affiche toujours le dernier état publié du composant. Les modifications que vous avez seulement enregistrées ne sont visibles pour vos clients qu'après publication.
Données produit dans les formules
Avec V3, les caractéristiques de type Attribut de produit lisent des valeurs du produit Shopware, à partir de la version 5.2.1 du plugin. Une formule peut ainsi calculer avec la largeur, le poids ou une propriété. Saisissez comme code dans la caractéristique :
| Source | Code | Exemple |
|---|---|---|
| Champ du produit | Nom du champ dans Shopware | productNumber, name, ean, manufacturerNumber, manufacturer, width, height, length, weight, purchaseUnit, referenceUnit, packUnit, minPurchase, purchaseSteps |
| Champ personnalisé du produit | Nom technique du champ personnalisé | custom_banner_material |
| Propriété du produit | Nom du groupe de propriétés | Matière renvoie p. ex. Laine ; plusieurs options sont séparées par des virgules |
| Variante | Nom du groupe de propriétés de la variante | Taille renvoie p. ex. XL |
Si un code existe plusieurs fois, la source la plus haute dans le tableau l'emporte. Les noms des groupes de propriétés s'appliquent dans la langue du canal de vente. Dans une boutique multilingue, nommez-les de la même façon dans toutes les langues, sinon la caractéristique reste vide dans les autres langues.
La vérification des prix dans le panier utilise les mêmes valeurs. Le plugin ne transmet jamais les prix d'achat, le stock ni les descriptions, car les valeurs figurent dans le code source de la page produit. Pour en savoir plus sur ce type de données : Caractéristiques de calcul.
Configuration dans la confirmation de commande
La confirmation de commande de Shopware n'affiche pas d'elle-même les caractéristiques choisies. Ajoutez pour cela ce bloc dans le modèle d'e-mail Order confirmation, à l'intérieur de la boucle sur les lignes de commande.
Dans la version HTML :
{% if nestedItem.payload.justselling_options is defined and nestedItem.payload.justselling_options|length >= 1 %}
<div>
{% for option in nestedItem.payload.justselling_options %}
{{ option.group }}: {{ option.option }}
{% if nestedItem.payload.justselling_options|last != option %}<br>{% endif %}
{% endfor %}
</div>
{% endif %}Dans la version texte :
{% if lineItem.payload.justselling_options is defined and lineItem.payload.justselling_options|length >= 1 %}, {% for option in lineItem.payload.justselling_options %}{{ option.group }}: {{ option.option }}{% if lineItem.payload.justselling_options|last != option %}{{ " | " }}{% endif %}{% endfor %}{% endif %}Les noms de variables nestedItem et lineItem doivent correspondre à votre modèle. Si votre boucle utilise un autre nom, remplacez-les en conséquence.
Paramètres du plugin
Vous trouvez tous les paramètres dans la configuration du configento.app Plugin.
Configurateur dans la boutique
| Configurator version | Effet |
|---|---|
| Automatic (as set for the component) (par défaut) | Le plugin demande à configento.app pour chaque composant s'il s'exécute avec V3 – voir Quel moteur frontend s'exécute. |
| Always V3 | Tous les composants s'exécutent avec V3. |
| Always the previous version | Tous les composants s'exécutent avec Legacy. |
Settings
| Paramètre | Effet | Par défaut |
|---|---|---|
| Load Chart plugin | À activer si vos composants contiennent des caractéristiques avec des graphiques. Legacy uniquement. | désactivé |
| Load Dropzone plugin | À activer si vos composants contiennent des téléversements de fichiers. Sans cette option, le téléversement ne fonctionne pas dans la boutique. Legacy uniquement. | désactivé |
| Load jQuery | Charge jQuery pour le configurateur. À désactiver uniquement si votre thème charge déjà jQuery lui-même et que cela crée des conflits. Legacy uniquement. | activé |
| Create parts list when ordering | Au lieu d'un produit configuré, ce sont les différents produits Shopware correspondant aux valeurs choisies qui sont commandés. Pour cela, le numéro d'article (SKU) d'une valeur dans configento.app doit correspondre au numéro de produit d'un produit Shopware. Voir Nomenclatures par numéros d’article. | désactivé |
| CSS Path of combined Image Container | Sélecteur CSS de la zone de la page produit dans laquelle l'image produit combinée doit s'afficher. Avec V3, l'image y remplace les photos du produit. Laissé vide, la zone d'images de la page produit est utilisée. | vide |
Price verification
À partir de la version 5.0.1 du plugin, configento.app recalcule le supplément de chaque configuration sur son propre serveur. Un prix manipulé dans le navigateur n'arrive ainsi pas dans le panier.
| Mode | Effet |
|---|---|
| Off | Aucune vérification. Le panier reprend le prix du configurateur. |
| Observe (log differences only) (par défaut) | Le panier continue de reprendre le prix du configurateur. Chaque écart est consigné sous configento.price.divergence dans le journal Shopware. |
| Enforce (cart uses the verified price) | Le panier calcule le prix vérifié. S'il n'y en a pas, par exemple parce que configento.app n'est pas joignable, Shopware bloque la commande avec un message pour le client. |
Après la mise à jour, laissez le plugin quelques jours en mode Observe. Si le journal ne contient aucun écart, passez à Enforce.
Ce paramètre ne s'applique pas aux composants en V3 : le panier y facture toujours le prix vérifié.
Product view
| Paramètre | Effet | Par défaut |
|---|---|---|
| Show summary in tab on product page | Affiche la configuration choisie dans l'onglet de description de la page produit | désactivé |
| Show summary below price on product page | Affiche la configuration choisie sous le prix, avec le Headline défini dans la liaison du produit | désactivé |
Developer-Settings
Debug mode, Development mode et les champs d'URL en dessous sont destinés au dépannage avec le support. Laissez-les désactivés et vides dans la boutique en production.
Statut de l'abonnement dans l'administration
À partir de la version 5.2.1, le plugin affiche une fois par session dans l'administration Shopware un message configento.app subscription lorsque votre abonnement demande une action. L'administration Shopware n'affiche ces messages qu'en allemand ou en anglais :
| Message | Signification |
|---|---|
| Your trial ends on … | La période d'essai se termine dans les 7 prochains jours. |
| Your subscription is no longer active. Configurators keep working in your shop until … | L'abonnement est terminé. Le configurateur fonctionne encore jusqu'à la date indiquée. |
| Your subscription is no longer active. Renew it to keep the configurators running in your shop. (ou Your trial has ended. Take out a subscription …) | L'abonnement ou la période d'essai sont terminés, mais le configurateur fonctionne encore. Renouvelez avant qu'il soit désactivé. |
| … Configurators are no longer available in your shop. | La période d'essai ou l'abonnement sont terminés. |
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. Le plugin vérifie le statut au plus une fois par heure ; après un renouvellement, le message peut donc mettre jusqu'à une heure à disparaître. Vous gérez votre abonnement dans le portail de service.
Authentification classique
Les comptes qui voient sous Paramètres → Intégrations la carte Shopware 6 avec jeton de sécurité connectent le plugin avec trois identifiants :
| Champ dans le plugin | Où trouver la valeur |
|---|---|
| Customer ID | Portail de service, page Services : la valeur après Client pour le service concerné |
| Secure Key | Portail de service, page Services : la Clé de sécurité du service concerné |
| Security Token | configento.app, Paramètres → Intégrations, carte Shopware 6. Activez la carte pour qu'un jeton soit généré. |
Dans la configuration du plugin, activez Use legacy authentication, saisissez les trois valeurs et enregistrez. Test connection vérifie les identifiants. S'ils sont corrects, Legacy cloud connection OK s'affiche. Avec Nouveau jeton, vous générez un nouveau jeton dans configento.app. Vous devez ensuite le remplacer aussi dans le plugin.
Mettre à jour le plugin
Importez le nouveau fichier ZIP comme lors de l'installation sous Extensions → My extensions et lancez la mise à jour. En ligne de commande, copiez le nouveau dossier par-dessus l'ancien et exécutez :
bin/console plugin:refresh
bin/console plugin:update JustsellingProductConfigurator
bin/console cache:clearLa connexion, les paramètres et les liaisons de produits sont conservés lors de la mise à jour.
Déconnecter
Disconnect se trouve sous Configento connection dans la configuration du plugin.
Attention : la déconnexion s'applique à toute la boutique, pas seulement à votre utilisateur administrateur. Toutes les liaisons entre produits et composants de la boutique sont supprimées et les identifiants enregistrés sont réinitialisés. Les composants eux-mêmes sont conservés dans configento.app. Après une nouvelle connexion, vous devez toutefois les lier à nouveau aux produits.
Ne déconnectez donc que si la boutique ne doit plus utiliser configento.app ou doit fonctionner avec un autre service. Pour changer d'utilisateur administrateur, ce n'est pas nécessaire.
Dans le portail de service, sous Connexions, vous voyez toutes les boutiques connectées : hôte de la boutique, plugin, service, Connecté par et Dernière utilisation. Vous pouvez aussi y révoquer une connexion, par exemple si vous n'avez plus accès à la boutique.
Dépannage
La liste des composants dans l'onglet produit est vide
- Votre utilisateur administrateur est-il connecté ? Ouvrez la configuration du plugin et vérifiez que Connected as y figure.
- Le composant est-il publié ? Les brouillons n'apparaissent pas.
Un message d'erreur s'affiche sous configento.app
- « Stored Configento connection is corrupted — please reconnect. » : cliquez sur Disconnect et reconnectez-vous. Notez que les liaisons de produits sont alors supprimées.
- « Configento service portal could not issue a token right now — please try again. » : réessayez après quelques minutes avec Retry.
- « Plugin is not yet connected to Configento. » : cliquez sur Connect now.
Le configurateur n'apparaît pas sur la page produit
- Un composant est-il choisi dans l'onglet configento.app du produit, et le produit est-il enregistré ?
- Videz le cache Shopware et rechargez la page dans le navigateur.
- Avec l'authentification classique : Customer ID, Secure Key et Security Token sont-ils corrects ? La carte Shopware 6 est-elle activée sous Paramètres → Intégrations ?
Le téléversement de fichiers ou le graphique ne fonctionne pas dans la boutique Activez Load Dropzone plugin ou Load Chart plugin et videz le cache.
Avec V3, le configurateur reste vide ou ne se charge pas Le domaine de votre boutique est-il saisi sous Paramètres → Domaines ? Voir Autoriser le domaine de la boutique.
Une caractéristique Attribut de produit reste vide Le code ne correspond pas, ou le groupe de propriétés porte un autre nom dans la langue du canal de vente. Avec Legacy, la caractéristique reste toujours vide dans Shopware. Voir Données produit dans les formules.
La page produit affiche « This product cannot be configured at the moment. » Votre abonnement ou votre période d'essai est terminé. Voir Statut de l'abonnement dans l'administration.
Le prix dans le panier est trop élevé Le prix du produit Shopware s'ajoute au prix de la configuration. Réglez-le sur 0 si le configurateur fournit l'intégralité du prix.
La boutique affiche un ancien état Publiez le composant dans configento.app. La boutique n'affiche que les états publiés.
Si rien de tout cela n'aide, contactez le support via le chat du portail de service. Indiquez la version de Shopware, la version du plugin et le lien vers la page produit concernée.
Shopware 5
Shopware 5 n'est plus développé par Shopware. Le plugin configento.app pour Shopware 5 ne reçoit plus non plus de nouvelles fonctionnalités. Pour les nouvelles boutiques, utilisez Shopware 6.7.