New Semantics

Deutsch

English

Deutsch

English

Theme

Produkt-Cache ​

Der Produkt-Cache materialisiert eine Canonical-URL pro Shopware-Produkt. Die Berechnung bei jedem Seitenaufruf wuerde den Kategorienbaum pro Produkt durchlaufen; stattdessen speichert ein Scheduled Task das Ergebnis vorab.

Diese Seite ist kein eigener Tab — die Produkt-Cache-Steuerung sitzt unten im Kategorien-Tab, direkt unter dem Kategorienbaum.

Steuerung oeffnen ​

Klicke VOD / Shop → Shopware 6 → Kategorien und scrolle zu Produkt-Canonical-Cache.

Produkt-Canonical-Cache-Panel mit Intervall-Feld und Trigger-Button
Das Produkt-Cache-Panel sitzt unten im Kategorien-Tab.

Was der Cache speichert ​

Pro Shopware-Produkt x CMS-Sprache speichert der Cache:

  • Die Canonical-URL, ermittelt aus der tiefsten canonical-markierten Kategorie des Produkts.
  • Den zuletzt gesehenen Titel, Slug und Kategorie-Pfad zur URL-Bildung.
  • Einen Zeitstempel der letzten Aktualisierung.

Widgets (sw6ProductDetail, sw6ProductListing) lesen hieraus, wenn sie <link rel="canonical"> oder die interne Navigation rendern — kein Shopware-Round-Trip, keine zusaetzliche Latenz.

Sync-Intervall konfigurieren ​

FeldZweck
Sync-Intervall (Minuten)Wie oft der Scheduled Task laeuft. Default 60, Minimum 5.

Intervall speichern uebernimmt den Wert. Der Scheduled Task sw6_sync_products.php nimmt das neue Intervall beim naechsten Tick auf.

Grosse Kataloge

Bei Shops mit 10.000+ Produkten das Intervall auf 60 Minuten oder mehr lassen — jeder Lauf ist ein Delta-Sync (nur geaenderte Produkte), aber der Initiallauf kann dauern.

Sync manuell ausloesen ​

Klicke Jetzt synchronisieren. Die API startet den Sync inline; der Button zeigt "Gestartet...".

Manuellen Sync nutzen bei:

  • Gerade umgestelltem Canonical-Toggle im Kategorienbaum.
  • Neuem Produkt in Shopware, wenn du nicht bis zum naechsten Tick warten willst.
  • Geaendertem Sprach-Mapping.

Cache-Status pruefen ​

Zwei Status-Zeilen unter der Steuerung zeigen:

  • Letzter Produkt-Sync — Zeitpunkt des letzten Laufs.
  • Cached Produkte — Anzahl pro Sprache (de: 1.234 / en: 1.150).

Steht die Zahl fuer eine aktive Sprache auf Null, stimmt etwas nicht — siehe Fehler unten.

Haeufige Fehler ​

Zaehler bleibt bei Null

Ist Cached Produkte nach dem Sync leer:

  • Sprach-Mapping unvollstaendig — fehlendes CMS → Shopware Mapping ergaenzen und erneut starten.
  • Der Sales Channel hat keine Produkte in dieser Sprache — in Shopware pruefen.
  • Der Verbindungstest schlug waehrend des Syncs stumm fehl — Test im Verbindung-Tab laufen lassen.

Frontend zeigt veraltete Canonical

Der Produkt-Cache wird bei jedem Request neu gelesen, aber der APCu-Cache vor den Produkt-APIs haelt Responses einige Sekunden. Nach einem Canonical-Wechsel 10–15 Sekunden warten, bis der APCu-Cache ausgelaufen ist.

Sync laeuft endlos

Zeigt der Task im Task Manager mehr als ein paar Minuten "running", ist der Shop wahrscheinlich nicht erreichbar. Circuit Breaker im Status-Tab pruefen — siehe Fehlerbehebung.

Siehe auch ​