Line_item

Eine line_item stellt eine einzelne Zeile im Einkaufswagen dar. Für jede einzelne Produktvariante gibt es eine Position im Warenkorb. Das Objekt line_item kann in allen Liquid-Vorlagen über cart. items, in E-Mail-Benachrichtigungsvorlagen über line_items und auf der Bestellstatusseite des Checkouts aufgerufen werden, als auch in Anwendungen wie Order Printer.

Attribute für Geldbeträge, wie z. B. Preise und Summen, werden in der Hauswährung des Kunden (Präsentationswährung) angegeben. Verwenden Sie einen Geldfilter, um das Ergebnis als Geldbetrag anzuzeigen.

Das Objekt line_item hat die folgenden Attribute:

Inhalt

line_item.discount_allocations

Gibt eine Liste aller Rabattzuweisungen zurück, die den rabattierten Betrag und den Verweis auf den übergeordneten Rabattantrag enthält. line_item. discount_allocations ist für Einzelposten in Einkaufswagen, an der Kasse, für Bestellungen und Auftragsentwürfe verfügbar.

line_item.final_line_price

Gibt den kombinierten Preis aller Artikel in der Position zurück. Dies entspricht line_item. final_price mal line_item. quantity.

line_item.final_price

Gibt den Preis der Position einschließlich aller Rabattbeträge auf Zeilenebene zurück.

line_item.fulfillment

Gibt die Erfüllung der Belegposition zurück.

line_item.fulfillment_service

Gibt den Erfüllungsservice zurück, der mit der Variante der Position verbunden ist. Bei Positionen, die keine Erfüllungsleistung haben, wird manual zurückgegeben.

line_item.gift_card

Gibt true zurück, wenn es sich bei dem Produkt der Position um eine Geschenkkarte handelt, oder false, wenn dies nicht der Fall ist.

line_item.grams

Gibt das Gewicht der Position zurück.

Verwenden Sie den Filter weight_with_unit, um das Gewicht zu formatieren.

line_item.id

Gibt die Positions-ID zurück.

Die Einzelposten-ID ist je nach Kontext unterschiedlich:

  • cart. items gibt die ID der Variante der Belegposition zurück. Diese ID ist nicht eindeutig und kann von mehreren Artikeln der gleichen Variante gemeinsam genutzt werden.
  • checkout. line_items gibt einen temporären eindeutigen Hash zurück, der für die Kasse generiert wurde.
  • order. line_items gibt eine eindeutige ganzzahlige ID zurück.

line_item.image

Gibt das Bild der Position zurück.

Sie können den Filter image_url direkt auf die Position statt auf ihr Bildattribut anwenden. Dies generiert eine funktionierende Bild-URL für jedes Objekt mit einem Bildattribut (Variante, Produkt, Artikel, Kollektion), Bildobjekt oder Bild-SRC. Dies ist nützlich für Einzelposten, da es das Variantenbild des Artikels oder das Bild des Produkts ausgibt, wenn kein Variantenbild vorhanden ist.

Im Beispiel ist zu beachten, dass die Ausgabe dieselbe ist, unabhängig davon, ob image_url auf line_item oder line_item. image verwendet wird.

{{ line_item.image | image_url: width: 100, height: 100 | image_tag: srcset: nil }}
{{ line_item | image_url: width: 100, height: 100 | image_tag: srcset: nil }}

<img src="//cdn.versacommerce.de/s/files/1/0159/3350/products/hvt401_rot.jpg?v=1398706734&width=100&height=100&crop=center" width="100" height="100">
<img src="//cdn.versacommerce.de/s/files/1/0159/3350/products/hvt401_rot.jpg?v=1398706734&width=100&height=100&crop=center" width="100" height="100 />

line_item.key

Gibt den Positionsschlüssel zurück, einen eindeutigen Bezeichner für die Position. Der Positionsschlüssel wird aus der ID der Positionsvariante und einem Hash der Eigenschaften der Position gebildet, auch wenn die Position keine weiteren Eigenschaften hat.

{{ line_item.key }}

17285644550:70ff98a797ed385f6ef25e6e974708ca

line_item.line_level_discount_allocations

Gibt eine Liste zeilenspezifischer Rabattzuordnungen zurück, die den rabattierten Betrag und den Verweis auf die übergeordnete Rabattanwendung enthält. line_item. discount_allocations ist für Einzelposten in Einkaufswagen, an der Kasse, für Bestellungen und Auftragsentwürfe verfügbar.

line_item.line_level_total_discount

Gibt den Gesamtbetrag aller auf die betreffende Position angewandten Rabatte zurück. Dies gilt nicht für Rabatte, die dem Warenkorb hinzugefügt werden.

line_item.message

Gibt die Rabattmeldung zurück, wenn ein Script einen Rabatt auf die Position angewendet hat.

Dieses Attribut hat nur einen Wert, wenn Sie die Skript-Editor-App verwenden.

line_item.options_with_values

Gibt ein Array mit ausgewählten Werten aus den Produktoptionen des Artikels zurück.

Elemente in line_item. options_with_values können mit einer for Schleife angezeigt werden. Jede Option ist ein Schlüssel-Wert-Paar mit option. name als Option und option. value als Optionswert.

Sie können mit product. has_only_default_variant prüfen, ob die Position nur eine Standardvariante hat. Wenn dies der Fall ist, sollten die Varianteninformationen nicht angezeigt werden, da das Produkt nicht über benutzerdefinierte Variantenoptionen verfügt. 
{% unless line_item.product.has_only_default_variant %}
  
  <ul>
   
    {% for option in line_item.options_with_values %}
      
   <li>{{ option.name }}: {{ option.value }}</li>
    {% endfor %}
  
  </ul>
{% endunless %}

  <ul>
  
   <li>Größe: 42mm</li>
  
   <li>Farbe: Silver</li>
  
   <li>Material: Stainless Steel</li>

  </ul>

line_item.original_line_price

Gibt den kombinierten Preis der Menge der in der Zeile enthaltenen Artikel zurück, bevor Rabatte angewendet wurden. Dies ist gleich line_item. original_price multipliziert mit line_item. quantity.

line_item.original_price

Gibt den ursprünglichen Preis der Position zurück, bevor Rabatte angewendet wurden.

line_item.product

Gibt das Produkt der Belegposition zurück.

line_item.product_id

Gibt die ID des Produkts der Position zurück.

line_item.properties

Gibt ein Array mit benutzerdefinierten Informationen für einen Artikel zurück, der dem Warenkorb hinzugefügt wurde.

Sie können Positionseigenschaften auf Produktseiten erfassen, um Anpassungsinformationen für Produkte, wie z. B. Gravurtext, zu sammeln.

Positionseigenschaften können auf der Produktseite mit einer Eingabe im Produktformular erfasst werden. Die Eingabe muss ein Attribut name mit der folgenden Wertesyntax haben:

properties[property-name]

Mit der folgenden Eingabe können Sie zum Beispiel den Gravurtext für ein Produkt erfassen:

{% form 'product', product %}
  ...
  <label for="engravingText">Engraving<label> <input type="text" id="engravingText" name="properties[Engraving]"> ... {% endform %} </label></label>
Sie können einen Unterstrich an den Anfang eines Eigenschaftsnamens setzen, um ihn vor Kunden an der Kasse zu verbergen. Zum Beispiel: properties[_hiddenPropertyName].

Sie können die Eigenschaften ausgeben, indem Sie eine Schleife durch jedes Element im Array line_item. properties ziehen:

{% unless line_item.properties == empty %}

  <ul>
   
  {% for property in line_item.properties %}
    
   <li>{{ property.first }}: {{ property.last }}</li>
  {% endfor %}

  </ul>
{% endunless %}

  <ul>
  
   <li>Monogram: Mein Hund ist der süßeste</li>
  
   <li>Gift wrap: Yes</li>

  </ul>

line_item.quantity

Gibt die Menge der Position zurück.

line_item.requires_shipping

Gibt true zurück, wenn die Variante der Position einen Versand erfordert, oder false, wenn dies nicht der Fall ist.

line_item.selling_plan_allocation

Gibt ein selling_plan_allocation objekt zurück, wenn die Belegposition einen Verkaufsplan enthält.

Availability of selling plan information

Die Informationen zu den Verkaufsplangruppen werden nicht aufgezeichnet, nachdem eine Kasse abgeschlossen wurde. Daher sind beim Zugriff auf die selling_plan_allocation einer Position von order. line_items sind die folgenden Eigenschaften nicht verfügbar:

  • selling_plan_group_id
  • selling_plan. group_id
  • selling_plan. options
Wenn Sie Informationen zum Verkaufsplan nach dem Kauf anzeigen müssen, empfiehlt sich die Verwendung der Eigenschaft selling_plan. name.

Außerdem sind die folgenden Preiseigenschaften für ein selling_plan_allocation Objekt nicht verfügbar, wenn von order. line_items aus darauf zugegriffen wird:

  • compare_at_price
  • price_adjustments
  • selling_plan. price_adjustments

line_item.sku

Gibt die SKU (Lagerhaltungseinheit) der Variante der Position zurück.

line_item.successfully_fulfilled_quantity

Gibt die erfolgreich erfüllte Menge der Position zurück.

line_item.taxable

Gibt true zurück, wenn die Variante der Position mit Steuern belastet wird, oder false, wenn dies nicht der Fall ist.

line_item.title

Gibt den Titel der Position zurück. line_item. title kombiniert sowohl die product. title der Position als auch die variant. title der Position, getrennt durch einen Bindestrich.

{{ line_item.title }}

Ballon Shirt - M

Um nur den Produkttitel oder den Variantentitel auszugeben, können Sie auf die title der jeweiligen Variablen zugreifen.

produkt titel: {{ line_item.product.title }}
Varianten Titel: {{ line_item.variant.title }}

produkt titel: Ballon Shirt
Varianten Titel: M

line_item.unit_price

Stückpreise sind nur für Geschäfte in Deutschland oder Frankreich verfügbar.

Gibt den Stückpreis der Position zurück. Der Preis spiegelt alle Rabatte wider, die auf die Position angewendet werden.

line_item.unit_price_measurement

Gibt ein unit_price_measurement-Objekt für die Position zurück.

line_item.url

Gibt die relative URL der Variante der Position zurück. Die relative URL enthält nicht die Stamm-URL Ihres Shops ( mystore. myversacommerce. de).

line_item.url_to_remove

Gibt eine URL zurück, die zum Entfernen der Position aus dem Warenkorb verwendet werden kann. Dies gilt nur im Rahmen von Warenkorbpositionen.

line_item.variant

Gibt die Variante der Belegposition zurück.

line_item.variant_id

Gibt die ID der Variante der Position zurück.

line_item.vendor

Gibt den Verkäufer des Produkts der Position zurück.

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.