Installation

P2Lab Mirakl ist ein ganz normales Shopware-6-Plugin. Sie installieren es genauso wie jedes andere Plugin — entweder über die Seite Erweiterungen in der Administration oder über die Kommandozeile.

Bevor Sie beginnen

• Shopware 6.6 — das Plugin ist für die 6.6-Linie gebaut.
• Ein laufender Hintergrund-Worker für die Nachrichten-Warteschlange (siehe Hintergrund-Worker weiter unten). Ohne ihn passiert nichts — das Plugin nutzt Hintergrundprozesse bei jeder Synchronisation.
• Ein laufender Scheduled-Task-Runner (ebenfalls weiter unten). Ohne ihn starten die wiederkehrenden Synchronisationen nicht von selbst.
• Ein Mirakl-Verkäuferkonto auf mindestens einem Marktplatz.

Installation über die Administration (ZIP-Upload)

1. Laden Sie die Plugin-ZIP-Datei (P2LabMirakl_vX.Y.Z.zip) aus Ihrer Bezugsquelle herunter.
2. Gehen Sie in der Shopware-Administration zu Erweiterungen → Meine Erweiterungen → Erweiterung hochladen und wählen Sie die ZIP-Datei aus.
3. Klicken Sie nach dem Upload neben dem Plugin-Eintrag auf Installieren. Das Plugin wird bei der Installation automatisch aktiviert — ein separater Schritt Aktivieren ist nicht nötig.
4. Laden Sie die Administration neu — in der Hauptnavigation, in der Gruppe Kataloge, sollte ein Eintrag Mirakl erscheinen.

Installation per Kommandozeile

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

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

Hintergrund-Worker

Das Plugin nutzt Symfony Messenger für jede länger laufende Aufgabe — Katalogexporte, Angebots- und Bestandssynchronisation, Bestell-, Nachrichten-, Dokument- und Rechnungsimporte, Statusabfragen und Aktualisierungen der Referenzdaten. Stellen Sie sicher, dass der Hintergrund-Worker läuft, bevor Sie etwas auslösen:

bin/console messenger:consume async

In der Produktion sollte dies ein überwachter Prozess sein (systemd, supervisor oder ähnliches), damit er automatisch wieder anläuft. Ohne den Worker stapeln sich Aufträge in der Warteschlange und die Oberfläche zeigt Aufgaben dauerhaft im Status In Warteschlange.

Genauso wichtig ist der Scheduled-Task-Runner. Ohne ihn starten die wiederkehrenden Aufgaben (Produktänderungen verschicken, neue Bestellungen abholen, Nachrichten abrufen, Referenzdaten auffrischen und alte Logs aufräumen) nicht.

bin/console scheduled-task:run

Prüfen, ob alles bereit ist

1. Öffnen Sie die Shopware-Administration.
2. In der Hauptnavigation, in der Gruppe Kataloge, sollte ein Eintrag Mirakl mit einem blauen Einkaufstaschen-Symbol auftauchen.
3. Klicken Sie ihn an. Sie landen auf dem Dashboard.
4. Solange noch kein Marktplatz konfiguriert ist, zeigt das Dashboard einen Abschnitt Einrichtungsstatus mit den nächsten Schritten — Verbindung konfigurieren, Attributzuordnungen konfigurieren, Kategorien zuordnen, Produkte zum Katalog hinzufügen, Produkte zu Angeboten hinzufügen, Synchronisierung aktivieren — sowie eine Karte Schnellstart mit einer Kachel für jede Seite.
5. Klicken Sie auf den Schritt Verbindung konfigurieren (oder auf die Kachel Einstellungen im Schnellstart) — damit öffnet sich Mirakl → Einstellungen. Die Seite hat drei Reiter: Verbindungen, Synchronisierungseinstellungen und Optionen. Die Liste Verbindungen ist leer, bis Sie Ihre erste Marktplatzverbindung anlegen.
6. Wechseln Sie auf den Reiter Synchronisierungseinstellungen — Sie sollten die Einstellungen für den Synchronisationszeitplan sehen.
7. Wechseln Sie auf den Reiter Optionen — Sie sollten die Einstellungen für Log-Aufbewahrung und Detailgrad sehen.

Falls der Eintrag Mirakl in der Navigation fehlt, prüfen Sie:

• Das Plugin ist aktiviert (Erweiterungen → Meine Erweiterungen).
• Der Administrations-Cache wurde geleert (bin/console cache:clear oder die Schaltfläche Caches leeren in der Administration).
• Ihr Admin-Benutzer hat Zugriff auf die Berechtigungen des Plugins (in den Berechtigungen der Rolle; alle relevanten Schlüssel beginnen mit p2lab_mirakl_).
• Der Administrations-Build von Shopware ist aktuell (falls Sie ihn selbst bauen).

Wo finde ich was

Alles befindet sich innerhalb des Moduls Mirakl. Die Karte Schnellstart auf dem Dashboard hat eine Kachel zu jeder Seite:

Was	Wo
Hinzufügen, Bearbeiten und Setup-Assistent für eine Marktplatzverbindung	Einstellungen → Reiter Verbindungen
Synchronisationen ein-/ausschalten, Zeitplan und Paketgrößen anpassen	Einstellungen → Reiter Synchronisierungseinstellungen
Log-Aufbewahrung und Detailgrad	Einstellungen → Reiter Optionen
Kategoriebaum des Marktplatzes	Schnellstart → Kategorien
Wie Shopware-Produktfelder die Attribute des Marktplatzes füllen	Schnellstart → Attributzuordnungen
Wie Shopware-Produktfelder die Angebotsfelder des Marktplatzes füllen	Schnellstart → Angebotsfeld-Zuordnungen
Produkte, die Sie für den Marktplatz ausgewählt haben	Schnellstart → Katalog
Aktive Angebote pro Marktplatz	Schnellstart → Angebote
Marktplatz-Bestellungen, die zu Shopware-Bestellungen wurden	Schnellstart → Bestellungen
Sync-Logs	Schnellstart → Protokolle
Anfrage- und Antwortprotokolle für jeden Austausch mit dem Marktplatz	Schnellstart → API Logs
Laufende Hintergrundaufgaben	Schnellstart → Aufgaben
Katalog-Importjobs auf der Mirakl-Seite	Schnellstart → Importe
Katalog-Exportjobs, die das Plugin angelegt hat	Schnellstart → Produktexporte
Rechnungen, Transaktionsprotokolle, Dokumentanforderungen, Versand-Zuordnungen	Schnellstart → passende Kachel

Weiter: Mirakl verbinden

Das Plugin ist installiert, tut aber nichts, bis Sie ihm die Zugangsdaten Ihres Marktplatzes geben. Weiter geht es mit Mirakl verbinden.