App-Blöcke in Ihr Theme einbinden

Saal: Sales Agent arbeitet in Ihrer bestehenden Storefront statt in einem separaten Portal. Deshalb sind die beiden Oberflächen, die Ihre Agents nutzen, Theme-Blöcke — und sie müssen einmalig in Ihr Theme eingebunden werden, bevor jemand eine Sitzung starten kann. Das dauert wenige Minuten und erfordert keinen Theme-Code.

Die Session-Leiste sitzt am oberen Seitenrand. Sie zeigt dem Agenten, für welches Kundenkonto er gerade bestellt, und bietet die Möglichkeit, die Sitzung zu beenden. Solange keine Sitzung aktiv ist, zeigt sie den Einstiegspunkt zum Starten. Die Kundenauswahl ist die Stelle, an der ein Agent das Kundenkonto sucht und auswählt, für das er handeln möchte, und an der die Einwilligung erfasst wird. Auf Shopify Plus übernimmt sie zusätzlich die Auswahl von Unternehmen und Standort. Beide sind erforderlich. Ohne sie sieht ein angemeldeter Agent eine ganz normale Storefront und hat keinen Einstieg.

Öffnen Sie die App und gehen Sie zum Einrichtungsassistenten. Jeder Eintrag dort ist ein Deeplink, der Ihren Theme-Editor mit dem passenden Block bereits ausgewählt öffnet — Sie müssen ihn also nicht selbst in der Blockliste suchen. Für jeden Eintrag gilt: Link anklicken, Platzierung des Blocks bestätigen, Theme speichern. Wiederholen Sie das, bis jeder Eintrag im Einrichtungsassistenten erledigt ist. Der Assistent zeigt an, welche Schritte abgeschlossen sind. Wenn Sie mehrere Themes pflegen oder an einer Kopie arbeiten, bevor Sie veröffentlichen, binden Sie die Blöcke in jedes Theme ein, das Sie veröffentlichen wollen. Blöcke liegen im Theme, nicht in der App — ein neu veröffentlichtes Theme ohne sie legt die Funktion still lahm.

Nach dem Speichern sieht Ihre Storefront genauso aus wie vorher. Das ist so gewollt. Beide Blöcke sind geschützt: Sie werden nur für angemeldete Kundenkonten gerendert, die als aktive Vertriebsmitarbeiter hinterlegt sind. Normale Kundinnen, Kunden und Besucher sehen sie nie — und genau das ist der Punkt: Ihre Storefront soll für alle anderen völlig normal aussehen. Um die Einrichtung zu prüfen, melden Sie sich mit einem Kundenkonto an, das Sie als Vertriebsmitarbeiter festgelegt haben. Die Session-Leiste erscheint am oberen Seitenrand. Falls nicht, lesen Sie den Abschnitt zur Fehlersuche weiter unten.

Die Session-Leiste gehört über Ihren Header, damit sie sichtbar bleibt, während sich der Agent durch Katalog und Checkout bewegt. Weiter unten platziert — oder in einem Bereich, der nur auf manchen Templates erscheint — verlieren Agents aus dem Blick, in wessen Namen sie bestellen. Genau diesen Fehler soll die Leiste verhindern. Die Kundenauswahl kann überall dort sitzen, wo sie von der Session-Leiste aus erreichbar ist. Die meisten Shops platzieren sie auf der Kontoseite oder als Block auf der Startseite.

Prüfen Sie in dieser Reihenfolge. Erstens: Ist das Kundenkonto, mit dem Sie angemeldet sind, in der App tatsächlich als Vertriebsmitarbeiter hinterlegt und aktiv? Zweitens: Haben Sie das Theme nach dem Hinzufügen der Blöcke gespeichert, und haben Sie sie im aktuell veröffentlichten Theme hinzugefügt? Drittens: Laden Sie die Seite hart neu — der Sitzungszustand liegt im Browser, und eine gecachte Seite kann einen veralteten Stand zeigen. Wenn die Leiste erscheint, sich die Kundenauswahl aber nicht öffnet, fehlt vermutlich einer der beiden Blöcke. Kehren Sie zum Einrichtungsassistenten zurück; er zeigt, welche Schritte noch offen sind.

Theme-Blöcke werden nicht automatisch übernommen, wenn Sie das Theme wechseln, duplizieren oder ein Theme-Update einspielen, das Ihre Einstellungen ersetzt. Öffnen Sie danach den Einrichtungsassistenten erneut und stellen Sie sicher, dass beide Blöcke noch vorhanden sind. Das gehört in Ihre normale Theme-Release-Routine. Der Fehler ist leise: Agents können schlicht keine Sitzungen mehr starten, und Bestellungen landen wieder als Handarbeit im Admin.