Jede Komponente läuft im Shop mit einer von zwei Frontend-Engines: Legacy, dem bewährten Konfigurator, oder V3, der neuen Engine im Beta-Stadium. Beide lesen dieselben Daten – Merkmale, Werte, Preise und Regeln. Sie stellen sie aber unterschiedlich dar, und einige Funktionen gibt es nur in einer der beiden. Dieser Artikel zeigt, wo welche Engine läuft, worin sie sich unterscheiden und wie du sicher umstellst.
Wo du die Engine einstellst
Die Engine stellst du pro Komponente ein:
- Öffne die Komponente und wechsle links in den Reiter Einstellungen.
- Im Reiter Allgemein findest du ganz unten Frontend-Engine mit dem Feld Engine.
- Wähle Legacy (Standard) oder V3 (Beta).
- Speichere und veröffentliche die Komponente. Erst dann gilt die neue Engine im Shop.
Die Einstellung ändert nicht:
- deine Daten – Merkmale, Werte, Preise, Regeln und Tabellen bleiben, wie sie sind,
- den Editor im Admin – du bearbeitest die Komponente genauso wie vorher,
- das Veröffentlichen – Prüfung und Ablauf sind für beide Engines gleich.
Du kannst also jederzeit zurückstellen.
Welche Engine wo läuft
Nicht jede Integration richtet sich nach der Einstellung:
| Wo die Komponente läuft | Engine |
|---|---|
| Vorschau im Admin | Die eingestellte Engine. So testest du eine Umstellung, bevor deine Kunden sie sehen. |
| Magento 2 | Die eingestellte Engine. Komponenten mit Legacy und mit V3 laufen im selben Shop nebeneinander. |
| Shopify | Immer V3, unabhängig von der Einstellung. |
| PrestaShop 9 | Immer V3, unabhängig von der Einstellung. |
| Shopware 6 | Immer Legacy. Das Shopware-Plugin kann die V3-Engine derzeit nicht laden. |
| HTML-Snippet | Bestimmt das Snippet, nicht die Einstellung: Das klassische Snippet der Karte HTML5 lädt Legacy, das Snippet der Karte HTML5 (V3 Beta) lädt V3. |
Konten ohne klassische Cloud laufen überall mit V3, wo die Engine vom Konto abhängt – die Einstellung Legacy (Standard) hat dort keine Wirkung. Du erkennst solche Konten daran, dass unter Einstellungen → Integrationen steht: „Shop-Plugins verbinden sich über das Service-Portal — ein Sicherheitstoken ist hier nicht nötig.“
Mehr zu den einzelnen Integrationen: Magento-Plugin installieren, Shopware-Plugin installieren, Shopify-Plugin installieren, PrestaShop-Plugin installieren, HTML-Snippet Integration.
Was sich unterscheidet
Nur in V3
| Funktion | Was Legacy stattdessen macht |
|---|---|
| Captcha (Datentyp Captcha (nur V3), schützt den Aktions-Button vor Spam) | Kann es nicht darstellen – siehe Das Kennzeichen „V3“ |
Kombiniertes Produktbild in PDF und E-Mail (Platzhalter {{combined_image}} im Aktions-Button) |
Der Platzhalter bleibt leer |
| Gewichtung von Regeln (Feld Gewichtung in den Regel-Einstellungen bestimmt die Reihenfolge) | Wertet die Gewichtung nicht aus, Regeln laufen in gespeicherter Reihenfolge |
Bedingungen im Staffelpreis (>=, >, =, <=, <, !=) |
Ignoriert die Bedingung und nimmt immer die höchste Stufe, deren Wert kleiner oder gleich der Eingabe ist; liegt die Eingabe unter allen Stufen, gilt die kleinste |
Formeln mit Merkmalsnamen ohne $ (breite * hoehe) und round(x, 2) mit Nachkommastellen |
Braucht $breite; ob round bekannt ist, hängt von der Shopseite ab |
Nur in Legacy
| Funktion | Was V3 stattdessen macht |
|---|---|
| Darstellung Accordion | Zeigt die Merkmale ohne Gruppen-Navigation (wie Keine Gruppen) |
| 360°-Ansicht des kombinierten Produktbilds | Zeigt das kombinierte Bild nur als statische Ebenen |
| Autocomplete (Auswahl als Suchfeld) | Zeigt eine normale Auswahlliste mit allen Werten |
| Datumsfeld mit Kalender und Einschränkungen (z. B. Vergangene Tage erlauben) | Zeigt ein normales Textfeld ohne Kalender |
| Mengen-Vorbelegung und Min/Max-Vorbelegung (Regeltypen) | Überspringt diese Regeln |
Mehrzeilige Formeln mit var, if oder for |
Wertet nur einen Ausdruck aus; mehrzeilige Formeln liefern kein Ergebnis. Schreibe Bedingungen als bedingung ? a : b. |
Mehr zu Formeln: Formeln & Berechnungen. Mehr zu Staffelpreisen: Preisberechnung einrichten.
Das Kennzeichen „V3“
Manche Merkmale brauchen V3 – derzeit ist das das Captcha. Enthält eine Komponente ein solches Merkmal,
- trägt sie in der Komponenten-Übersicht das Kennzeichen V3,
- zeigen die Komponenten-Einstellungen den Hinweis Benötigt Frontend V3,
- lädt Magento 2 sie automatisch mit V3 – auch wenn bei Engine noch Legacy (Standard) steht.
Das Veröffentlichen wird dadurch nicht blockiert. Integrationen, die nur Legacy laden – Shopware 6 und das klassische HTML5-Snippet –, können eine solche Komponente aber nicht richtig anzeigen. Verwende dort kein Captcha.
Das Kennzeichen sagt also nicht, welche Engine du eingestellt hast, sondern dass die Komponente ohne V3 nicht vollständig funktioniert.
Welche Engine solltest du nehmen?
Bleib bei Legacy (Standard), wenn
- deine Komponente schon live ist und so funktioniert, wie sie soll,
- du Accordion, 360°-Ansicht, Autocomplete, Datumsfelder, Mengen- oder Min/Max-Vorbelegung oder mehrzeilige Formeln verwendest,
- dein Shop auf Shopware 6 läuft.
Nimm V3 (Beta), wenn
- du eine neue Komponente baust und keine der Legacy-Funktionen oben brauchst,
- du Captcha, das kombinierte Produktbild im PDF oder die Gewichtung von Regeln nutzen willst,
- dein Shop auf Shopify oder PrestaShop läuft – dort läuft ohnehin V3.
Eine bestehende Komponente umstellen
- Stelle Engine auf V3 (Beta) und speichere – noch nicht veröffentlichen.
- Prüfe in der Vorschau: Erscheinen alle Merkmale? Stimmt der Preis bei einigen typischen Konfigurationen?
- Achte besonders auf Staffelpreise: Steht bei einer Stufe eine andere Bedingung als
>=, rechnet V3 anders als vorher. Eine Stufe „>10“ greift in V3 erst ab 11, in Legacy schon ab 10. - Prüfe Formeln: Mehrzeilige Formeln musst du vorher in einen Ausdruck umschreiben.
- Passt alles, veröffentliche. Gefällt dir das Ergebnis nicht, stellst du einfach wieder auf Legacy (Standard) und veröffentlichst erneut.
Fehlersuche
- Die Umstellung wirkt im Shop nicht – die Engine gilt erst nach dem Veröffentlichen. Prüfe außerdem die Tabelle oben: Shopify und PrestaShop laufen immer mit V3, Shopware 6 immer mit Legacy, und beim HTML-Snippet entscheidet das Snippet.
- Ein Merkmal fehlt oder sieht anders aus – die Komponente nutzt eine Funktion, die die gewählte Engine nicht kennt. V3 zeigt bei Merkmalen, die es gar nicht kennt, den Hinweis „Unbekannter Merkmal-Typ“. Vergleiche mit den Tabellen oben.
- Der Preis weicht nach der Umstellung ab – meist ein Staffelpreis mit einer Bedingung außer
>=oder eine Formel, die in einer Engine kein Ergebnis liefert. Teste die betroffene Konfiguration in der Vorschau mit beiden Engines. - Eine Formel liefert in V3 kein Ergebnis – sie besteht aus mehreren Anweisungen (
var,if,;). Schreibe sie als einen Ausdruck, z. B.$breite > 200 ? $breite * 1.2 : $breite. - Die Komponente hat das Kennzeichen V3, obwohl Legacy eingestellt ist – sie enthält ein Captcha. In Magento 2 läuft sie deshalb mit V3; in Shopware 6 und im klassischen HTML5-Snippet funktioniert sie nicht vollständig.