Collection

Das Objekt collection hat die folgenden Attribute:

Inhalt

collection.all_products_count

Gibt die Gesamtzahl der Produkte in einer Sammlung zurück, auch wenn die Sammlung gefiltert ist.

Wenn Sie die Anzahl der Produkte in einer gefilterten Sammlung benötigen, verwenden Sie collection. products_count.

Wenn eine Sammlung zum Beispiel insgesamt 24 Produkte enthält, würde die folgende Eingabe zu folgender Ausgabe führen:

Produkte in der Sammlung insgesamt: {{ collection.all_products_count }}

Produkte in der Sammlung insgesamt: 24

collection.all_tags

Gibt eine Liste aller Produkt-Tags in einer Sammlung zurück, auch wenn die Sammlung gefiltert ist. Es können maximal 1. 000 Schilder zurückgegeben werden.

Wenn Sie die aktuell angewandten Tags wünschen, verwenden Sie collection. tags.

collection.all_types

Gibt eine Liste aller Produkttypen in einer Sammlung zurück.

Enthält eine Sammlung beispielsweise Produkte des Typs Zubehör, Stühle und Schuhe, dann würde die folgende Eingabe zu folgender Ausgabe führen:

{% for product_type in collection.all_types %}
  {{ product_type | link_to_type }}
{% endfor %}

<a href="/Sammlungen/types?q=Accessories" title="Accessories">Accessories</a>
<a href="/Sammlungen/types?q=Stühle" title="Stühle">Stühle</a>
<a href="/Sammlungen/types?q=Schuhe" title="Schuhe">Schuhe</a>

collection.all_vendors

Gibt eine Liste aller Produktlieferanten in einer Sammlung zurück.

Enthält eine Sammlung beispielsweise Produkte der Anbieter VersaCommerce, Shirt Company und Montezuma, dann würde die folgende Eingabe zu folgender Ausgabe führen:

{% for product_vendor in collection.all_vendors %}
  {{ product_vendor | link_to_vendor }}
{% endfor %}

<a href="/Sammlungen/vendors?q=VersaCommerce" title="VersaCommerce">VersaCommerce</a>
<a href="/Sammlungen/vendors?q=Shirt+Company" title="Shirt Company">Shirt Company</a>
<a href="/Sammlungen/vendors?q=Montezuma" title="Montezuma">Montezuma</a>

collection.current_type

Sie können Produkte eines bestimmten Typs unter der URL /collections/types mit einem Abfrageparameter im Format ?q=[type], wobei [type] der gewünschte Produkttyp ist. Zum Beispiel würde die folgende URL Produkte des Typs Hemden zurückgeben:

/Sammlungen/types?q=shirts
Der Abfragewert unterscheidet nicht zwischen Groß- und Kleinschreibung, so dass Hemden gleichbedeutend mit Shirts oder SHIRTS sind.

Wenn Sie sich auf einer dieser Seiten befinden, gibt collection. current_type den aktuellen Typ zurück, der abgefragt wurde. So können Sie überprüfen, ob Sie sich auf einer dieser Seiten befinden, und den aktuellen Typ wie folgt ausgeben:

{% if collection.current_type %}
  Derzeitige Ansicht {{ collection.current_type | downcase }}.
{% endif %}

Derzeitige Ansicht shirts.

collection.current_vendor

Sie können Produkte eines bestimmten Anbieters unter der URL /collections/vendors mit einem Abfrageparameter im Format ?q=[vendor], wobei [vendor] Ihr gewünschter Produktanbieter ist. Zum Beispiel würde die folgende URL Produkte des Anbieters ApparelCo:

/Sammlungen/vendors?q=apparelco
Bei der Abfrage wird die Groß- und Kleinschreibung nicht berücksichtigt, so dass apparelco gleichbedeutend mit ApparelCo oder APPARELCO ist.

Wenn Sie sich auf einer dieser Seiten befinden, gibt collection. current_vendor den aktuellen Anbieter zurück, der abgefragt wurde. So können Sie überprüfen, ob Sie sich auf einer dieser Seiten befinden, und den aktuellen Anbieter wie folgt ausgeben:

{% if collection.current_type %}
  Alle Produkte von {{ collection.current_type }}.
{% endif %}

Alle Produkte von Hemd Gmbh.

collection.default_sort_by

Gibt die Standardsortierreihenfolge der Sammlung zurück, die auf der Seite der Sammlung in der VersaCommerce-Verwaltung festgelegt ist.

Die möglichen Sortierreihenfolgen sind:

  • manual
  • best-selling
  • title-ascending
  • title-descending
  • price-ascending
  • price-descending
  • created-ascending
  • created-descending

collection.description

Gibt die Beschreibung der Sammlung zurück.

Gibt das vorgestellte Bild für die Sammlung zurück. Standardmäßig wird das Bild der Kollektion verwendet, und VersaCommerce greift dann auf ein geeignetes Bild zurück, z. B. das Bild des ersten Produkts in der Kollektion.

collection.filters

Gibt ein Array von Filterobjekten zurück, die für die Sammlung eingerichtet wurden.

Es werden nur Filter zurückgegeben, die für die aktuelle Sammlung relevant sind. Bei Sammlungen, die mehr als 1000 Produkte enthalten, sind die Filter leer.

collection.handle

Gibt das Handle der Sammlung zurück.

collection.id

Gibt die ID-Nummer der Sammlung zurück.

collection.image

Gibt das Bild der Kollektion zurück, das auf der Seite der Kollektion in der VersaCommerce-Verwaltung eingestellt ist.

Sie können den URL-Filter image_url verwenden und den HTML-Filter image_tag zum URL-Filter image_url hinzufügen, um das Bild auszugeben. Sie sollten auch prüfen, ob das Bild existiert, bevor Sie versuchen, es auszugeben.

Zum Beispiel:

{% if collection.image %}
  {{ collection.image | image_url: width: 2048 | image_tag }}
{% endif %}

collection.next_product

Gibt das Produktobjekt des nächsten Produkts in der Sammlung zurück, oder nil, wenn es kein nächstes Produkt gibt.

Sie können zum Beispiel einen Link zum nächsten Produkt in der Kollektion ausgeben:

{% if collection.next_product %}
  {{ 'Next product' | link_to: collection.next_product.url, collection.next_product.title }}
{% endif %}

collection.previous_product

Gibt das Produktobjekt des vorherigen Produkts in der Sammlung zurück, oder nil, wenn es kein vorheriges Produkt gibt.

Sie können zum Beispiel einen Link zum vorherigen Produkt in der Sammlung ausgeben:

{% if collection.previous_product %}
  {{ 'Previous product' | link_to: collection.previous_product.url, collection.previous_product.title }}
{% endif %}

collection.products

Gibt ein Array mit allen Produkten in einer Sammlung zurück.

Mit dem paginate-Tag können Sie festlegen, wie viele Produkte pro Seite angezeigt werden sollen, bis zu einer Grenze von 50.

collection.products_count

Gibt die Anzahl der Produkte in einer Sammlung zurück, die mit der aktuellen Ansicht übereinstimmen.

Wenn Sie zum Beispiel eine nach einem Tag gefilterte Sammlung betrachten und es gibt 6 Produkte mit diesem Tag, dann würde die folgende Eingabe zu folgender Ausgabe führen:

{{ collection.products_count }} products

6 products

collection.published_at

Gibt das Datum und die Uhrzeit zurück, zu der die Sammlung veröffentlicht wurde.

Sie können einen Datumsfilter verwenden, um das Datum zu formatieren.

collection.sort_by

Gibt die Sortierreihenfolge zurück, die durch den URL-Parameter sort_by auf die Sammlung angewendet wurde. Wenn es keinen URL-Parameter sort_by gibt, lautet der Wert nil.

Bei der folgenden URL zum Beispiel würde die folgende Eingabe zu folgender Ausgabe führen:

/Sammlungen/all?sort_by=best-verkaufte

{% if collection.sort_by %}
  Sort by: {{ collection.sort_by }}
{% endif %}

Sort by: best-verkaufte

collection.sort_options

Gibt ein Array von Sortieroptionen für die Sammlung zurück.

Zum Beispiel würde die folgende Eingabe zu folgender Ausgabe führen:

<select id="sort-by">
  {% assign sort_by = collection.sort_by | default: collection.default_sort_by %}

  {% for option in collection.sort_options %}
    <option value="{{ option.value }}" {% if option.value="=" sort_by %}selected="selected" endif %}> {{ option.name }} </option>
  {% endfor %}
</select>

<select id="sort_by">
  <option value="manual">Featurot</option>
  <option value="best-verkaufte">Best selling</option>
  <option value="title-ascending">Alphabetically, A-Z</option>
  <option value="title-descending">Alphabetically, Z-A</option>
  <option value="price-ascending">Price, low to high</option>
  <option value="price-descending">Price, high to low</option>
  <option value="created-ascending">Date, old to new</option>
  <option value="created-descending">Date, new to old</option>
</select>

Jede Option hat die folgenden Eigenschaften:

  • option. name
  • option. wert

option.name

Die kundenorientierte Bezeichnung für die Sortieroption, die von Händlern im Spracheditor bearbeitet werden kann.

option.value

Der Wert der Sortieroption, der der Eigenschaft sort_by in einer Formularübermittlung zugewiesen werden soll.

collection.template_suffix

Gibt den Namen der benutzerdefinierten Sammlungsvorlage zurück, die der Sammlung zugewiesen ist, ohne den collection. oder das Präfix . liquid Erweiterung. Gibt nil zurück, wenn der Sammlung keine benutzerdefinierte Vorlage zugewiesen ist.

Wenn Sie zum Beispiel eine Sammlungsvorlage mit dem Namen collection. no-price. liquid haben, würde die folgende Eingabe zu folgender Ausgabe führen:

{% if collection.template_suffix %}
  {{ collection.template_suffix }}
{% endif %}

no-price

collection.title

Gibt den Titel der Sammlung zurück.

collection.tags

Gibt die Tags zurück, die derzeit auf eine gefilterte Sammlung angewendet werden, oder nil.

collection.url

Gibt die URL der Sammlung zurück.

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