Handbuch Varianten-Vorauswahl.

Installation, die vier Einstellungen, Textbaustein und eigenes CSS, direkte Links, Caching und Lizenz. Stand Version 1.0.19.

Systemvoraussetzungen

Shopware 6.7 mit Storefront. Das Plugin setzt shopware/core und shopware/storefront in Version 6.7 voraus. Ältere Shopware-Versionen werden nicht unterstützt.

Kein Theme-Build nötig: Die Storefront-Logik läuft inline im Template. Ein theme:compile ist nach der Installation nicht erforderlich.

Installation

Das ZIP im Shopware-Admin unter Erweiterungen, Meine Erweiterungen hochladen, danach installieren und aktivieren. Anschließend den Lizenzschlüssel eintragen, siehe Lizenz.

Konfiguration öffnen

Das Plugin bringt ein eigenes Admin-Modul mit. Es liegt unter der Stone & Water Plugin Suite und heißt Variantenanzeige Listing/Detailseite. Die Einstellungen erscheinen erst, nachdem die Lizenz aktiviert wurde.

Alle Optionen lassen sich je Verkaufskanal getrennt setzen. Ohne gesetzten Wert gilt der jeweilige Standard.

Plugin aktiv

Standard: aktiv. Deaktiviert die Varianten-Vorauswahl auf der Produktdetailseite. Kunden müssen zuerst alle Varianten-Optionen wählen, bevor der Artikel bestellt werden kann.

Solange die Auswahl unvollständig ist, wird das Kauf-Formular durch einen Hinweistext ersetzt. Der Konfigurator selbst bleibt vollständig sichtbar und bedienbar - ersetzt wird ausschließlich der Kaufbereich. Die Hinweisbox steht über der Variantenauswahl.

Die Auswahlpflicht greift auch dann, wenn im Admin eine Hauptvariante gesetzt ist.

Stammdaten-Preis anzeigen

Standard: aktiv. Zeigt den Preis des Stammartikels an, solange keine Variante gewählt wurde. Ist die Option deaktiviert, wird bis zur Auswahl überhaupt kein Preis angezeigt.

Wann was sinnvoll ist: Bei Varianten mit gleichem Preis ist der Stammdaten-Preis die bessere Wahl, weil der Kunde sofort eine Orientierung hat. Bei stark abweichenden Variantenpreisen kann das Ausblenden ehrlicher sein.

Stammartikel im Kategorie-Listing anzeigen

Standard: aktiv. Zeigt im Kategorie-Listing und in der Suche den Stammartikel statt der vorausgewählten Variante. Der Klick führt zur Detailseite mit dem Auswahlkonfigurator.

Die Ersetzung greift an drei Stellen: im Kategorie-Listing, in den Suchergebnissen und in den Suchvorschlägen. Mehrere Varianten desselben Artikels werden zu einem Eintrag zusammengefasst, die Reihenfolge des Listings bleibt erhalten.

Ist die Option deaktiviert, gilt das Shopware-Standardverhalten mit vorausgewählter Variante.

Standard: aktiv. Wer eine Varianten-URL direkt aufruft, sieht sofort die normale Kaufansicht mit vorausgewählter Variante. Gemeint sind Einstiege über einen externen Link, ein Lesezeichen, eine Suchmaschine oder die Adresszeile.

Innerhalb des Shops bleibt die Auswahlpflicht bestehen. Unterschieden wird über den Referrer des Browsers, also ohne Servereingriff und ohne Auswirkung auf den Cache.

Warum das sinnvoll ist: Ein Besucher, der aus einer Suchmaschine auf eine bestimmte Variante kommt, hat seine Auswahl bereits getroffen. Ihn erneut auswählen zu lassen, kostet Konversion.

Hinweistext ändern

Der Text auf der Detailseite ist ein Shopware-Textbaustein und wird unter Einstellungen, Shop, Textbausteine gepflegt. Der Schlüssel lautet:

stawVariantSelectDirect.detail.selectVariantNotice

Auslieferungszustand deutsch: „Bitte wählen Sie zunächst eine Variante aus, um diesen Artikel bestellen zu können." Englisch: „Please select a variant first to be able to order this product."

Eigenes CSS

Im Admin-Modul gibt es die Karte CSS Anpassungen mit einem Feld für eigenes CSS. Die Hinweisbox trägt die Klasse .staw-variant-gate-notice.

Das CSS wird nur auf Seiten ausgegeben, auf denen die Auswahlpflicht tatsächlich greift. Schließende style-Tags werden serverseitig entfernt, damit der Style-Block nicht verlassen werden kann.

Caching und Hosting

Das Plugin ist so gebaut, dass es mit dem HTTP-Cache zusammenarbeitet statt ihn auszuhebeln:

  • Die Kaufansicht wird versteckt mitgerendert und im Browser freigeschaltet. Eine gecachte Seite bleibt damit für alle Besucher gültig.
  • Der Marker für die getroffene Auswahl steckt im URL-Fragment (#stawSelected). Fragmente erreichen den Server nie und können deshalb auch von Hosting-Proxys nicht entfernt werden.
  • Der Variantenwechsel läuft über die Shopware-Kernroute frontend.detail.switch, die gecacht und erprobt ist.
  • Die Wechsel-URL wird über den SeoUrlPlaceholderHandler erzeugt, es entstehen also echte SEO-URLs.
Hintergrund: In Version 1.0.15 kam heraus, dass manche Hosting-Proxys unbekannte Query-Parameter per Redirect entfernen. Seitdem läuft der Marker als Fragment.

Lizenz

Die Lizenz wird auf der Vorschaltseite des Admin-Moduls aktiviert. Erst danach erscheinen die Einstellungen.

Geprüft wird gegen unsere Lizenzplattform. Die Prüfung ist fail-closed: Ohne gültigen, aktiven und zur Domain passenden Schlüssel bleibt die Funktion aus. Ein positives Ergebnis wird 15 Minuten zwischengespeichert, und es gibt drei Tage Karenz, falls der Lizenzserver einmal nicht erreichbar ist.

Als Domain gilt die erste Verkaufskanal-Domain des Shops, normalisiert ohne www.. Die Vorschaltseite zeigt die erkannte Domain an und nennt bei Problemen den konkreten Grund: inaktiv, nicht gefunden, falsche Domain oder Server nicht erreichbar.

Problemlösung

Der Kauf-Button erscheint nach der Auswahl nicht. Cache des Shops leeren und die Seite neu laden. Prüfen, ob die Lizenz aktiv ist - ohne gültige Lizenz greift das Plugin gar nicht, dann gilt das Shopware-Standardverhalten.

Im Listing stehen weiterhin Varianten. Die Option „Stammartikel im Kategorie-Listing anzeigen" prüfen, und zwar im richtigen Verkaufskanal. Danach den Cache leeren.

Besucher aus Suchmaschinen sehen den Konfigurator. Das ist der Fall, wenn „Direkte Links freischalten" deaktiviert ist. Die Erkennung braucht einen Referrer - fehlt er, greift die Auswahlpflicht.

Die Admin-Seite bleibt weiß. Dieser Fehler betraf Version 1.0.18 und ist mit 1.0.19 behoben. Auf die aktuelle Version aktualisieren.

Support

Fragen und Wünsche direkt an uns: Kontakt. Support kommt vom Entwickler, nicht von einer Hotline.

Über den Store oder direkt bei uns.

Zwei Wege, derselbe Funktionsumfang - such dir aus, was besser zu deinem Setup passt.

Direkt über Stone & Water

Ab sofort möglich

Monatlich1,99 €
Halbjährlich9,99 €16 % günstiger
Bester PreisJährlich17,99 €25 % günstiger

Alle Preise netto zzgl. USt.

Du kaufst die Lizenz direkt bei uns und bekommst eine Rechnung von uns. Installation per Upload im Admin ohne SSH, Updates über unsere Lizenzplattform, Support direkt vom Entwickler.

Direkt anfragen +49 2555 9997342

Shopware Store

In Vorbereitung

Das Plugin wird im offiziellen Shopware Community Store gelistet. Installation und automatische Updates laufen dann über den Plugin Manager im Backend, die Abrechnung über deinen Shopware-Account. Sobald verfügbar, verlinken wir es hier.