Installation

P2Lab Advanced Layouts Assigner ist ein gewöhnliches Shopware-6-Plugin. Sie installieren es auf die gleiche Weise wie jedes andere Plugin — über die Admin-Seite Erweiterungen, über Composer oder über die CLI.

Voraussetzungen

• Shopware 6.7 (die composer.json des Plugins beschränkt shopware/core, shopware/administration und shopware/storefront auf >=6.7 <6.8)
• Eine Benutzerrolle, die auf Einstellungen → Erweiterungen und Inhalte → Erlebniswelten zugreifen kann

Installation über den Admin (ZIP-Upload)

1. Laden Sie das Plugin-ZIP (P2LabCmsAssigner_vX.Y.Z.zip) von Ihrer Bezugsquelle herunter.
2. Gehen Sie im Shopware-Admin zu Erweiterungen → Meine Erweiterungen → Erweiterung hochladen und wählen Sie das ZIP aus.
3. Klicken Sie nach dem Upload neben dem Eintrag Advanced Layouts Assigner auf Installieren.
4. Klicken Sie auf Aktivieren.
5. Leeren Sie den Admin-Cache und laden Sie den Browser hart neu (Strg+Umschalt+R), damit das neue Admin-Bundle geladen wird.

Installation über die CLI

Wenn Sie Shell-Zugriff auf den Shopware-Host haben, kopieren Sie das Plugin nach custom/plugins/P2LabCmsAssigner und führen Sie aus:

bin/console plugin:refresh
bin/console plugin:install --activate P2LabCmsAssigner
bin/console cache:clear

Wenn Sie die Administration selbst bauen:

bin/build-administration.sh

Installation überprüfen

1. Öffnen Sie Einstellungen → Erweiterungen → Advanced Layouts Assigner. Sie sollten das Konfigurationsformular mit den Karten Willkommen, Ersetzungsmodus, Landing-Seite und Ersetzungstypen sehen.
2. Öffnen Sie Einstellungen → Regeln → Neue Regel anlegen und fügen Sie eine Bedingung hinzu. Die Bedingungsauswahl sollte nun drei neue Einträge enthalten (in den jeweiligen Kategorien):
   • Ist Startseite [P2Lab Layout Zuweiser]
   • Element in Kategorie [P2Lab Layout Zuweiser]
   • Element in Kategorie mit Unterkategorien [P2Lab Layout Zuweiser]
3. Öffnen Sie Inhalte → Erlebniswelten, öffnen Sie ein beliebiges Layout, klicken Sie in der rechten Seitenleiste auf Layout-Zuweisung und dann auf Layout zuweisen. Sie sollten im Modal einen Tab Regeln sehen (neben Kategorien / Produkte / Landing-Seiten).

Falls der Tab Regeln im Layout-Zuweisungsmodal fehlt oder die neuen Bedingungen nicht im Regel-Builder auftauchen:

• Vergewissern Sie sich, dass das Plugin unter Erweiterungen → Meine Erweiterungen aktiviert ist.
• Leeren Sie den Admin-Cache: bin/console cache:clear.
• Laden Sie den Admin hart neu (Strg+Umschalt+R), damit der Browser das neue Bundle holt.
• Prüfen Sie, ob Ihre Benutzerrolle Zugriff auf die neuen ACL-Schlüssel hat.

Was bei der Installation passiert

Die Post-Install-Routine setzt sinnvolle Standardwerte in der System-Konfiguration (pro Verkaufskanal — einschließlich des globalen “Standard”-Scopes):

• Produktseiten-Ersetzungsmodus → Ohne zugewiesenes Layout
• Kategorienseiten-Ersetzungsmodus → Mit Standardlayout
• Landing-Seiten-Ersetzungsmodus → Mit Standardlayout
• Produktseiten-Ersetzungstypen → Produktseite
• Shop-Seiten-Ersetzungstypen → Shop-Seite
• Landing-Seiten-Ersetzungstypen → Landing-Seite
• Listing-Seiten-Ersetzungstypen → Listing-Seite

Diese Defaults sind konservativ — sie erlauben dem Plugin nur, das zu ersetzen, was natürlich zueinander passt. Siehe Ersetzungsmodi und Ersetzungstypen, um sie zu erweitern.

Deinstallation

Bei der Deinstallation wird die Tabelle p2lab_cms_assigner_cms_page_to_rule des Plugins nur dann gelöscht, wenn Sie “Benutzerdaten behalten” im Deinstallationsdialog abwählen. Mit aktiviertem “Benutzerdaten behalten” überleben die Tabelle — und alle Ihre Regel-zu-Layout-Zuweisungen — eine Neuinstallation.

Weiter: Funktionsweise

Das Plugin ist installiert, aber inaktiv, bis Sie Regeln Layouts zuweisen und konfigurieren, welche Basislayouts für eine Ersetzung in Frage kommen. Weiter geht es mit Funktionsweise.