Instalacja

P2Lab Advanced Layouts Assigner to zwykły plugin Shopware 6. Instaluje się go tak samo jak każdy inny plugin — przez admin Extensions, przez Composera albo przez CLI.

Wymagania

• Shopware 6.7 (composer.json plugina ogranicza shopware/core, shopware/administration i shopware/storefront do >=6.7 <6.8)
• Rola użytkownika z dostępem do Settings → Extensions i Content → Shopping Experiences

Instalacja przez admin (upload ZIP)

1. Pobierz ZIP plugina (P2LabCmsAssigner_vX.Y.Z.zip) ze swojego źródła dystrybucji.
2. W adminie Shopware przejdź do Extensions → My extensions → Upload extension i wybierz ZIP.
3. Po uploadzie kliknij Install obok wpisu Advanced Layouts Assigner.
4. Kliknij Activate.
5. Wyczyść cache admina i przeładuj przeglądarkę twardo (Ctrl+Shift+R), aby załadować nowy bundle admina.

Instalacja przez CLI

Jeśli masz dostęp shell do hosta Shopware, skopiuj plugin do custom/plugins/P2LabCmsAssigner i uruchom:

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

Jeśli budujesz administrację samodzielnie:

bin/build-administration.sh

Weryfikacja instalacji

1. Otwórz Settings → Extensions → Advanced Layouts Assigner. Powinieneś zobaczyć formularz konfiguracji z kartami Welcome, Replacement mode, Landing page i Replacement types.
2. Otwórz Settings → Rules → Create new rule i dodaj warunek. Selektor warunków powinien teraz zawierać trzy nowe wpisy (w odpowiednich kategoriach):
   • Is homepage [P2Lab Layouts Assigner]
   • Item in category [P2Lab Layouts Assigner]
   • Item in category with children [P2Lab Layouts Assigner]
3. Otwórz Content → Shopping Experiences, otwórz dowolny layout, kliknij Layout assignment w prawym sidebar, następnie Assign layout. W oknie modalnym powinieneś zobaczyć zakładkę Rules (obok Categories / Products / Landing pages).

Jeśli zakładka Rules brakuje w modalu przypisania layoutu lub nowe warunki nie pojawiają się w Rule Builderze:

• Upewnij się, że plugin jest aktywowany w Extensions → My extensions.
• Wyczyść cache admina: bin/console cache:clear.
• Przeładuj admin twardo (Ctrl+Shift+R), aby przeglądarka pobrała nowy bundle.
• Sprawdź, czy twoja rola użytkownika ma dostęp do nowych kluczy ACL.

Co dzieje się przy instalacji

Procedura post-install seeduje rozsądne wartości domyślne w konfiguracji systemowej (per kanał sprzedaży — w tym scope globalny “Default”):

• Product page replace mode → Without assigned layout
• Category page replace mode → With default layout
• Landing page replace mode → With default layout
• Product page replacement types → Product page
• Shop page replacement types → Shop page
• Landing page replacement types → Landing page
• Listing page replacement types → Listing page

Te wartości domyślne są konserwatywne — pozwalają pluginowi zastąpić tylko to, co już naturalnie pasuje. Zobacz Tryby zastępowania i Typy zastępowania, aby je rozszerzyć.

Deinstalacja

Deinstalacja usuwa tabelę plugina p2lab_cms_assigner_cms_page_to_rule tylko jeśli odznaczysz “Keep user data” w oknie deinstalacji. Z zaznaczonym “Keep user data” tabela — i wszystkie twoje przypisania reguł do layoutów — przeżyją reinstalację.

Dalej: jak to działa

Plugin jest zainstalowany, ale bezczynny dopóki nie przypiszesz reguł do layoutów i nie skonfigurujesz, które bazowe layouty kwalifikują się do zastąpienia. Kontynuuj w Jak to działa.