basket - Warenkorb

basket - Warenkorb

Der Abschnitt basket umfasst alle Einstellungen rund um den Warenkorb des Onlineshops.
Hier wird gesteuert, wie sich der Warenkorb verhält, welche Artikel automatisch hinzugefügt werden und wie lange Warenkorbdaten gespeichert bleiben.

Zu den typischen Konfigurationsmöglichkeiten gehören:

  • Beigaben – definiert Produkte, die beim ersten Laden des Shops automatisch in den Warenkorb gelegt werden (z.B. Überraschungsprodukte)

  • Warenkorb-Cookies – legt fest, ob ein Cookie-basierter Warenkorb aktiv ist, wie lange er gespeichert bleibt und wie sich das System bei Rückkehr eines Nutzers verhält.

  • Allgemeine Warenkorb-Optionen – z. B. maximale Anzahl von Artikeln, Verhalten bei Preisänderungen oder Synchronisation zwischen Sitzungen.

 

Inhaltsverzeichnis

 


 

1. basket* - Grundstruktur

Nachfolgend der Grundaufbau des Knotens basket:

basket: { autobasket: { ... }, basket: { ... } }

 

Parameterbeschreibung

Parameter

Beschreibung

Parameter

Beschreibung

autobasket

Automatisch hinzugefügte Warenkorb-Positionen. Enthält je Land / Shop eine Liste der Einträge.

basket

Reguläre Warenkorb-Positionen. Ebenfalls je Land / Shop getrennt.

 


 

2. basket.basket - Einstellungen für den Warenkorb

Der Knoten basket steuert das grundlegende Verhalten des Warenkorbs im Shop.

Hier wird festgelegt, ob Warenkörbe benutzerbezogen gespeichert werden, wie lange Cookies gültig sind, und wie der Warenkorb beim Login oder Logout reagiert.

Diese Einstellungen bestimmen also, wie dauerhaft ein Warenkorb erhalten bleibt und wie sich das System bei wiederkehrenden Nutzern verhält.

Typische Anwendungsfälle:

  • Aktivierung eines persistenten Warenkorbs über Kundenkonto oder Cookie

  • Festlegung der Gültigkeitsdauer gespeicherter Warenkörbe

  • Steuerung, ob ein Warenkorb beim Logout gelöscht oder beibehalten wird

  • Begrenzung der maximalen Artikelmenge im Warenkorb

 

Beispielkonfiguration für alle Subshops (basket.basket)

{ "accountBasketActive": true, "accountBasketDurationDays": 356, "clearBasketOnLogout": false, "cookieBasketActive": false, "cookieBasketDurationDays": 30, "maxItemQuantity": 100, "readCookieBasketAfterLogin": false }

 

Parameterbeschreibung

Parameter

Typ

Beschreibung

Parameter

Typ

Beschreibung

accountBasketActive

bool

Steuert, ob beim Login der zuletzt zum Benutzerkonto gespeicherte Warenkorb automatisch wiederhergestellt wird.
Der aktuell genutzte Warenkorb bleibt auch ohne diese Option nach einem Logout lokal erhalten (z.B. per Session/Cookie).

  • true - Beim nächsten Login wird der kontogebundene, zuletzt gespeicherte Warenkorb serverseitig geladen.

  • false - Es erfolgt keine serverseitige Wiederherstellung; es bleibt nur die lokale Persistenz aktiv.

Default: false

accountBasketDurationDays

int

Gültigkeitsdauer eines gespeicherten Konto-Warenkorbs in Tagen. Nach Ablauf wird der Warenkorb automatisch gelöscht.

Default: 365

clearBasketOnLogout

bool

Bestimmt, ob der Warenkorb beim Logout gelöscht wird (true) oder erhalten bleibt (false).

Default: false

cookieBasketActive

bool

Aktiviert den Cookie-basierten Warenkorb. Ist der Wert true, wird der Warenkorb auch ohne Login über ein Browser-Cookie gespeichert.

Es können Konto-Warenkorb und Cookie-Warenkorb parallel existieren. Bei aktivem Login wird in der Regel der Konto-Warenkorb priorisiert.

Durch Kombination von cookieBasketActive und accountBasketActive kann ein nahtloser Warenkorberhalt über Geräte hinweg ermöglicht werden.

Default: false

cookieBasketDurationDays

int

Gültigkeitsdauer des Cookie-Warenkorbs in Tagen. Nach Ablauf wird der Cookie-Warenkorb gelöscht.

Default: 30

maxItemQuantity

float

Legt fest, wie viele Einzelartikel maximal in den Warenkorb gelegt werden dürfen. Dient zur Begrenzung übermäßiger Warenkorbgrößen.

Default: 100.0

readCookieBasketAfterLogin

bool

Steuert, ob nach einem Login ein vorhandener Cookie-Warenkorb ausgelesen und mit dem Konto-Warenkorb zusammengeführt wird (true), oder ob er ignoriert wird (false).

Default: false

 


 

3. basket.autobasket - Beigaben zum Warenkorb

Mit autobasket lassen sich Artikel automatisch in den Warenkorb legen – z. B. Geschenkartikel oder Promo-Produkte. Mehrere automatische Artikel sind möglich; Reihenfolge entspricht der Konfiguration.

Ohne Bedingungen werden die Positionen immer hinzugefügt; über optionale Bedingungen können Sie die automatische Beigabe steuern (z. B. pro Subshop, Land, Kampagne).

Beispielkonfiguration für alle Subshops ( basket.autobasket)

{ "products": [ { "product": { "id": "GIFT-001", "variant": "std", "number": "900001" }, "behavior": { "product": true, "removable": true, "changeable": false } }, { "product": { "id": "DEPOSIT-250", "number": "990250" }, "conditions": [ { "field": "country", "value": "DE" } ], "behavior": { "product": true, "removable": false, "changeable": false } } ] }

 

Parameterbeschreibung

Parameter

Typ

Beschreibung

Parameter

Typ

Beschreibung

products

list (object)

Liste der Produkte, die dem Warenkorb hinzugefügt werden sollen.

product

object

Jeder Eintrag beschreibt einen Artikel inkl. Identifikation, optionalen Bedingungen und Verhalten.

id

string

Interne/technische Artikel-ID.

variant

string

Variantenkennung (falls benötigt), z. B. Größe/Farbe.

number

string

Artikelnummer (SKU).

conditions

list (object)

Liste von Bedingungen; alle müssen erfüllt sein, damit die Beigabe hinzugefügt wird.

field

string

Prüf-Feld (z. B. country, subshop, campaign).

value

string

Erwarteter Wert (z. B. DE, deutsch, spring-sale).

behavior

object

Verhalten im Warenkorb

visible

bool

Kennzeichnet, ob die Position im Warenkorb sichtbar ist.

Default: true

removable

bool

Kennzeichnet, ob die Position im Warenkorb durch den Käufer entfernt werden darf.

Default: true

changeable

bool

Kennzeichnet, ob die Position im Warenkorb durch den Käufer geändert werden darf, z.B. Menge / Variante.

Default: true

 

© 2025 WEBSALE AG | Impressum | Datenschutz