Sidebar Warenkorb

Der Sidebar-Block Warenkorb zeigt eine kompakte Warenkorb-Zusammenfassung in der Sidebar. Der Block stellt Warenkorb-Titel, Anzahl, Summe, einen Link zum Warenkorb und bei aktualisierten Daten auch die Warenkorbpositionen bereit.

Wofür der Block da ist

Der Block dient als schneller Überblick über den aktuellen Warenkorb. Er ist nicht die vollständige Warenkorbseite, sondern eine kleine Sidebar-Komponente für Orientierung und Einstieg.

• Leerer Warenkorb: Der Block zeigt eine kurze Leerinformation mit der Anzahl 0.
• Gefüllter Warenkorb: Nach Aktualisierung kann der Block die enthaltenen Positionen mit Menge und Artikellink anzeigen.
• Summe: Die angezeigte Summe wird aus Warenkorbpositionen abzüglich Rabatt und Rabattgutschein gebildet.
• Warenkorb-Schaltfläche: Der Button führt zur vollständigen Warenkorbseite.

Position und Sichtbarkeit

Der Backend-Block heißt basket. In den Standardwerten ist er zunächst auf keiner Sidebar-Position aktiv. Damit der Block sichtbar wird, muss er auf einer geeigneten Position aktiviert und sortiert werden.

• Position allgemein: standardmäßig nicht gesetzt.
• Position Startseite, Checkout, Artikeldetail und Artikellisten: standardmäßig nicht gesetzt.
• Sortierung: die Sortierfelder bestimmen die Reihenfolge gegenüber anderen Sidebar-Blöcken.
• Inhalt: der sichtbare Zustand hängt zusätzlich davon ab, ob im aktuellen Besuch bereits Warenkorbpositionen vorhanden sind.

Initiale Werte beim Seitenaufbau

Beim normalen Seitenaufbau setzt der Block Basiswerte für die Ausgabe. Dazu gehören Titel, Buttontext, Ziel der Warenkorb-Schaltfläche, Währung und leere Summenwerte.

• WARENKORB_NAME und WARENKORB_HEADER_NAME: Bezeichnung des Blocks.
• WARENKORB_BUTTON_NAME: Text der Schaltfläche zum vollständigen Warenkorb.
• WARENKORB_BUTTON_ACTION: Ziel der Schaltfläche zur Warenkorbseite.
• WARENKORB_WAEHRUNG: aktuelle Warenkorbwährung.
• WARENKORB_SUMME: initial leer beziehungsweise mit einem Nullwert belegt.
• WARENKORB_ENTRY_COUNT, WARENKORB_ENTRY_WEIGHT und WARENKORB_FULL_ENTRY_COUNT: initiale Zählerwerte.

Die alte direkte Positionserzeugung im Block ist im geprüften Code nicht aktiv. Nach dem Setzen der Initialwerte endet der Blocklauf; die dynamische Aktualisierung erfolgt separat.

Aktualisierung per Warenkorb-Daten

Moderne Themes laden aktuelle Warenkorbdaten nach. Dabei werden Header-Anzeige, mobile Warenkorbmarke, Offcanvas-Warenkorb und Sidebar-Block mit denselben aktuellen Basisdaten versorgt.

• Summe: enthält die formatierte Warenkorbsumme nach Abzug von Rabatt und Rabattgutschein.
• Anzahl: enthält die Anzahl der Warenkorbpositionen.
• Vollständige Anzahl: kann zusätzlich die Gesamtanzahl aller enthaltenen Einheiten liefern.
• Positionsdetails: enthalten Artikelkennung, Titel, Einzelpreis, Menge, Artikellink und Bildlink für unterstützende Frontend-Anzeigen.
• Sidebar-HTML: enthält den fertig gerenderten Warenkorb-Block für die Sidebar und ersetzt dort den bisherigen Blockinhalt.

Anzeige im Sidebar-Block

Die Theme-Vorlage stellt den Warenkorb in einer kompakten Sidebar-Box dar.

• Leerer Zustand: Es wird eine einfache Zeile mit 0 Produkten ausgegeben.
• Gefüllter Zustand: Jede Position kann als Menge, Multiplikator und verlinkter Artikelname ausgegeben werden.
• Summenbereich: Bei gefülltem Warenkorb kann eine Summe mit Währung und Versandhinweis erscheinen.
• Aktion: Die Schaltfläche öffnet die vollständige Warenkorbseite.

Die Sidebar-Ausgabe ist bewusst kompakt. Mengenänderung, Gutscheinbearbeitung, Checkout-Schritte und ausführliche Fehlerhinweise gehören zum vollständigen Warenkorb beziehungsweise zum Offcanvas-Warenkorb.

Blockeigene Einstellung

Die Blockmaske enthält das Feld config_artikel_anzahl mit der Beschriftung „Anzahl der angezeigten Artikel“. Im geprüften aktuellen Blocklauf wird dieses Feld nicht ausgewertet, weil die frühere direkte Artikellisten-Ausgabe nicht aktiv ist. Auch die dynamisch gerenderte Sidebar-Aktualisierung nutzt im geprüften Code kein Limit aus diesem Feld.

Abgrenzung zu Tabellen und Formularen

Der Sidebar-Warenkorb besitzt keine Backend-Datentabelle, keinen Filter und keine Optionsspalte. Die kleine Tabelle im Theme ist nur ein Frontend-Layout für Warenkorbpositionen. Formularfunktionen wie Menge ändern, Gutschein einlösen oder zur Kasse gehen gehören nicht zu dieser Sidebar-Seite, sondern zum vollständigen Warenkorb oder zum Offcanvas-Warenkorb.

Sichere Prüfung im Frontend

1. Block basket auf einer sichtbaren Sidebar-Position aktivieren.
2. Eine Seite mit dieser Sidebar aufrufen und den leeren Zustand prüfen.
3. Einen Artikel in den Warenkorb legen.
4. Prüfen, ob Anzahl, Summe und Sidebar-Block nach der Aktualisierung passen.
5. Die Warenkorb-Schaltfläche nutzen und prüfen, ob die vollständige Warenkorbseite geöffnet wird.
6. Bei Abweichungen zusätzlich Header-Warenkorb und Offcanvas-Warenkorb vergleichen, weil diese dieselben aktualisierten Warenkorbdaten nutzen können.