Chaque composant fonctionne dans votre boutique avec l'un des deux moteurs frontend : Legacy, le configurateur éprouvé, ou V3, le nouveau moteur en version bêta. Les deux lisent les mêmes données – caractéristiques, valeurs, prix et règles. Mais ils les affichent différemment, et certaines fonctions n'existent que dans l'un des deux. Cet article montre où chaque moteur s'exécute, en quoi ils diffèrent et comment basculer en toute sécurité.
Où régler le moteur
Vous réglez le moteur pour chaque composant :
- Ouvrez le composant et passez à l'onglet Paramètres à gauche.
- Dans l'onglet Général, tout en bas, vous trouvez Moteur frontend avec le champ Moteur.
- Choisissez Legacy (par défaut) ou V3 (Bêta).
- Enregistrez et publiez le composant. Ce n'est qu'à ce moment que le nouveau moteur s'applique dans la boutique.
Le réglage ne modifie pas :
- vos données – caractéristiques, valeurs, prix, règles et tableaux restent inchangés,
- l'éditeur dans l'admin – vous modifiez le composant exactement comme avant,
- la publication – le contrôle et le déroulement sont identiques pour les deux moteurs.
Vous pouvez donc revenir en arrière à tout moment.
Quel moteur s'exécute où
Toutes les intégrations ne suivent pas ce réglage :
| Où le composant s'exécute | Moteur |
|---|---|
| Aperçu dans l'admin | Le moteur réglé. Vous testez ainsi un changement avant que vos clients ne le voient. |
| Magento 2 | Le moteur réglé. Des composants Legacy et V3 fonctionnent côte à côte dans la même boutique. |
| Shopify | Toujours V3, indépendamment du réglage. |
| PrestaShop 9 | Toujours V3, indépendamment du réglage. |
| Shopware 6 | Toujours Legacy. Le plugin Shopware ne peut pas charger le moteur V3 pour le moment. |
| Extrait HTML | C'est l'extrait qui décide, pas le réglage : l'extrait classique de la carte HTML5 charge Legacy, l'extrait de la carte HTML5 (V3 Bêta) charge V3. |
Les comptes sans cloud classique utilisent V3 partout où le moteur dépend du compte – le réglage Legacy (par défaut) n'y a aucun effet. Vous reconnaissez ces comptes à ce message sous Paramètres → Intégrations : « Les plugins de boutique se connectent via le portail de service — aucun jeton de sécurité n'est nécessaire ici. »
Pour en savoir plus sur chaque intégration : Installer le plugin Magento, Installer le plugin Shopware, Installer le plugin Shopify, Installer le plugin PrestaShop, Intégration extrait HTML.
Ce qui diffère
Uniquement en V3
| Fonction | Ce que fait Legacy à la place |
|---|---|
| Captcha (type de données Captcha (V3 uniquement), protège le bouton d'action contre le spam) | Ne peut pas l'afficher – voir Le badge V3 |
Image produit combinée dans le PDF et l'e-mail (variable {{combined_image}} dans le bouton d'action) |
La variable reste vide |
| Pondération des règles (le champ Pondération dans les paramètres de la règle détermine l'ordre) | Ignore la pondération, les règles s'exécutent dans l'ordre enregistré |
Conditions dans le prix dégressif (>=, >, =, <=, <, !=) |
Ignore la condition et prend toujours le palier le plus élevé dont la valeur est inférieure ou égale à la saisie ; si la saisie est inférieure à tous les paliers, le plus petit s'applique |
Formules avec noms de caractéristiques sans $ (largeur * hauteur) et round(x, 2) avec décimales |
Exige $largeur ; la disponibilité de round dépend de la page de la boutique |
Uniquement en Legacy
| Fonction | Ce que fait V3 à la place |
|---|---|
| Affichage Accordéon | Affiche les caractéristiques sans navigation par groupes (comme Aucun groupe) |
| Vue 360° de l'image produit combinée | Affiche l'image combinée uniquement sous forme de calques statiques |
| Saisie semi-automatique (sélection sous forme de champ de recherche) | Affiche une liste de sélection normale avec toutes les valeurs |
| Champ de date avec calendrier et restrictions (p. ex. Autoriser les jours passés) | Affiche un champ de texte normal sans calendrier |
| Quantité prédéfinie et Min/max prédéfinis (types de règles) | Ignore ces règles |
Formules sur plusieurs lignes avec var, if ou for |
N'évalue qu'une seule expression ; les formules sur plusieurs lignes ne renvoient aucun résultat. Écrivez les conditions sous la forme condition ? a : b. |
Pour en savoir plus sur les formules : Formules & calculs. Sur les prix dégressifs : Configurer les prix.
Le badge V3
Certaines caractéristiques nécessitent V3 – actuellement, il s'agit du Captcha. Si un composant contient une telle caractéristique,
- il porte le badge V3 dans la vue d'ensemble des composants,
- les paramètres du composant affichent la mention Nécessite le Frontend V3,
- Magento 2 le charge automatiquement avec V3 – même si Moteur indique encore Legacy (par défaut).
La publication n'est pas bloquée pour autant. Les intégrations qui ne chargent que Legacy – Shopware 6 et l'extrait HTML5 classique – ne peuvent toutefois pas afficher correctement un tel composant. N'y utilisez pas de Captcha.
Le badge n'indique donc pas quel moteur vous avez réglé, mais que le composant ne fonctionne pas entièrement sans V3.
Quel moteur choisir ?
Restez sur Legacy (par défaut) si
- votre composant est déjà en ligne et fonctionne comme il le doit,
- vous utilisez l'accordéon, la vue 360°, la saisie semi-automatique, des champs de date, une quantité prédéfinie, des min/max prédéfinis ou des formules sur plusieurs lignes,
- votre boutique fonctionne sous Shopware 6.
Choisissez V3 (Bêta) si
- vous créez un nouveau composant et n'avez besoin d'aucune des fonctions Legacy ci-dessus,
- vous souhaitez utiliser le Captcha, l'image produit combinée dans le PDF ou la pondération des règles,
- votre boutique fonctionne sous Shopify ou PrestaShop – V3 y est de toute façon utilisé.
Basculer un composant existant
- Réglez Moteur sur V3 (Bêta) et enregistrez – ne publiez pas encore.
- Vérifiez dans l'aperçu : toutes les caractéristiques apparaissent-elles ? Le prix est-il correct pour quelques configurations typiques ?
- Soyez particulièrement attentif aux prix dégressifs : si un palier a une autre condition que
>=, V3 calcule différemment qu'avant. Un palier «>10 » s'applique à partir de 11 en V3, mais dès 10 en Legacy. - Vérifiez les formules : réécrivez au préalable les formules sur plusieurs lignes en une seule expression.
- Si tout est correct, publiez. Si le résultat ne vous convient pas, revenez simplement à Legacy (par défaut) et publiez à nouveau.
Dépannage
- Le changement n'a aucun effet dans la boutique – le moteur ne s'applique qu'après la publication. Vérifiez aussi le tableau ci-dessus : Shopify et PrestaShop utilisent toujours V3, Shopware 6 toujours Legacy, et pour l'extrait HTML, c'est l'extrait qui décide.
- Une caractéristique manque ou s'affiche différemment – le composant utilise une fonction que le moteur choisi ne connaît pas. Pour les caractéristiques qu'il ne connaît pas du tout, V3 affiche la mention « Type de caractéristique inconnu ». Comparez avec les tableaux ci-dessus.
- Le prix diffère après le changement – il s'agit généralement d'un prix dégressif avec une condition autre que
>=ou d'une formule qui ne renvoie aucun résultat dans l'un des moteurs. Testez la configuration concernée dans l'aperçu avec les deux moteurs. - Une formule ne renvoie aucun résultat en V3 – elle se compose de plusieurs instructions (
var,if,;). Écrivez-la sous forme d'une seule expression, p. ex.$largeur > 200 ? $largeur * 1.2 : $largeur. - Le composant porte le badge V3 alors que Legacy est réglé – il contient un Captcha. C'est pourquoi il fonctionne avec V3 dans Magento 2 ; dans Shopware 6 et l'extrait HTML5 classique, il ne fonctionne pas entièrement.