geliştirici belgeleri

Tema etiketleri

Bir tema şablonunun kullanabildiği Liquid etiketleri.

Bu liste tema motoruna kayıtlı etiketlerdir. Bilinmeyen bir etiket biticaret theme check ve yükleme için hatadır.

Çizim sırasında bir etiketteki hata sayfayı durdurmaz: o etiketin yerine Liquid error (sections/x.liquid line 3): … yazılır ve sayfanın kalanı çizilir.

Tema etiketleri

Etiket Ne yapar Örnek
section Bir bölümü adıyla çizer. {% section 'header' %}
sections Bir bölüm grubunu çizer. {% sections 'header-group' %}
content_for Tema bloklarını çizer: 'blocks' hepsini, 'block' birini. {% content_for 'blocks' %}
render Bir parçayı (snippets/) kendi değişkenleriyle çizer; with, for ve as alır. {% render 'product-card', product: product %}
include render'ın eski hali; çağıranın değişkenlerini görür. Yeni kodda render kullanın. {% include 'product-card' %}
layout Şablonun düzenini seçer; none düzensiz çizer. {% layout 'password' %}
form Platformun bir formunu, doğru adres ve gizli alanlarla açar. {% form 'product', product %}…{% endform %}
paginate Bir listeyi sayfalara böler ve paginate nesnesini verir. {% paginate collection.products by 24 %}…{% endpaginate %}
schema Bölümün veya bloğun ayar tanımı (JSON); çıktı vermez. {% schema %}{ "name": "…" }{% endschema %}
style İçeriğini bir <style> öğesinde yazar; içinde Liquid çalışır. {% style %}:root { --page-width: {{ settings.page_width }}px; }{% endstyle %}
stylesheet Bölümün CSS'i; temanın paketine derlenir, yerinde çıktı vermez. {% stylesheet %}.card { … }{% endstylesheet %}
javascript Bölümün JavaScript'i; temanın paketine derlenir, yerinde çıktı vermez. {% javascript %}…{% endjavascript %}

form türleri

Tür Adres
product /cart/add
cart /cart
contact, customer /contact
localization /localization
currency /cart/update
storefront_password /password
customer_login, guest_login /account/login
create_customer /account
recover_customer_password /account/recover
reset_customer_password /account/reset
activate_customer_password /account/activate
customer_address /account/addresses
new_comment /comments

create_customer, recover_customer_password, reset_customer_password, activate_customer_password ve new_comment formları çizilir ama platform bu adreslere gönderim almaz: müşteriler şifreyle değil e-postalarına gelen kodla giriş yapar ve blog yorumları yoktur. customer_login formu yalnızca email (veya customer[email]) alanını okur ve giriş kodunu gönderir.

Müşterinin hesabını değiştiren veya mesaj gönderen formlar (iletişim, giriş, adres) giriş yapmış müşteri için gizli bir authenticity_token alanı taşır; misafirin gönderimleri adresin geldiği sayfayla denetlenir. Sepet, ürün, para birimi ve localization formları belirteç taşımaz, yalnızca mağazanın kendi sayfalarından kabul edilir.

{%- form 'product', product, class: 'form' -%}
  <input type="hidden" name="id" value="{{ current.id }}">
  <label>{{ 'products.product.quantity' | t }} <input type="number" name="quantity" value="1" min="1"></label>
  <button class="button" type="submit">{{ 'products.product.add_to_cart' | t }}</button>
{%- endform -%}

Değişkenler

Etiket Ne yapar Örnek
assign Bir değişken tanımlar. {% assign current = product.selected_or_first_available_variant %}
capture İçeriğini bir değişkene yazar. {% capture label %}{{ product.title }}{% endcapture %}
increment Bir sayacı yazar ve bir artırır. {% increment counter %}
decrement Bir sayacı bir azaltır ve yazar. {% decrement counter %}
echo {{ … }} gibi yazar; {% liquid %} içinde kullanılır. {% echo product.title %}
liquid Birden çok etiketi ayraçsız, satır satır yazar. Aşağıda
{%- liquid
  assign featured = section.settings.collection
  if featured == blank
    assign featured = collections.all
  endif
-%}

Koşullar

Etiket Ne yapar Örnek
if, elsif, else Koşul doğruysa çizer. {% if product.available %}…{% else %}…{% endif %}
unless Koşul yanlışsa çizer. {% unless variant.available %} disabled{% endunless %}
case, when, else Bir değere göre dallanır. {% case template.name %}{% when 'product' %}…{% endcase %}
ifchanged İçeriği önceki turdakinden farklıysa çizer. {% ifchanged %}{{ product.vendor }}{% endifchanged %}

Döngüler

Etiket Ne yapar Örnek
for, else Bir listeyi dolaşır; liste boşsa else çizilir. limit, offset ve reversed alır. {% for product in featured.products limit: 8 %}…{% endfor %}
break Döngüden çıkar. {% break %}
continue Sonraki tura geçer. {% continue %}
cycle Her turda sıradaki değeri yazar. {% cycle 'odd', 'even' %}
tablerow Bir listeyi tablo satırları olarak yazar; cols alır. {% tablerow product in collection.products cols: 3 %}…{% endtablerow %}

Yorum ve ham metin

Etiket Ne yapar Örnek
comment İçeriği çizmez. {% comment %}…{% endcomment %}
# Tek satırlık yorum. {% # açıklama %}
doc Parçanın belgesi; çizilmez. {% doc %}…{% enddoc %}
raw İçeriği Liquid olarak işlemeden yazar. {% raw %}{{ olduğu gibi }}{% endraw %}

Boşluk denetimi

{%-, -%}, {{- ve -}} ayraçları o yandaki boşluğu siler:

{%- if product.featured_media -%}
  <div class="product__media">{{ product.featured_media | image_url: width: 800 | image_tag: loading: 'lazy' }}</div>
{%- endif -%}