Erste Layout-Ersetzung

Diese Seite führt Sie durch das minimale Ende-zu-Ende-Setup: ersetzen Sie das Startseiten-Layout auf Verkaufskanal B, während Sie die ursprüngliche Startseite auf Verkaufskanal A beibehalten. Beide Verkaufskanäle teilen sich denselben Kategoriebaum.

Am Ende haben Sie:

• Ein zweites CMS-Layout in den Erlebniswelten.
• Eine Regel, die nur auf Verkaufskanal B passt.
• Die Regel ist dem zweiten Layout zugeordnet.
• Die Plugin-Einstellungen sind so konfiguriert, dass die Ersetzung stattfindet.

Voraussetzungen

• Zwei Verkaufskanäle, beide auf dieselbe Stammkategorie zeigend.
• Dieser Stammkategorie ist ein CMS-Layout zugewiesen (die Basis — z. B. Standard-Kategorielayout).
• Das Plugin ist installiert und aktiviert.

Falls die Stammkategorie kein CMS-Layout hat, weisen Sie zuerst eines zu. Ohne Basislayout hat das Plugin nichts zu ersetzen — siehe Funktionsweise.

Schritt 1: Alternativlayout bauen

1. Gehen Sie zu Inhalte → Erlebniswelten.
2. Klicken Sie auf Neues Layout anlegen → wählen Sie den Typ Landing-Seite (oder denselben Shop-Seite- / Listing-Seite-Typ wie Ihre Basis — der Typ ist wichtig, siehe Schritt 4).
3. Bauen Sie das Layout. Speichern.

Sie haben jetzt ein Kandidat-Alternativlayout. Nichts daran zeigt noch auf eine Kategorie — das kommt als Nächstes.

Schritt 2: Regel erstellen

1. Gehen Sie zu Einstellungen → Regeln → Neue Regel anlegen.
2. Benennen Sie die Regel, z. B. “Verkaufskanal B”.
3. Fügen Sie eine einzelne Bedingung hinzu: Verkaufskanal = ist einer von = wählen Sie Verkaufskanal B.
4. Speichern.

Tipp

Verwenden Sie für diese erste Anleitung nur die Bedingung Verkaufskanal. Die Kombination mit Ist Startseite ist der häufigste Konfigurationsfehler — diese Kombination passt nur auf der Stammnavigation des Kanals, nicht auf Listings oder anderen Kategorienseiten. Siehe den Fallstrick im Mehrere-Verkaufskanäle-Rezept.

Schritt 3: Regel dem Alternativlayout zuweisen

1. Gehen Sie zurück zu Inhalte → Erlebniswelten und öffnen Sie das in Schritt 1 erstellte Layout.
2. Klicken Sie in der rechten Seitenleiste auf Layout-Zuweisung.
3. Klicken Sie auf Layout zuweisen.
4. Öffnen Sie den Tab Regeln (durch dieses Plugin hinzugefügt).
5. Wählen Sie Verkaufskanal B.
6. Klicken Sie auf Bestätigen, dann auf Speichern.

Schritt 4: Plugin konfigurieren

1. Gehen Sie zu Einstellungen → Erweiterungen → Advanced Layouts Assigner.

2. Wählen Sie Verkaufskanal B im Verkaufskanal-Umschalter oben (oder belassen Sie Alle Verkaufskanäle, um die Konfiguration auf beide anzuwenden).

3. Setzen Sie in der Karte Ersetzungsmodus die Kategorienseite auf Alle. Das heißt jedes Basis-Kategorielayout ist für die Ersetzung berechtigt, wenn eine Regel passt.

4. Stellen Sie in der Karte Ersetzungstypen sicher, dass die Zeile, die zum Typ Ihres Basislayouts gehört, den Typ des Alternativlayouts auflistet. Die Post-Install-Defaults sind:

   • Listing-Seite → product_list (sodass Listings durch andere Listings ersetzt werden können)
   • Shop-Seite → page (sodass Shop-Seiten durch andere Shop-Seiten ersetzt werden können)
   • Landing-Seite → landingpage

   Wenn Ihre Basis eine Listing-Seite (product_list) ist und Ihre Alternative eine Landing-Seite (landingpage), fügen Sie landingpage zur Listing-Seite hinzu, damit das Plugin sie als Ersatz verwenden kann.

5. Speichern.

Schritt 5: Überprüfen

1. Öffnen Sie die Storefront auf Verkaufskanal A (das Original). Das ursprüngliche Layout wird gerendert. ✓
2. Öffnen Sie die Storefront auf Verkaufskanal B. Das alternative Layout wird gerendert. ✓

Falls die Alternative auf Verkaufskanal B nicht erscheint:

• Erneut prüfen, ob der Kategorie ein Basislayout zugewiesen ist (Schritt 0).
• Erneut prüfen, ob die Regel nur die Bedingung Verkaufskanal enthält (Schritt 2).
• Erneut prüfen, ob die Regel dem Alternativlayout zugewiesen ist (Schritt 3).
• Erneut prüfen, ob Ersetzungsmodus und -typen es erlauben (Schritt 4).
• Siehe Fehlerbehebung.

Was Sie gerade gebaut haben

Sie haben mit dem Plugin etwas gebaut, was Shopware allein nicht kann: zwei unterschiedliche Layouts für dieselbe Kategorie in zwei Verkaufskanälen ausspielen, ohne Kategorie-Duplizierung.

Von hier aus können Sie:

• Eine zweite Regel für einen weiteren Verkaufskanal hinzufügen und einem dritten Layout zuweisen. Pro Kanal wiederholen.
• Eine Datumsbereich- oder Kundengruppe-Bedingung hinzufügen, um die Alternative zu planen.
• Separate Alternativen für Startseite, Listings und Produktseiten bauen und jedem dieselbe Regel zuweisen. Siehe das Mehrere-Verkaufskanäle-Rezept für die vollständige Anleitung.