Instalacja

P2Lab Mirakl to zwykły plugin do Shopware 6. Instalujesz go tak samo jak każdy inny plugin — przez stronę Extensions w adminie albo z linii poleceń.

Zanim zaczniesz

• Shopware 6.6 — plugin jest przygotowany dla linii 6.6.
• Działający worker dla kolejki wiadomości w tle (zobacz Workery w tle niżej). Bez niego nic się nie wydarzy — plugin używa zadań w tle przy każdej synchronizacji.
• Działający runner zaplanowanych zadań (też niżej). Bez niego cykliczne synchronizacje nie uruchomią się same.
• Konto sprzedawcy Mirakl w co najmniej jednym marketplace.

Instalacja przez admin (upload ZIP-a)

1. Pobierz ZIP pluginu (P2LabMirakl_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 wgraniu kliknij Install przy wpisie pluginu. Plugin aktywuje się automatycznie podczas instalacji — osobny krok Activate nie jest potrzebny.
4. Odśwież admina — w głównym menu, w grupie Catalogues, powinien pojawić się wpis Mirakl.

Instalacja z linii poleceń

Jeśli masz dostęp przez konsolę do serwera Shopware, skopiuj plugin do custom/plugins/P2LabMirakl i wykonaj:

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

Workery w tle

Plugin używa Symfony Messenger dla każdego dłuższego zadania — eksportu katalogu, synchronizacji ofert i stanów, importu zamówień, wiadomości, dokumentów i faktur, sprawdzania statusu oraz odświeżania danych referencyjnych. Zanim cokolwiek uruchomisz, upewnij się, że worker w tle działa:

bin/console messenger:consume async

Na produkcji powinien być to nadzorowany proces (systemd, supervisor itp.), tak żeby restartował się automatycznie. Bez działającego workera zadania piętrzą się w kolejce, a w interfejsie ciągle widać zadania w stanie Queued.

Równie ważny jest proces uruchamiający zaplanowane zadania. Bez niego cykliczne zadania (wysyłanie zmian produktów, pobieranie nowych zamówień, pobieranie wiadomości, odświeżanie danych referencyjnych i czyszczenie starych logów) nie wystartują.

bin/console scheduled-task:run

Sprawdź, czy wszystko gra

1. Otwórz admina Shopware.
2. W głównym menu, w grupie Catalogues, powinien być wpis Mirakl z niebieską ikoną torby zakupowej.
3. Kliknij go. Wylądujesz na Dashboard.
4. Dopóki nie masz jeszcze skonfigurowanego marketplace’u, Dashboard pokazuje sekcję Setup Status z następnymi krokami do wykonania — Configure Connection, Configure Attribute Mappings, Map Categories, Add Products to Catalog, Add Products to Offers, Enable Sync — obok karty Quick Start z kafelkami do każdej strony.
5. Kliknij krok Configure Connection (albo kafelek Settings w Quick Start) — otworzy się Mirakl → Settings. Strona ma trzy zakładki: Connections, Sync Settings i Options. Lista Connections jest pusta, dopóki nie utworzysz pierwszego połączenia z marketplace’em.
6. Przełącz się na zakładkę Sync Settings — powinieneś zobaczyć ustawienia harmonogramu synchronizacji.
7. Przełącz się na zakładkę Options — powinieneś zobaczyć ustawienia retencji i poziomu szczegółowości logów.

Jeśli wpis Mirakl nie pojawia się w menu, sprawdź:

• Plugin jest aktywowany (Extensions → My extensions).
• Cache admina został wyczyszczony (bin/console cache:clear albo przycisk Clear caches w adminie).
• Twoja rola admina ma dostęp do uprawnień pluginu (w ustawieniach Permissions roli; wszystkie odpowiednie klucze zaczynają się od p2lab_mirakl_).
• Build administracji Shopware jest aktualny (jeśli budujesz go samodzielnie).

Gdzie czego szukać

Wszystko mieści się w module Mirakl. Karta Quick Start na Dashboardzie ma kafelek do każdej strony:

Co	Gdzie
Dodawanie, edycja i kreator konfiguracji dla połączenia z marketplace’em	Settings → zakładka Connections
Włączanie i wyłączanie synchronizacji, ich harmonogram i wielkość paczek	Settings → zakładka Sync Settings
Retencja i poziom szczegółowości logów	Settings → zakładka Options
Drzewo kategorii marketplace’u	Quick Start → Categories
W jaki sposób pola produktu Shopware wypełniają atrybuty marketplace’u	Quick Start → Attribute Mappings
W jaki sposób pola produktu Shopware wypełniają pola oferty marketplace’u	Quick Start → Offer Field Mappings
Produkty wybrane do wysłania na marketplace	Quick Start → Catalog
Aktywne oferty per marketplace	Quick Start → Offers
Zamówienia z marketplace’u, które stały się zamówieniami Shopware	Quick Start → Orders
Logi synchronizacji	Quick Start → Logs
Logi żądań i odpowiedzi dla każdej wymiany z marketplace’em	Quick Start → API Logs
Działające zadania w tle	Quick Start → Tasks
Zadania importu katalogu po stronie Mirakl	Quick Start → Imports
Zadania eksportu katalogu tworzone przez plugin	Quick Start → Product Exports
Invoices, Transaction Logs, Document Requests, Shipping Mappings	Quick Start → odpowiedni kafelek

Co dalej: połącz Mirakl

Plugin jest zainstalowany, ale nic nie robi, dopóki nie podasz mu danych marketplace’u. Przejdź do Connecting Mirakl.