Den Assistenten öffnest du in der App über „Shop verbinden“. Er hat fünf Schritte: Adresse · Name · Download · Verbinden · Testen. Einen SSH-Zugang brauchst du dafür nicht.
Die fünf Schritte
- Adresse: „Welche Shopware-Version läuft?“ – Shopware 6 (6.4 bis 6.7) oder Shopware 5 (5.6 und 5.7). Dann die „Adresse des Shops“, also die Startseite mit https, z. B.
https://www.mein-shop.de. Umgebung und Kunde kannst du gleich mit angeben. - Name: optional ein eigener „Plugin-Name (Branding)“, sonst „Ohne Branding weiter“. Mehr dazu unter Plugin-Branding.
- Download: „Plugin für Shopware … herunterladen“. Das Connector-Plugin gibt es nur hier in der App.
- Verbinden: Plugin im Shop installieren (Shopware 6, Shopware 5) und den Verbindungsschlüssel einfügen. Passt er, zeigt der Assistent „Schlüssel passt“ mit Version und Adresse.
- Testen: „Verbinden und testen“. StoreDesk prüft nacheinander „Schlüssel prüfen“, „Shop erreichen“ und „Daten abrufen“. Bei Erfolg steht „Verbunden“ da, und der erste Abgleich läuft sofort.
Weitere Angaben
- Umgebung: Live, Staging oder Entwicklung. Staging- und Entwicklungs-Shops sind standardmäßig leise und zählen nicht in die Statistik.
- Erreichbarkeit prüfen: alle 5, 10, 15 (Standard), 30 oder 60 Minuten.
- Kunde und E-Mail des Kunden – für Monatsbericht und Info an Kunden.
- Zugangsschutz (HTTP-Benutzer/Passwort), wenn der Shop hinter einem Passwortschutz liegt.
Wenn der Test fehlschlägt
Dann steht „Angelegt, aber noch keine Verbindung“ mit der Antwort des Shops. Der Shop ist angelegt; nach der Korrektur klickst du „Erneut testen“.
| Meldung | Was hilft |
|---|---|
| Zugriff verweigert | Verbindungsschlüssel prüfen – vollständig kopiert, aus dem richtigen Shop? |
| Connector-Plugin nicht gefunden (404) | Plugin installiert und aktiviert? Bei Shopware 6 danach den Cache leeren. |
| Shop nicht erreichbar | Adresse öffentlich erreichbar, keine Wartungsseite, gültiges Zertifikat? |
| Der Shop ist mit einem Passwort geschützt | Unter „Zugangsschutz“ HTTP-Benutzer und Passwort eintragen, „Speichern und erneut testen“. |
| Passwortschutz sperrt auch /api | Nur Shopware 6: /api und /store-api in der .htaccess vom Passwortschutz ausnehmen. |
| Anmeldung am Shop fehlgeschlagen | Nur Shopware 6: Ist die Integration „StoreDesk Connector“ im Shop noch vorhanden? Sonst Plugin neu installieren. |
Gut zu wissen
- Das Plugin lehnt Anfragen ab, wenn die Uhr des Servers mehr als 5 Minuten abweicht. Nach 20 fehlgeschlagenen Anfragen einer IP in 15 Minuten sperrt es kurz.
- Den Schlüssel kannst du im Shop neu erzeugen:
bin/console storedesk:connection-key --regenerate. Danach den neuen Schlüssel im Shop in StoreDesk unter „Bearbeiten“ eintragen. - Ein Staging-Shop wird genauso verbunden (Umgebung „Staging“) – oder direkt per Staging-Assistent angelegt.