Einrichtungs-Assistent

Der Einrichtungs-Assistent bindet einen Shopware-Shop an plinth an. Er führt der Reihe nach durch die Schritte: Verbinden, Schlüssel, Verkaufskanal, Anmelde-Plugin und erster Import. Danach zeigt er die optionalen Einrichtungsschritte, zum Beispiel den KI-Schlüssel und den Textstil. Diese Seite erklärt auch die Seite Shops, auf der Shops und Firmen verwaltet werden.

Wo finde ich das?

• Hilfe und Verwaltung > Shops, oder klicken Sie oben links auf den Shop-Namen und wählen Sie Shops verwalten.
• Öffnen Sie einen Shop. Oben steht der Abschnitt Shop einrichten. Klicken Sie auf Assistent öffnen oder, wenn noch Schritte offen sind, auf Einrichtung fortsetzen.
• Die Seite des Assistenten heißt Shop einrichten, gefolgt vom Shop-Namen. Unter dem Titel stehen die Shopware-URL und bei einem schreibgeschützten Shop das Wort Schreibgeschützt.

Voraussetzungen

• Die Berechtigung Shops verwalten. Sie gilt für die ganze Installation, nicht für einen einzelnen Shop.
• Der Shop muss in plinth mit seiner Shopware-URL angelegt sein. Wenn nicht, legen Sie ihn zuerst an (siehe unten).
• Zum Verbinden eines von beiden:
  • Benutzername und Passwort eines Shopware-Admins, oder
  • Access-Key-ID und Secret Access Key einer Integration in Shopware (Einstellungen, System, Integrationen).

Wie lege ich einen Shop an?

1. Öffnen Sie Hilfe und Verwaltung > Shops und klicken Sie auf Neuer Shop.
2. Füllen Sie den Abschnitt Grunddaten aus: Name, Kürzel (URL) (der Kurzname in der Adresse), die Firma (eine auswählen oder unter oder neue Firma einen Namen eintragen) und die Shopware-URL. Die übrigen Felder können bleiben, wie sie sind.
3. Entscheiden Sie, ob der Shop Schreibgeschützt ist (siehe unten).
4. Schalten Sie im Abschnitt Module die Bereiche ein, die der Shop haben soll. Keine Auswahl bedeutet: alle allgemeinen Module.
5. Klicken Sie auf Speichern. Die Shop-Seite zeigt jetzt den Abschnitt Shop einrichten.

Was ist der Unterschied zwischen einem schreibgeschützten und einem beschreibbaren Shop?

• Ein beschreibbarer Shop: plinth kann Produkte, Preise und Seiten in Shopware ändern. Der Assistent legt die Integration mit Administratorrechten an.
• Ein Shop mit Schreibgeschützt: plinth liest nur. Shopware-Zugriffe außer Lesen und Suchen werden abgelehnt, Hintergrundaufgaben, die schreiben könnten, schlagen fehl. Der Assistent legt die Integration mit einer Nur-Lesen-Rolle an. Das Anlegen der Integration ist die einzige Änderung, die der Assistent in Shopware macht.

In einem schreibgeschützten Shop zeigt die obere Leiste das Etikett Schreibgeschützt. Sie stellen das in den Grunddaten des Shops um.

Wie verbinde ich einen Shop mit einem Shopware-Login?

Das ist der einfachste Weg. Sie müssen keine Schlüssel kopieren.

1. Öffnen Sie den Assistenten und gehen Sie zu Schritt 1. Verbinden.
2. Geben Sie unter Variante A: Shopware-Admin-Login den Shopware-Admin-Benutzername und das Shopware-Admin-Passwort ein.
3. Klicken Sie auf Anmelden und Schlüssel anlegen.
4. plinth meldet sich einmal an, legt in Shopware seine eigene Integration namens plinth an und speichert die Schlüssel verschlüsselt. Der Login wird nur für diese eine Anfrage genutzt und nie gespeichert.
5. Die Schritte 1 und 2 sind jetzt als erledigt markiert. Schritt 2. Schlüssel ist in diesem Fall nicht nötig.

Hinweis: Sind schon Schlüssel gespeichert, setzen Sie den Haken bei Gespeicherte Schlüssel ersetzen, um eine neue Integration anzulegen. Die alte Integration bleibt in Shopware; löschen Sie sie dort, wenn sie niemand nutzt.

Wie verbinde ich einen Shop mit API-Schlüsseln?

Nutzen Sie diesen Weg, wenn Sie keinen Login angeben können. Sie brauchen eine Integration in Shopware und ihre zwei Werte.

1. Öffnen Sie in Shopware Einstellungen, System, Integrationen und legen Sie eine Integration an oder öffnen Sie eine vorhandene. Kopieren Sie die Access-Key-ID und den Secret Access Key. Shopware zeigt das Secret nur einmal, beim Anlegen der Integration.
2. Optional: Fügen Sie in Schritt 1. Verbinden unter Variante B: vorhandener Admin-API-Token einen aktuellen Token ein und klicken Sie auf Token testen. plinth testet ihn nur (Shopware-Version und Rechte) und behält ihn nicht.
3. Gehen Sie zu Schritt 2. Schlüssel.
4. Tragen Sie die Access-Key-ID ein. Sie beginnt mit SWIA.
5. Tragen Sie den Secret Access Key ein.
6. Klicken Sie auf Schlüssel prüfen und speichern. plinth prüft beide Werte mit einer echten Anfrage, bevor es sie speichert. Sie werden verschlüsselt gespeichert und nie wieder angezeigt.

Hinweis: Die Shop-Seite hat auch einen Abschnitt Zugangsdaten für die Eingabe von Hand. Normalerweise tippen Sie dort nichts. Wenn es nicht anders geht, legen Sie zwei Einträge mit genau diesen klein geschriebenen Namen an: shopware/client_id mit der Access-Key-ID und shopware/client_secret mit dem Secret Access Key.

Wie gehe ich durch die übrigen Schritte?

1. 3. Verkaufskanal: Wählen Sie den Storefront-Verkaufskanal, den Qualitätsprüfungen und Produktwerkzeuge verwenden sollen, und klicken Sie auf Diesen Verkaufskanal verwenden. Hat der Shop nur einen, ist er vorausgewählt. Braucht kein Modul des Shops einen Verkaufskanal, zeigt der Schritt nicht nötig.
2. 4. Anmelde-Plugin: optional. Mit dem Plugin öffnen Personen plinth direkt aus der Shopware-Administration. plinth installiert keine Plugins in einem Shop; Installation und Konfiguration sind Handarbeit. Folgen Sie den drei Anweisungen auf der Seite und klicken Sie dann auf Plugin prüfen.
3. 5. Erster Import: Klicken Sie auf Ersten Import starten. Siehe nächster Abschnitt.
4. 6. KI: optional. Tragen Sie den API-Schlüssel der Firma ein und klicken Sie auf Schlüssel speichern, danach auf Schlüssel testen. Siehe KI-Einstellungen.
5. 7. Textstil: optional. Der Textstil steuert alle KI-Texte der Produkte. Öffnen führt zur Einstellung. Siehe Produkte.
6. 8. SKU-Codes der Marken: optional. Klicken Sie auf Marken ohne SKU-Code zeigen. Siehe Marken.
7. 9. Merchant Center und Feeds: optional. Öffnen führt zur Verbindung. Siehe Feeds.

Die Liste links zeigt jeden Schritt, mit Haken, wenn er erledigt ist. Jeder Schritt zeigt außerdem seinen Zustand: erledigt, offen, nicht nötig, übersprungen oder prüfen.

Wie starte ich den ersten Import?

1. Verbinden Sie zuerst den Shop (Schritte 1 und 2). Ohne Schlüssel ist der Knopf gesperrt.
2. Klicken Sie in Schritt 5. Erster Import auf Ersten Import starten.
3. Die Seite listet die Aufgaben mit ihrem Zustand: nicht gestartet, wartet, läuft, fertig, fehlgeschlagen oder nicht nötig.
4. Klicken Sie auf Status aktualisieren, um die Liste zu erneuern, oder auf Seite Aufgaben öffnen, um den Fortschritt dort zu verfolgen.

Der Import lädt die Shopdaten in sinnvoller Reihenfolge: zuerst der Qualitätsabgleich und die Prüfungen. Die Statistik lädt zuletzt, im Hintergrund, weil sie am längsten dauert (die letzten 13 Monate und die Bestellungen). Sie können schon arbeiten, während sie lädt. Doppeltes Starten schadet nicht: Eine wartende oder laufende Aufgabe wird nicht noch einmal eingereiht.

Wie überspringe ich einen optionalen Schritt?

Die Schritte Anmelde-Plugin, KI, Textstil, SKU-Codes der Marken und Feeds sind optional.

1. Klappen Sie im Schritt Überspringen auf.
2. Geben Sie einen Grund an, zum Beispiel "KI wird nicht genutzt".
3. Klicken Sie auf Überspringen. Der Schritt erscheint als übersprungen, mit Grund, Ihrem Namen und dem Datum.
4. Zum Zurücknehmen klicken Sie auf Wieder öffnen.

Ein übersprungener Schritt bleibt offen und kann jederzeit nachgeholt werden. Verbinden, Schlüssel, Verkaufskanal und erster Import lassen sich nicht überspringen.

Was zeigt der Assistent am Ende?

Nach dem ersten Import zeigen die Schritte 6 bis 9 die Einrichtungsstellen der Bereiche mit ihrem Zustand und einer Zeile mit Einzelheiten, zum Beispiel Schlüssel ..., getestet am ... oder Kein Textstil hinterlegt. Wer eine Stelle ändern darf, sieht den Knopf Öffnen. Alle anderen sehen nur den Zustand. Ist nichts mehr offen, zeigt die Shop-Seite Alle Schritte sind erledigt.

Dieselben Stellen stehen für alle unter Hilfe und Verwaltung > Einrichtung. Siehe Einrichtung.

Wie verwalte ich Shops und Firmen?

1. Öffnen Sie Hilfe und Verwaltung > Shops. Die Liste zeigt alle angebundenen Shops mit Name, Firma, Shopware-URL, Module und Status. Klicken Sie eine Zeile an, um einen Shop zu öffnen.
2. Auf der Shop-Seite:
   • Verbindung testen prüft, ob der Shop mit den gespeicherten Zugangsdaten erreichbar ist. Es ändert nichts.
   • Grunddaten: Name, Adresse und Verhalten des Shops, auch Schreibgeschützt und Shop deaktivieren. Einen deaktivierten Shop kann niemand mehr öffnen; Daten und Zugangsdaten bleiben erhalten.
   • Module: welche Bereiche der Shop hat.
   • Zugangsdaten: verschlüsselt gespeichert und nie wieder angezeigt.
   • Whitelabel: Produktname, Akzentfarbe, Eigene Domain und Logo der Firma. Klicken Sie auf Whitelabel speichern. Das gilt für alle Shops dieser Firma.
3. Der Abschnitt Firmen unten in der Liste zeigt jede Firma mit Produktname und Domain.

Häufige Fehler und Lösungen

Siehe auch

• Einrichtung
• Hintergrundaufgaben
• Zugänge
• KI-Einstellungen
• Erste Schritte