geliştirici belgeleri

Tema nesneleri

Bir tema şablonunun kullanabildiği nesneler ve alanları.

Bu liste tema motorunun kodundan çıkarılmıştır: her nesnenin burada yazan alanları motorun yanıtladığı alanlardır. Fiyatlar kuruş cinsinden tam sayıdır; money filtreleriyle yazdırın.

Her sayfada

Nesne Ne Örnek
shop Mağaza. {{ shop.name }}
settings Temanın genel ayarları (config/settings_data.json). {{ settings.color_background }}
request İstek. {{ request.locale.iso_code }}
routes Vitrinin adresleri. {{ routes.cart_url }}
template Çizilen şablon. {{ template.name }}
theme Tema. {{ theme.name }}
localization Mağazanın ülkeleri ve dilleri. {{ localization.language.iso_code }}
cart Ziyaretçinin sepeti. {{ cart.item_count }}
customer Giriş yapmış müşteri; giriş yoksa boş. {% if customer %}{{ customer.first_name }}{% endif %}
collections Koleksiyonlar; tanıtıcıyla da okunur. {{ collections.all.products_count }}
all_products Tanıtıcıyla bir ürün. Bir sayfada en çok 20 farklı ürün yükler. {{ all_products['kupa'].title }}
linklists Menüler, tanıtıcıyla. {% for link in linklists['main-menu'].links %}
pages İçerik sayfaları, tanıtıcıyla. {{ pages['hakkimizda'].content }}
blogs Bloglar; tanıtıcıyla da okunur. {% for article in blogs['haberler'].articles limit: 3 %}
articles Blog yazıları, blog/yazı tanıtıcısıyla. {{ articles['haberler/ilk-yazi'].title }}
images Mağazanın dosyalarındaki görseller, adla. {{ images['logo.png'] | image_url: width: 200 }}
content_for_header Platformun <head> içeriği; düzende zorunlu. {{ content_for_header }}
content_for_layout Şablonun çıktısı; düzende zorunlu. {{ content_for_layout }}
canonical_url Sayfanın asıl adresi. <link rel="canonical" href="{{ canonical_url }}">
page_title Sayfanın başlığı. <title>{{ page_title }}</title>
page_description Sayfanın açıklaması. {{ page_description | escape }}
page_image Sayfanın paylaşım görseli. {{ page_image | image_url: width: 1200 }}
current_page Sayfalamadaki sayfa numarası. {{ current_page }}
current_tags Koleksiyon ve blog sayfasında seçili etiketler. {% if current_tags contains tag %}
handle Sayfadaki kaynağın tanıtıcısı. {{ handle }}
powered_by_link Platformun bağlantısı. {{ powered_by_link }}
country_option_tags, all_country_option_tags Ülke seçimi için <option> öğeleri. <select>{{ country_option_tags }}</select>
recommendations Ürün önerileri (/recommendations/products ile çizilen bölümde dolu). {% if recommendations.performed %}
closest Sayfaya en yakın kaynaklar: closest.product, closest.collection, closest.page, closest.blog, closest.article. {{ closest.product.title }}

scripts tanımlıdır ama boştur; additional_checkout_buttons her zaman yanlıştır.

Şablonun kendi nesnesi de her dosyadan görülür: ürün sayfasında product, koleksiyon sayfasında collection, içerik sayfasında page, blog sayfasında blog, yazı sayfasında blog ve article, aramada search, hediye kartı sayfasında gift_card, arama önerilerinde predictive_search.

Bölüm ve blok

Nesne Alanlar
section id, settings, blocks, index, index0, location
block id, type, settings, blocks, biticaret_attributes
<h2>{{ section.settings.heading | escape }}</h2>

Etiketlerin verdiği nesneler

Nesne Nerede Alanlar
forloop {% for %} içinde name, length, parentloop, index, index0, rindex, rindex0, first, last
tablerowloop {% tablerow %} içinde length, col, col0, row, index, index0, rindex, rindex0, first, last, col_first, col_last
paginate {% paginate %} içinde current_page, current_offset, items, pages, page_size, page_param, parts, previous, next
form {% form %} içinde id, posted_successfully?, errors, set_as_default_checkbox, password_needed ve formun kendi alanları

Form hataları (form.errors): messages, translated_fields, size.

{%- paginate collection.products by 24 -%}
  {%- if paginate.pages > 1 %}{{ paginate | default_pagination }}{% endif -%}
{%- endpaginate -%}

Mağaza

shop: id, name, description, email, phone, domain, permanent_domain, url, secure_url, currency, money_format, money_with_currency_format, locale, taxes_included, address, password_message, customer_accounts_enabled, customer_accounts_optional, accepts_gift_cards, enabled_payment_types, enabled_currencies, published_locales, enabled_locales, policies, privacy_policy, refund_policy, shipping_policy, terms_of_service, subscription_policy, contact_information, legal_notice, products_count, collections_count, types, vendors, search_types, metafields, brand.

Politika (shop.privacy_policy ve diğerleri): id, title, body, url, handle.

request: design_mode, visual_preview_mode, host, origin, path, page_type, locale.

routes: root_url, account_url, account_login_url, account_logout_url, account_register_url, account_recover_url, account_addresses_url, account_profile_url, storefront_login_url, collections_url, all_products_collection_url, search_url, predictive_search_url, cart_url, cart_add_url, cart_change_url, cart_clear_url, cart_update_url, product_recommendations_url.

<a href="{{ routes.cart_url }}">{{ 'general.cart' | t }} ({{ cart.item_count }})</a>

template: name, suffix, directory.

theme: id, name, role.

localization: available_countries, available_languages, country, language, market.

Ülke (localization.country): iso_code, name, continent, currency, unit_system, popular?, available_languages, market.

Pazar (localization.market): id, handle, name, metafields.

Ürün

product: id, handle, title, type, vendor, description, content, tags, template_suffix, url, created_at, published_at, updated_at, price, price_min, price_max, price_varies, compare_at_price, compare_at_price_min, compare_at_price_max, compare_at_price_varies, available, variants, variants_count, has_only_default_variant, first_available_variant, selected_variant, selected_or_first_available_variant, options, options_with_values, options_by_name, featured_image, featured_media, images, media, collections, metafields, category, gift_card?, selling_plan_groups, selected_selling_plan, selected_selling_plan_allocation, selected_or_first_available_selling_plan_allocation, requires_selling_plan, quantity_price_breaks_configured?.

Bir ürünün en çok 2 048 varyantı olabilir. product.variants ve product | json ilk 250 varyantı verir; variants_count, fiyatlar, seçenek değerleri ve ?variant= parametresi bütün varyantları kapsar, /products/<ürün>.js hepsini listeler.

Ürün, varyant ve sepet satırındaki abonelik ve adet fiyatı alanları (selling_plan_…, requires_selling_plan, quantity_price_breaks…) yanıtlanır ama boştur; platformda abonelik satışı yoktur.

{%- assign current = product.selected_or_first_available_variant -%}
<h1>{{ product.title }}</h1>
<p>
  {{ current.price | money }}
  {%- if current.compare_at_price > current.price %} <s>{{ current.compare_at_price | money }}</s>{% endif %}
</p>

Varyant (product.variants): id, title, sku, barcode, available, selected, matched, url, price, compare_at_price, unit_price, unit_price_measurement, inventory_management, inventory_policy, inventory_quantity, image, featured_image, featured_media, options, options_with_values, option1, option2, option3, requires_shipping, taxable, weight, weight_unit, weight_in_unit, metafields, product, position, quantity_rule, store_availabilities, incoming, next_incoming_date, selected_selling_plan_allocation, selling_plan_allocations, requires_selling_plan, quantity_price_breaks, quantity_price_breaks_configured?.

Seçenek (product.options_with_values): name, position, values, selected_value.

Seçenek değeri: id, name, selected, available, variant, product_url, swatch.

Görsel (product.featured_image, product.images): id, alt, src, width, height, aspect_ratio, presentation, media_type, position, product_id, variants, attached_to_variant?, preview_image, url.

Odak noktası (image.presentation.focal_point): x, y.

Medya (product.media): id, alt, media_type, position, preview_image, aspect_ratio, host, external_id, duration, sources.

Video adresi (video_url türündeki ayar): id, type.

Koleksiyon

collection: id, handle, title, description, url, published_at, updated_at, template_suffix, image, featured_image, metafields, products, products_count, all_products_count, all_tags, all_types, all_vendors, tags, current_type, current_vendor, default_sort_by, sort_by, sort_options, filters, next_product, previous_product.

next_product ve previous_product, /collections/<koleksiyon>/products/<ürün> adresiyle açılan ürün sayfasında doludur.

Filtre (collection.filters, search.filters): label, param_name, type, operator, presentation, values, active_values, inactive_values, true_value, false_value, min_value, max_value, range_max, url_to_remove.

Filtre değeri: active, value, label, count, param_name, image, swatch, url_to_add, url_to_remove.

İçerik ve menüler

page: id, handle, title, content, author, url, published_at, created_at, updated_at, template_suffix, metafields.

blog: id, handle, title, url, articles, articles_count, all_tags, tags, comments_enabled?, moderated?, next_article, previous_article, template_suffix, metafields.

blog.articles en yeniden eskiye sıralıdır ve paginate ile sayfalanır; /blogs/<blog>/tagged/<etiket> adresinde yalnızca o etiketli yazıları verir ve blog.tags seçili etiketlerdir. next_article (daha eski) ve previous_article (daha yeni) yazı sayfasında doludur.

article: id, handle, title, author, content, excerpt, excerpt_or_content, image, tags, url, published_at, created_at, updated_at, template_suffix, user, comments, comments_count, comments_enabled?, moderated?, comment_post_url, metafields.

Yorumlar yoktur: comments boştur, comments_count sıfırdır, comments_enabled? yanlıştır.

Yazar (article.user): name, first_name, last_name, account_owner, bio, email, homepage, image. Adlar yazının yazar alanından gelir; ötekiler boştur.

{%- paginate blog.articles by 6 -%}
  {%- for article in blog.articles -%}
    <h2><a href="{{ article.url }}">{{ article.title }}</a></h2>
    {{ article.excerpt_or_content | strip_html | truncate: 160 }}
  {%- endfor -%}
  {{ paginate | default_pagination }}
{%- endpaginate -%}

Menü (linklists['<tanıtıcı>']): handle, title, id, links, levels.

Bağlantı (linklist.links): title, url, handle, links, levels, active, current, child_active, child_current, type, object, data_sharing_opt_out_icon.

{%- for link in section.settings.menu.links -%}
  <li><a href="{{ link.url }}"{% if link.current %} aria-current="page"{% endif %}>{{ link.title }}</a></li>
{%- endfor -%}

Sepet

cart: items, item_count, empty?, items_subtotal_price, original_total_price, total_price, checkout_charge_amount, total_discount, discount_applications, cart_level_discount_applications, discounts, attributes, note, currency, requires_shipping, taxes_included, duties_included, total_weight, token, company_location.

Sepet satırı (cart.items): id, key, quantity, product, product_id, variant, variant_id, title, sku, vendor, url, url_to_remove, image, options_with_values, properties, original_price, price, original_line_price, line_price, final_price, final_line_price, line_level_total_discount, total_discount, discount_allocations, line_level_discount_allocations, discounts, tax_lines, message, unit_price, unit_price_measurement, error_message, components, gift_card, requires_shipping, taxable, grams, selling_plan_allocation, fulfillment, fulfillment_service, successfully_fulfilled_quantity.

Şirket konumu (cart.company_location, şirket adına alışverişte): id, name, company_name, payment_terms, tax_exempt.

Müşteri

customer: id, email, first_name, last_name, name, phone, accepts_marketing, accepts_sms_marketing, has_account, tax_exempt, b2b?, tags, orders_count, total_spent, default_address, addresses, addresses_count, orders, last_order, store_credit_account, gift_cards, metafields.

Müşterinin siparişi (customer.orders): id, name, order_number, created_at, cancelled, cancelled_at, financial_status, fulfillment_status, total_price, cash_total_price, installment_count, installment_markup, customer_url, shipping_method (title, delivery_method), delivery_method (shipping, pickup veya local_delivery), pickup_location (mağazadan teslim alınacak siparişte konumun name, address, instructions, ready_in alanları), payment_terms, attributes (siparişin sepet özellikleri; hediye siparişinde Hediye, Hediye notu, Fiyatları gizle).

Adres (customer.default_address, shop.address): id, first_name, last_name, name, company, address1, address2, street, city, province, province_code, zip, country, country_code, phone, summary.

Arama

search: performed, terms, results, results_count, types, filters, sort_by, default_sort_by, sort_options.

predictive_search: performed, terms, types, resources (products, collections, pages, articles, queries).

recommendations: performed, performed?, products, products_count, intent.

Hediye kartı

gift_card (/gift_cards/<jeton> sayfasında): balance, initial_value, currency, enabled, expired, expires_on, last_four_characters, code, url, qr_identifier, pass_url, customer, product, send_on, message, recipient, template_suffix, properties, created_at.

Hediye kartının müşterisi (gift_card.customer): name.

Mağaza kredisi (customer.store_credit_account): balance, currency.

Meta alanlar

product, varyant, collection, blog, article, customer ve shop nesnelerinin metafields alanı ad alanı ve anahtarla okunur. page.metafields boştur.

value, türüne göre değerdir: sayı, doğru/yanlış, tarih veya metin; json ve rating türlerinde nesne. Başvuru türlerinde (product_reference, variant_reference, collection_reference, page_reference, blog_reference, article_reference, file_reference, metaobject_reference ve list. ile başlayan liste halleri) value başvurulan nesnedir, liste türlerinde nesnelerin listesidir; mağazada bulunamayan kayıtlar atlanır. file_reference bir görsel veya video medyasıdır. customer_reference vitrinde her zaman boştur: bir müşterinin kaydı başkasına gösterilmez.

Meta alan: value, type, namespace, key, list?.

{{ product.metafields.custom.care_guide.value }}

app (uygulama bloklarında): metafields, uygulamanın kendi meta alanları.

Özel veriler

Mağazanın özel veri türleri (Ayarlar → Özel veriler) metaobjects.<tür> ile okunur: metaobjects.<tür>.<kayıt adresi> bir kayıt, metaobjects.<tür>.values türün kayıtları (en çok 250). Vitrin yalnızca etkin kayıtları gösterir; taslaklar bulunmaz.

Özel veri kaydı (metaobject): system.

Kaydın sistem alanları (metaobject.system): handle, type, id, url.

Kaydın her alanı anahtarıyla bir meta alandır: .value türüne göre değerdir, alanın kendisi de değerini yazar. url yalnızca türün web sayfaları açıksa doludur.

metaobject_reference türündeki bir meta alanın value değeri kaydın kendisidir; list.metaobject_reference için kayıtların listesidir. Web sayfaları açık bir türün kaydı /pages/<tür adresi>/<kayıt adresi> adresinde templates/metaobject/<tür>.json (ya da .liquid) şablonuyla çizilir; şablonda kayıt metaobject nesnesidir. Şablon yoksa adres 404 verir.

{% for book in metaobjects.book.values %}{{ book.title.value }}{% endfor %}
{{ metaobjects.book.dune.author }}
{% for b in product.metafields.custom.books.value %}<a href="{{ b.system.url }}">{{ b.title }}</a>{% endfor %}

Ayar değerleri

Renk (color türündeki ayar): red, green, blue, alpha, hue, saturation, lightness, chroma, color_space, rgb, rgba, oklch, oklcha.

Renk şeması (color_scheme türündeki ayar): id, settings.

Yazı tipi (font_picker türündeki ayar): family, fallback_families, style, weight, baseline_ratio, system?, system, variants.