Startseite > Template- und Themeprogrammierung > Shop-Objekte > current

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.shopready.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.shopready.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.id

Gibt die eindeutige numerische ID des Produktes zurück.

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.list_price

Gibt den Listenpreis des Produkts zurück.

product.original_list_price

Gibt den ursprünglichen Listenpreis ohne Abzug von Rabatten zurück.

product.old_price

Gibt den kundenindividuellen alten Preis des Produktes zurück.

product.price_handle

Gibt das Handle für den Aktionspreis zurück.

product.price_title

Gibt den Titel für den Aktionspreis zurück.

product.price_description

Gibt die Beschreibung für den Aktionspreis zurück.

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.stock

Gibt den aktuellen Bestand des Produktes zurück.

product.stock_limit

Gibt die Bestands-Verkaufsgrenze des Produktes zurück.

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
    }
},