Marketplace Redirect: Konfiguration
Konfiguration von Marketplace Redirect: Channel freischalten, Link am Produkt setzen, Validierungsregeln für ASIN und Store-URL, Praxis-Beispiele.
Marketplace Redirect: Konfiguration
Diese Dokumentation bezieht sich immer auf die aktuellste veröffentlichte Version.
Die Konfiguration besteht aus zwei Schritten: Du schaltest das Plugin pro Channel ein und hinterlegst dann den Link pro Produkt. Eine YAML-Konfiguration unter config/packages/ gibt es nicht.
Schritt 1: Channel freischalten
Admin-Sidebar → MMKreativ Plugins → Marketplace redirect
Die Liste zeigt je Channel eine Zeile mit den Spalten „Channel“ und „Enabled“. Mit „Create“ legst du einen Eintrag für einen Channel an, mit den Aktionen an der Zeile änderst oder löschst du ihn.
| Einstellung | Standard | Beschreibung |
|---|---|---|
| Channel | - | Der Channel, für den der Eintrag gilt. Pro Channel ist genau ein Eintrag möglich, bei einem bestehenden Eintrag lässt sich der Channel nicht mehr ändern |
| Use the external buy button in this channel | aus | Eingeschaltet zeigen Produkte mit Link den externen Button, und die Shop API liefert den Link |
Die Beschriftungen im Admin folgen der Sprache des angemeldeten Benutzers (
de_DEoderen_US). Diese Seiten nennen die englischen Labels. Auf Deutsch heißt der Menüpunkt „Marktplatz-Redirect“, die Karte am Produkt „Externer Kauf“.
Die Liste liegt unter <Admin-Pfad>/marketplace-redirect-settings. Die Routen heißen mmd_sylius_marketplace_redirect_plugin_admin_marketplace_redirect_settings_index, ..._create, ..._update und ..._delete. Das zugehörige Grid hat die ID mmd_sylius_marketplace_redirect_plugin_admin_marketplace_redirect_settings.
Das Plugin ist in jedem Channel ausgeschaltet, bis du es dort einschaltest. Ein Channel ohne Eintrag zählt als ausgeschaltet: Produkte behalten ihren Warenkorb-Button, und die Shop API antwortet mit 404. Das ist nützlich, wenn ein Shop mehrere Channels betreibt und nur einige Kunden zu einem Marktplatz schicken sollen.
Legst du einen zweiten Eintrag für denselben Channel an, lehnt das Formular ihn mit der Meldung „This channel already has marketplace redirect settings.“ ab.
Schritt 2: Link am Produkt setzen
Admin → Catalog → Products → Produkt bearbeiten → General → „External purchase“
| Feld | Beschreibung | |
|---|---|---|
| Marketplace | „No external purchase“, „Amazon“ oder „Shopware Store“. „No external purchase“ entfernt den Link | |
| ASIN or store URL | Die Referenz auf das Produkt beim Marktplatz | |
| Amazon domain | Nur bei Amazon sichtbar. „Default (amazon.de)“ oder eine der unterstützten Domains (Auswahl amazon.de, amazon.com, amazon.co.uk und so weiter) |
|
| Marktplatz | Referenz | Beispiel |
| ------------ | ---------- | ---------- |
| Kein externer Kauf | wird ignoriert, entfernt den Link | |
| Amazon | ASIN (oder ISBN-10) | 3836244764 |
| Shopware Store | Store-URL | https://store.shopware.com/en/vendor12345/my-plugin.html |
Die Karte erscheint sowohl beim Anlegen als auch beim Bearbeiten eines Produkts. Das Feld „Amazon domain“ wird rein per CSS ein- und ausgeblendet, ohne JavaScript. Es braucht einen Browser ab etwa 2023 (:has()), in einem älteren Browser bleibt das Feld ausgeblendet und die Standard-Domain gilt. Eine Domain an einem Shopware-Store-Link verwirft das Produktformular ohne Meldung, die Admin API lehnt sie dagegen mit 422 ab.
Validierung
Die Referenz wird beim Speichern geprüft, weil der Wert später in einem Link landet. Für Referenz und Amazon-Domain gelten im Produktformular und in der Admin API dieselben Regeln.
| Marktplatz | Regel |
|---|---|
| Amazon | Die ASIN besteht aus genau 10 Buchstaben und Ziffern, Groß- und Kleinschreibung sind egal (die URL wird mit Großbuchstaben gebaut) |
| Amazon-Domain | de, com, co.uk, fr, it, es, nl, pl, se oder ca. Ohne Angabe gilt amazon.de |
| Shopware Store | Eine https-Adresse auf dem Host store.shopware.com, ohne Benutzerangabe (user:pass@), ohne Port, mit einem Pfad und ohne Leerzeichen |
Die Amazon-Domain ist nur bei Amazon erlaubt. Ein Produkt kann höchstens einen Link haben.
Praxis-Beispiele
1. Buch bei Amazon Deutschland
Produkt „Mein Buch“ → Marketplace: Amazon, ASIN or store URL: 3836244764, Amazon domain: Default (amazon.de). Ergebnis: Der Button „Bei Amazon kaufen“ führt zu https://www.amazon.de/dp/3836244764.
2. Produkt bei Amazon Großbritannien
Marketplace: Amazon, ASIN or store URL: B08N5WRWNW, Amazon domain: amazon.co.uk. Ergebnis: Der Button führt zu https://www.amazon.co.uk/dp/B08N5WRWNW.
3. Eigenes Shopware-Plugin über den Store verkaufen
Marketplace: Shopware Store, ASIN or store URL: https://store.shopware.com/en/vendor12345/my-plugin.html. Ergebnis: Der Button „Im Shopware Store holen“ führt zu dieser Adresse.
4. Nur ein Channel schickt Kunden weg
Der Shop hat die Channels web und outlet. Du legst unter MMKreativ Plugins → Marketplace redirect nur für outlet einen Eintrag mit eingeschaltetem Schalter an. Im Channel web behalten alle Produkte ihren Warenkorb-Button, im Channel outlet zeigen Produkte mit Link den externen Button.