current
Das <liquid>current</liquid> Objekt enthält hochaktuelle, kundenbezogene Produkt-Attribute. Über diese können z.B. die kundenindividuellen Produktpreise des gerade angemeldeten Kunden abgerufen werden. Auch der aktuelle Bestand eines Produkts steht zur Verfügung. Der Abruf dieser Daten kann sowohl auf der Produkt-Detail-Ansicht, als auch auf Produkt-Listen erfolgen. Dazu muss an die URL ".current" angehängt werden (z.B. https://example.orbiz.com/hose-blau/.current). Die zur Verfügung stehenden Attribute können je nach Shop-Paket und Shop-Einstellungen abweichen.
Der Abruf des <liquid>current</liquid> Objekts erfolgt in Javascript mittels AJAX. Um die Resource des Shopbesuchers zu schonen, sollte dies nur wenn nötig durchgeführt werden. Um zu prüfen, ob aktuelle Daten für den angemeldeten Kunden verfügbar sind, stehen folgende Variablen in Javascript zur Verfügung:
- DT.variables.user.has_individual_prices - enthält <liquid>true</liquid>, falls der Kunde individuelle Preise besitzt
- DT.variables.user.has_individual_products - enthält <liquid>true</liquid>, falls der Kunde individuelle Produkte besitzt
Nachfolgend exemplarisch ein Aufruf mit der JavaScript-Bibliothek jQuery:
$.get("https://example.orbiz.com/hose-blau/.current", function(data){
$(data.products).each(function(index, product){
console.log(product.price);
});
});
Attribute
Das <liquid>current</liquid> Objekt besteht aus einer Liste von Produkten, welche jeweils aktuelle Attributebesitzen:
product.price
Gibt den kundenindividuellen Preis des Produktes zurück. Benutzen Sie den <cmd>currency</cmd> Filter, um den Preis im Währungsformat zurückzugeben.
product.price_from
Gibt das Startdatum für den Aktionspreis zurück. Benutzen Sie den <cmd>date</cmd> Filter um das Datum formatiert auszugeben.
product.price_till
Gibt das Enddatum für den Aktionspreis zurück. Benutzen Sie den <cmd>date</cmd> Filter um das Datum formatiert auszugeben.
product.price_tiers
Gibt die kundenindividuellen Staffelnpreise des Produktes in Form einer Liste von <obj>price_tier</obj> Objekten zurück.
product.individual
Gibt <liquid>true</liquid> zurück, falls es sich um ein kundenindividuelles Produkt handelt.
product.customer_sellable_state
Gibt den kundenindividuellen Verkaufbar-Status des Produkts zurück. Dieser kann drei unterschiedliche Werte annehmen:
- "undefined" - Kann nicht ermittelt werden, der Kunde muss ich anmelden um den Status zu ermitteln
- "sellable" - Das Produkt kann verkauft werden
- "not_sellable" - Das Produkt kann nicht verkauft werden
Beispiel
Nachfolgend sehen Sie beispielhaft einen Ausschnitt aus dem <obj>current</obj> Objekt.
{
"products": [
{
"id": 100022,
"list_price": 60,
"original_list_price": 59,
"price": 55.5,
"has_individual_price": true
}.
{
"id": 100023,
"stock": 12,
"stock_limit": 0
}
},