Onboarding: Theme-App-Erweiterung & Checkout

Move To Shop · Anleitung für Händler · Stand: März 2026
Öffentliche URL (für App-Listing / Support): movetoshop.de/theme-app-extension-onboarding.html
Spiegel unter der App: app.movetoshop.de/…/theme-app-extension-onboarding

Voraussetzungen: Shopify-Plan mit Theme-Editor (Online Store 2.0-Themes mit JSON-Templates). Die App muss installiert und eingebettet nutzbar sein. Einige Blöcke laden Daten von app.movetoshop.de (Netzwerkzugriff der Erweiterung) – Störungen bei Adblockern oder strenger CSP im Theme sind selten, bei Problemen Support kontaktieren.

Inhalt

1. Theme-App-Erweiterung („Storefront Extension“)
2. Deep Links – Theme-Editor & Vorschau
3. App-Embeds aktivieren
4. App-Blöcke in Abschnitten einfügen
5. Übersicht der Blöcke
6. Checkout UI – Thank-you-Seite (IBAN)
7. Häufige Probleme
8. English summary

1. Theme-App-Erweiterung („Storefront Extension“)

Die Theme-App-Erweiterung „Storefront Extension“ wird mit der App aus dem Shopify App Store bereitgestellt. Nach der Installation stehen die Blöcke in deinem Theme-Editor zur Verfügung.

Shopify-Admin öffnen: Onlineshop → Themes.
Bei deinem Live- oder Entwicklungstheme auf Anpassen klicken.
Oben links über die Seiten-/Vorlagenauswahl zur gewünschten Seite wechseln (z. B. Startseite, Produkt, Seite).
Im linken Bereich Abschnitt hinzufügen bzw. in einem bestehenden Abschnitt Block hinzufügen wählen.
Unter Apps bzw. App-Blöcke die Einträge von Move To Shop / Storefront Extension anzeigen lassen.
Gewünschten Block hinzufügen, Einstellungen (Überschriften, Texte, Abstände) anpassen und speichern.

Tipp: Arbeite zuerst in einem Entwicklungstheme oder einer Duplikat-Kopie, prüfe die Darstellung mobil und desktop, veröffentliche danach das Theme.

2. Deep Links – Theme-Editor öffnen, App-Embed aktivieren, Block einfügen

Shopify erlaubt Deep Links direkt in den Theme-Editor: Händler können die App dort installieren bzw. Blöcke einfügen und vor dem Speichern in der Vorschau prüfen. Ersetze in den Mustern unten dein-shop durch deinen Shop-Subdomain-Namen (der Teil vor .myshopify.com).

Offizielle Beschreibung der Parameter: Theme-App-Erweiterungen – Deep Linking (shopify.dev).

Theme-Editor (Startseiten-Vorlage)

https://dein-shop.myshopify.com/admin/themes/current/editor?template=index

App-Embed „MTS App Embed“ aktivieren (öffnet App-Embeds-Kontext)

Datei-Handle im Theme-Paket: app-embed. Die Client-ID ist die API-Schlüssel-ID der Move-To-Shop-App im Partner-Dashboard (öffentlich, wie bei OAuth); Stand Konfiguration: 5e2e7f8e827eae59798c7453994218fa – bei App-Neuanlage ggf. aktualisieren.

https://dein-shop.myshopify.com/admin/themes/current/editor?context=apps&template=index&activateAppId=5e2e7f8e827eae59798c7453994218fa/app-embed

App-Block „MTS Storefront Block“ auf der Startseite (neuer Apps-Abschnitt)

Datei-Handle: app-block.

https://dein-shop.myshopify.com/admin/themes/current/editor?template=index&addAppBlockId=5e2e7f8e827eae59798c7453994218fa/app-block&target=newAppsSection

Hinweis: template= entspricht der JSON-Vorlage ohne Endung (z. B. product für product.json). Deep Links nur für Vorlagen nutzen, die in den jeweiligen Blöcken auch zugelassen sind. Nach einem Klick immer prüfen, ob Shopify den Editor korrekt geöffnet hat (Theme- und Admin-Updates können URL-Verhalten beeinflussen).

3. App-Embeds aktivieren

Der Block „MTS App Embed“ ist ein App Embed (Ziel body), kein klassischer Abschnitt.

Im Theme-Editor links unten App-E embeds (bzw. „App embeds“ / Theme-Einstellungen) öffnen.
Liste der installierten Apps durchsuchen und Move To Shop bzw. Storefront Extension finden.
MTS App Embed einschalten (Checkbox „Embed aktivieren“ im Block, sofern angezeigt).
Optional eine kurze Hinweis-Nachricht eintragen oder leer lassen.
Änderungen Speichern.

Dieses Embed ist optional und dient globalem Verhalten; die meisten Inhalte kommen über die einzelnen App-Blöcke unten.

4. App-Blöcke in Abschnitten einfügen

Nur Themes mit JSON-Templates (OS 2.0) unterstützen App-Blöcke in den meisten Bereichen. Sehr alte Vintage-Themes können eingeschränkt sein – dann Theme wechseln oder Shopify-Support konsultieren.
App-Blöcke werden pro Vorlage konfiguriert (z. B. nur auf der Startseite, nur auf Produktseiten).
Reihenfolge und Sichtbarkeit steuerst du wie bei normalen Theme-Blöcken (ziehen, duplizieren, für mobile Ansicht testen).

5. Übersicht der Blöcke (Storefront Extension)

Diese Namen erscheinen im Theme-Editor (deutsche Beschriftung gemäß App):

Block-Name im Editor	Typische Verwendung
MTS Storefront Block	Generischer Inhaltsblock (Überschrift, Text, Ausrichtung) für freie Bereiche.
Hero mit 5 Karten	Hero-Bereich mit konfigurierbaren Karten (Marketing-Startseite).
Galerie (Bilder)	Bildergalerie / Raster.
Kategorie-Karte	Darstellung von Kategorien / Links.
Anbieter / Marken	Anzeige von Marken bzw. Anbieter-Logos (kann Daten von der Move-To-Shop-App beziehen).
Adresse & Karte	Standort / Karte (z. B. Filiale).
Leasing by JobRad	Einbindung von JobRad-Leasing-Inhalten, sofern du das Modul in der App nutzt.
Versicherung by linexo	linexo-Versicherungsbaustein bei aktivierter Anbindung.
IBAN & Versicherung	Storefront-Hinweis / Formularzusammenhang mit IBAN-Versand bzw. Versicherung (je nach Theme-Kontext).
MTS App Embed	App Embed (siehe Abschnitt 2), nicht als normaler Abschnitt.

Die genaue Funktion einzelner Blöcke kann von deinen aktivierten App-Modulen (z. B. BIDEX, JobRad, Versicherung) abhängen. Nicht genutzte Blöcke einfach nicht einfügen oder wieder entfernen.

6. Checkout UI – Thank-you-Seite (IBAN)

Die Checkout-Erweiterung „Thank you – IBAN“ erscheint auf der Bestätigungsseite nach dem Kauf (Thank you / Order status, je nach Shopify-Checkout-Konfiguration).

Shopify-Admin: Einstellungen → Checkout (bzw. den aktuellen Pfad zu Checkout-Anpassungen in deinem Admin).
Checkout anpassen / Editor für Checkout und Kontobereich öffnen (Shopify zeigt je nach Plan die passende Oberfläche).
Zur Thank-you- bzw. Bestellbestätigung-Ansicht wechseln.
Ein neues Element vom Typ App-Block hinzufügen und Move To Shop – Thank you – IBAN (o. Ä.) auswählen.
Texte und Labels in den Blockeinstellungen anpassen (Überschrift, IBAN-Hinweis, Erfolgs- und Fehlermeldungen).
Speichern und einen Testbestellung durchspielen, bis die Thank-you-Seite sichtbar ist.

Hinweis: Checkout-Erweiterungen setzen den Shopify Checkout voraus. Rechte und Sichtbarkeit richten sich nach Shopify-Plan und ggf. Markt. Netzwerkzugriff kann nötig sein, um Daten an app.movetoshop.de zu senden – das ist in der Datenschutzerklärung der App beschrieben.

Daten im Shopify-Admin: Wenn Kund:innen auf der Thank-you-Seite die IBAN bestätigen, schreibt die App die Werte in Bestell-Metafelder: Namespace mts, Keys insurance_iban und insurance_confirmed_at. Du findest sie in der Bestellung im Admin, sobald Metafelder für Bestellungen eingeblendet oder über die API ausgelesen werden – im Sinne der Anforderung „gesammelte Daten an den Händler zurücksenden“.

7. Häufige Probleme

App-Blöcke fehlen im Editor: App neu installieren oder unter Einstellungen → Apps und Verkaufskanäle prüfen, ob die App aktiv ist; danach Theme-Editor neu laden.
Block sichtbar, aber leer / keine Logos: Prüfen, ob das passende Modul in der Move-To-Shop-App aktiviert und konfiguriert ist (z. B. Marken, API-Zugänge); Browser-Konsole auf blockierte Anfragen prüfen.
Checkout-Block fehlt: Prüfen, ob du im Checkout-Editor bist und nicht nur im Theme-Editor; Berechtigungen und Plan beachten.
Änderungen nicht live: Theme veröffentlichen; bei Checkout getrennte „Speichern“/Veröffentlichungsflows von Shopify beachten.

Support: info@movetoshop.de · bei Partner-Onboarding bitte deinen Ansprechpartner vor Ort nennen.

8. English summary (for international merchants)

Move To Shop includes a Theme app extension (“Storefront Extension”) and a Checkout UI extension (“Thank you – IBAN”). After installing the app, open Online Store → Themes → Customize. Deep links to the theme editor, app embed activation, and adding the default app block are documented in section 2 above (pattern per Shopify.dev; replace dein-shop with your store subdomain). Add blocks from Apps / App blocks where your theme supports JSON templates (Online Store 2.0). Enable the optional MTS App Embed under App embeds in the theme editor. For the thank-you page, use Settings → Checkout (or your admin’s checkout customization), add the Move To Shop app block on the thank-you step, configure labels, and test with a checkout. Confirmed IBAN data is stored as order metafields mts.insurance_iban and mts.insurance_confirmed_at. If blocks are missing, confirm the app is installed and reload the editor. Support: info@movetoshop.de. Canonical documentation URL: https://movetoshop.de/theme-app-extension-onboarding.html.