geliştirici belgeleri

Tema filtreleri

Bir tema şablonunun kullanabildiği Liquid filtreleri.

Bu liste tema motoruna kayıtlı 158 filtredir. Listede olmayan bir filtre biticaret theme check ve yükleme için hatadır.

Filtreler anahtarlı argüman alır: image_url: width: 300.

Para

Fiyatlar kuruş cinsinden tam sayıdır; bu filtreler onları mağazanın para biçimiyle yazar.

Filtre Ne yapar Örnek
money Mağazanın biçimiyle tutar. {{ product.price | money }}
money_with_currency Tutar, para biriminin koduyla. {{ cart.total_price | money_with_currency }}
money_without_currency Yalnızca tutar. {{ product.price | money_without_currency }}
money_without_trailing_zeros Tutar, sondaki sıfır kuruşlar olmadan. {{ product.price | money_without_trailing_zeros }}
money_amount Biçimlenmiş tutar, simgesiz. {{ product.price | money_amount }}
unit_price_with_measurement Birim fiyatı ölçüsüyle yazar. {{ variant.unit_price | money | unit_price_with_measurement: variant.unit_price_measurement }}
currency_selector Para birimi seçimi için bir <select>. {{ form | currency_selector }}

Görsel ve medya

Filtre Ne yapar Örnek
image_url Bir görselin istenen boyuttaki adresi (width, height, crop). {{ product.featured_media | image_url: width: 800 }}
image_tag Bir görsel adresinden <img>. {{ product.featured_media | image_url: width: 400 | image_tag: loading: 'lazy' }}
img_url image_url'un eski hali; boyutu adla alır. {{ product.featured_image | img_url: '400x' }}
img_tag image_tag'in eski hali. {{ product.featured_image | img_url: '400x' | img_tag }}
product_img_url, collection_img_url, article_img_url img_url'un kaynağa özel eski adları. {{ product.featured_image | product_img_url: '400x' }}
media_tag Medyayı türüne göre yazar (görsel, video, dış video, model). {{ media | media_tag }}
video_tag Yüklenmiş bir videodan <video>. {{ section.settings.video | video_tag: controls: true }}
external_video_url YouTube veya Vimeo videosunun gömme adresi. {{ media | external_video_url: autoplay: true }}
external_video_tag Dış video için <iframe>. {{ media | external_video_url | external_video_tag }}
model_viewer_tag 3B model için <model-viewer>. {{ media | model_viewer_tag }}
placeholder_svg_tag Yer tutucu bir SVG çizim. {{ 'product-1' | placeholder_svg_tag }}
payment_type_img_url Bir ödeme türünün simgesinin adresi. {{ type | payment_type_img_url }}
payment_type_svg_tag Bir ödeme türünün simgesi, SVG olarak. {{ type | payment_type_svg_tag }}

Varlık ve dosya adresleri

Filtre Ne yapar Örnek
asset_url Temanın assets/ klasöründeki dosyanın adresi, ?v= ile. {{ 'base.css' | asset_url }}
asset_img_url Temanın bir görsel varlığının boyutlu adresi. {{ 'logo.png' | asset_img_url: '300x' }}
file_url Mağazanın dosyalarından birinin adresi. {{ 'katalog.pdf' | file_url }}
file_img_url Mağazanın dosyalarındaki bir görselin boyutlu adresi. {{ 'afis.jpg' | file_img_url: '600x' }}
biticaret_asset_url Platformun ortak varlıklarından birinin adresi. {{ 'option_selection.js' | biticaret_asset_url }}
global_asset_url Platformun genel varlık adresi. {{ 'x.js' | global_asset_url }}
inline_asset_content Bir varlığın içeriğini sayfaya yazar (SVG, CSS, JavaScript). {{ 'icon-cart.svg' | inline_asset_content }}
stylesheet_tag Bir adresten <link rel="stylesheet">. {{ 'base.css' | asset_url | stylesheet_tag }}
script_tag Bir adresten <script>. {{ 'theme.js' | asset_url | script_tag }}
preload_tag Bir adresten <link rel="preload">. {{ 'base.css' | asset_url | preload_tag: as: 'style' }}

Bağlantılar

Filtre Ne yapar Örnek
link_to Bir metinden <a>. {{ 'Sepet' | link_to: routes.cart_url }}
link_to_type Ürün türünün koleksiyonuna bağlantı. {{ product.type | link_to_type }}
link_to_vendor Markanın koleksiyonuna bağlantı. {{ product.vendor | link_to_vendor }}
url_for_type Ürün türünün koleksiyon adresi. {{ product.type | url_for_type }}
url_for_vendor Markanın koleksiyon adresi. {{ product.vendor | url_for_vendor }}
link_to_tag Koleksiyonu bir etikete süzen bağlantı. {{ tag | link_to_tag: tag }}
link_to_add_tag Seçili etiketlere bir etiket ekleyen bağlantı. {{ tag | link_to_add_tag: tag }}
link_to_remove_tag Seçili etiketlerden birini çıkaran bağlantı. {{ tag | link_to_remove_tag: tag }}
highlight_active_tag Seçili etiketi bir <span class="active"> içine alır. {{ tag | highlight_active_tag }}
within Bir ürün adresini koleksiyonun içine alır. {{ product.url | within: collection }}
sort_by Bir koleksiyon adresine sıralama ekler. {{ collection.url | sort_by: 'price-ascending' }}
customer_login_link Giriş sayfasına bağlantı. {{ 'Giriş yap' | customer_login_link }}
customer_logout_link Çıkış bağlantısı. {{ 'Çıkış' | customer_logout_link }}
customer_register_link Üyelik sayfasına bağlantı. {{ 'Üye ol' | customer_register_link }}

Çeviri, tarih ve biçim

Filtre Ne yapar Örnek
t, translate locales/ içinden bir metin; değişken ve çoğul (count) alır. {{ 'general.skip_to_content' | t }}
date Bir tarihi biçimler. {{ order.created_at | date: '%d.%m.%Y' }}
time_tag Bir tarihten <time>. {{ order.created_at | time_tag }}
format_address Bir adresi satırlarıyla yazar. {{ customer.default_address | format_address }}
weight_with_unit Gram cinsinden ağırlığı birimiyle yazar. {{ variant.weight | weight_with_unit }}
pluralize Sayıya göre tekil veya çoğul sözcük. {{ cart.item_count | pluralize: 'item', 'items' }}
default_pagination paginate nesnesinden sayfa bağlantıları. {{ paginate | default_pagination }}
default_errors Bir formun hatalarını liste olarak yazar. {{ form.errors | default_errors }}
structured_data Bir ürünün yapılandırılmış verisi (JSON-LD içeriği). {{ product | structured_data }}
json Bir değeri JSON olarak yazar. {{ product.variants | json }}
highlight Bir metinde arama terimini işaretler. {{ item.title | highlight: search.terms }}
class_list Bir ayar değerinden CSS sınıfları. {{ section.settings | class_list }}

Sepet

Filtre Ne yapar Örnek
item_count_for_variant Sepette bir varyanttan kaç adet olduğu. {{ cart | item_count_for_variant: variant.id }}
line_items_for Sepetin bir ürüne veya varyanta ait satırları. {{ cart | line_items_for: product }}

Yazı tipleri

Filtre Ne yapar Örnek
font_face Bir yazı tipi için @font-face kuralı. {{ settings.type_body_font | font_face: font_display: 'swap' }}
font_modify Yazı tipinin başka bir kalınlığı veya stili. {{ settings.type_body_font | font_modify: 'weight', 'bold' }}
font_url Yazı tipi dosyasının adresi. {{ settings.type_body_font | font_url }}

Renkler

Filtre Ne yapar Örnek
color_to_rgb Rengi rgb() olarak yazar. {{ settings.color_text | color_to_rgb }}
color_to_hex Rengi onaltılık yazar. {{ settings.color_text | color_to_hex }}
color_to_hsl Rengi hsl() olarak yazar. {{ settings.color_text | color_to_hsl }}
color_to_oklch Rengi oklch() olarak yazar. {{ settings.color_text | color_to_oklch }}
color_extract Rengin bir bileşeni. {{ settings.color_text | color_extract: 'red' }}
color_modify Rengin bir bileşenini değiştirir. {{ settings.color_text | color_modify: 'alpha', 0.5 }}
color_lighten Rengi açar. {{ settings.color_accent | color_lighten: 20 }}
color_darken Rengi koyulaştırır. {{ settings.color_accent | color_darken: 20 }}
color_saturate Doygunluğu artırır. {{ settings.color_accent | color_saturate: 20 }}
color_desaturate Doygunluğu azaltır. {{ settings.color_accent | color_desaturate: 20 }}
color_mix İki rengi karıştırır. {{ settings.color_text | color_mix: settings.color_background, 50 }}
color_brightness Rengin algılanan parlaklığı. {{ settings.color_background | color_brightness }}
color_contrast İki rengin kontrast oranı. {{ settings.color_text | color_contrast: settings.color_background }}
color_difference İki rengin renk farkı. {{ settings.color_text | color_difference: settings.color_background }}
brightness_difference İki rengin parlaklık farkı. {{ settings.color_text | brightness_difference: settings.color_background }}
hex_to_rgba Onaltılık rengi rgba() olarak yazar; saydamlık alır. {{ '#1a1a1a' | hex_to_rgba: 0.5 }}

Metin

upcase, downcase ve capitalize, mağazanın dili Türkçe ise Türkçe kurallarıyla çalışır (İ ↔ i, I ↔ ı).

Filtre Ne yapar Örnek
append Sona ekler. {{ product.handle | append: '.jpg' }}
prepend Başa ekler. {{ product.title | prepend: '★ ' }}
upcase Büyük harfe çevirir. {{ product.vendor | upcase }}
downcase Küçük harfe çevirir. {{ product.vendor | downcase }}
capitalize İlk harfi büyütür. {{ product.type | capitalize }}
camelize Sözcükleri birleştirip baş harflerini büyütür. {{ 'ana-menu' | camelize }}
handle, handleize Metni tanıtıcıya çevirir. {{ product.title | handleize }}
escape, h HTML karakterlerini kaçırır. {{ section.settings.heading | escape }}
escape_once Kaçırılmış olanları yeniden kaçırmadan kaçırır. {{ page.title | escape_once }}
strip_html HTML etiketlerini siler. {{ product.description | strip_html }}
strip_newlines Satır sonlarını siler. {{ product.description | strip_newlines }}
newline_to_br Satır sonlarını <br> yapar. {{ cart.note | newline_to_br }}
strip, lstrip, rstrip Baştaki ve sondaki, yalnızca baştaki, yalnızca sondaki boşluğu siler. {{ cart.note | strip }}
squish Boşluk dizilerini tek boşluğa indirir ve kırpar. {{ product.title | squish }}
truncate Metni karakter sayısına göre keser. {{ product.title | truncate: 40 }}
truncatewords Metni sözcük sayısına göre keser. {{ product.description | strip_html | truncatewords: 20 }}
replace, replace_first, replace_last Bir parçayı değiştirir: hepsini, ilkini, sonuncusunu. {{ product.title | replace: '-', ' ' }}
remove, remove_first, remove_last Bir parçayı siler: hepsini, ilkini, sonuncusunu. {{ product.title | remove: '!' }}
split Metni bir ayraçla listeye böler. {{ product.tags | join: ',' | split: ',' }}
slice Bir metnin veya listenin parçası. {{ product.title | slice: 0, 10 }}
size Metnin veya listenin uzunluğu. {{ product.tags | size }}
url_encode Adres için kodlar. {{ search.terms | url_encode }}
url_decode Adres kodlamasını çözer. {{ 'a%20b' | url_decode }}
url_escape Bir adresteki geçersiz karakterleri kodlar. {{ link.url | url_escape }}
url_param_escape Bir sorgu değerini kodlar. {{ search.terms | url_param_escape }}
base64_encode, base64_decode Base64 kodlar, çözer. {{ 'metin' | base64_encode }}
base64_url_safe_encode, base64_url_safe_decode Adrese uygun Base64 kodlar, çözer. {{ 'metin' | base64_url_safe_encode }}
md5, sha1, sha256 Metnin özeti. {{ customer.email | sha256 }}
hmac_sha1, hmac_sha256 Bir anahtarla HMAC. {{ 'metin' | hmac_sha256: 'anahtar' }}
default Değer boşsa yerine geçeni verir. {{ section.settings.heading | default: shop.name }}

Sayılar

Filtre Ne yapar Örnek
plus, minus Toplar, çıkarır. {{ cart.item_count | plus: 1 }}
times, divided_by Çarpar, böler. {{ product.price | times: 2 }}
modulo Bölümden kalan. {{ forloop.index | modulo: 2 }}
abs Mutlak değer. {{ -5 | abs }}
ceil, floor, round Yukarı, aşağı, en yakına yuvarlar. {{ 4.6 | round }}
at_least, at_most Değeri bir alt, bir üst sınırla tutar. {{ cart.item_count | at_most: 99 }}

Listeler

Filtre Ne yapar Örnek
first, last İlk, son öğe. {{ product.images | first }}
join Öğeleri bir ayraçla birleştirir. {{ product.tags | join: ', ' }}
map Her öğenin bir alanı. {{ collection.products | map: 'title' | join: ', ' }}
where Bir alanı verilen değerde olan öğeler. {{ collection.products | where: 'available', true }}
reject where'in tersi. {{ collection.products | reject: 'available', false }}
find Koşula uyan ilk öğe. {{ product.variants | find: 'available', true }}
find_index Koşula uyan ilk öğenin sırası. {{ product.variants | find_index: 'available', true }}
has Koşula uyan bir öğe var mı. {{ product.variants | has: 'available', true }}
sort Sıralar; bir alana göre de. {{ collection.products | sort: 'price' }}
sort_natural Büyük küçük harfe bakmadan sıralar. {{ collection.all_tags | sort_natural }}
reverse Sırayı ters çevirir. {{ product.images | reverse }}
uniq Yinelenenleri atar. {{ collection.products | map: 'vendor' | uniq }}
compact Boş öğeleri atar. {{ collection.products | map: 'featured_image' | compact }}
concat İki listeyi birleştirir. {{ product.tags | concat: collection.all_tags }}
sum Öğeleri veya bir alanlarını toplar. {{ cart.items | sum: 'quantity' }}

Kabul edilen ama çıktı vermeyenler

Bu filtreler tanınır, yani denetimden geçer, ama bugün boş metin yazar: payment_button, payment_terms, avatar, login_button, metafield_tag, metafield_text.

Hata ayıklama

Filtre Ne yapar Örnek
inspect Değerin iç görünümünü yazar. {{ product.tags | inspect }}
type Değerin motordaki türünü yazar. {{ product.price | type }}