Shopware 6

newmeta kann als Headless-Frontend fuer eine bestehende Shopware-6-Installation dienen. Die CMS bleibt das Inhalts- und Layout-System; Shopware 6 bleibt die Quelle der Wahrheit fuer Produkte, Lager, Bestellungen und Zahlungen.

Die Integration spricht mit der Shopware Store API — derselben API, die die Shopware-Storefront nutzt. Deine CMS rendert Produkt-Listings, Produktdetails, Warenkorb, Checkout und Kundenkonto ueber newmeta-Pagebuilder-Widgets und ihre Glassmorphism-Admin-UI.

Wann statt des Native Shop

Nimm Shopware 6, wenn etwas davon zutrifft:

• Du betreibst bereits einen Shopware-6-Shop.
• Du brauchst Multi-Waehrung, Multi-Land oder komplexe Steuerregeln.
• Du nutzt Shopware-Plugins (PayPal, Klarna, Ratepay, Pricing Rules).
• Dein Katalog ist gross (Zehntausende SKUs) oder aus einem ERP synchronisiert.

Nimm den Native Shop, wenn nichts davon zutrifft — er ist einfacher und ein System weniger.

Was die Integration macht

Das Shopware-6-Plugin bringt sieben Pagebuilder-Widgets plus ein Offcanvas-Cart-Plugin, die Shopware-Daten auf jeder newmeta-Seite rendern:

Widget	Zweck
Shopware Produkt-Listing	Grid oder Liste von Produkten aus einer Shopware-Kategorie.
Shopware Produkt-Detail	Einzelne Produkt-Detailseite.
Shopware Warenkorb	Der Warenkorb.
Shopware Checkout	Mehrstufiger Checkout (Adresse → Versand + Zahlung → Zusammenfassung).
Shopware Kundenkonto	Login, Profil, Bestellhistorie.
Shopware Kategorie-Teaser	Kategorie-Karten fuer Landingpages.
Shopware Suchleiste	Suchfeld mit Live-Suggest.

Die Widgets teilen sich einen Pinia-Store (sw6Store). Oeffnet man den Warenkorb in einem Widget, aktualisiert sich der Zaehler in allen anderen.

Der Shopware-6-Admin-Screen hat vier Tabs: Verbindung, Sprach-Mapping, Kategorien, System-Status.

Der Admin-Screen

Klicke VOD / Shop → Shopware 6 in der Sidebar. Der Screen hat vier Tabs:

1. Verbindung — Shop-URL, Access-Key, Sales Channel, Seiten-Zuordnung, PayPal Client-ID.
2. Sprach-Mapping — jede CMS-Sprache einer Shopware-Sprache zuordnen.
3. Kategorien — lokaler Kategorie-Cache + Canonical-Toggles.
4. Status — Verbindungsstatus, Circuit Breaker, APCu-Cache, Session-Zaehler.

Pro Tab gibt es eine eigene Seite:

• Shopware 6 Setup
• Sprach-Mapping
• Kategorien & Canonical
• Produkt-Cache
• Fehlerbehebung

Datenfluss in einem Diagramm

Browser des Kunden
      │ (HTTP)
      ▼
newmeta CMS (Nuxt + PHP)
 ├── Pagebuilder-Widget (z.B. sw6ProductListing)
 ├── /api/sw6/products              → ShopwareClient::fromSettings()
 │    │                               (persistentes cURL, APCu-Cache)
 │    ▼
 │   Shopware 6 Store API
 │    └── https://shop.example.com/store-api

Jeder Request von der CMS an Shopware traegt:

• sw-access-key — der Store-API-Access-Key.
• sw-language-id — die Shopware-Sprach-UUID, zugeordnet aus der CMS-Sprache.
• sw-context-token — ein Session-Token, das Warenkorb und Kunden-Login haelt.

Caching und Zuverlaessigkeit

Das Plugin bringt mehrere Zuverlaessigkeits-Schichten mit:

• APCu-Cache fuer Produkt-Listings und -Details (kurzlebig, Sekunden).
• Kategorie-Cache in sw6_category_cache — alle 6 Stunden synchronisiert.
• Produkt-Canonical-Cache — alle 60 Minuten synchronisiert (konfigurierbar).
• Circuit Breaker — nach wiederholten Fehlern zu Shopware werden Requests fuer eine Cooldown-Phase kurzgeschlossen; das Frontend degradiert sauber zu "voruebergehend nicht verfuegbar", statt zu haengen.

Zuerst Setup

Wer noch nie eine CMS mit einem Shopware-Shop verbunden hat, beginnt mit Shopware 6 Setup. Die Seite fuehrt durch Shop-URL, Access-Key, Sales Channel und den Verbindungstest.

Siehe auch

• Shopware 6 Setup — erstmalige Verbindung.
• Sprach-Mapping
• Kategorien & Canonical
• Produkt-Cache
• Fehlerbehebung