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

```liquid
{%- 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
{%- 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:

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