Başka yerden gelen geliştiriciler için Liquid temelleri

Temalar ve vitrin 8 dk okuma

Klavyenin yanında, şablon yapısının kurşun kalemle çizildiği açık bir defterin yakın çekimi
Dil bilerek küçük. Önce kenarlarını öğrenin.

Daha önce şablon yazdıysanız Liquid bir öğleden sonranızı alır. Uzun süren kısım, yapmanıza izin vermediklerini kabullenmektir; çünkü bu sınırlar bilinçlidir ve Shopify temalarının nasıl kurulduğunu şekillendirir.

Başka bir yığından Shopify projesine katılan geliştiricilere verdiğimiz giriş bu.

Zihinsel model#

Liquid bir uygulama dili değil, bir işleme dilidir. Shopify'ın verdiği nesneleri, biçimlendirme süzgeçlerini ve akış denetimi etiketlerini içerir. Veritabanına erişim, kayda değer keyfî hesaplama ve verilen nesnelerin dışına uzanma yoktur. Nesnenin içermediği bir şeye ihtiyacınız varsa cevap bir meta alan, bir uygulama ya da başka bir sayfadır.

Liquid'i genel amaçlı bir dil gibi davranmaya zorlamak için harcanan her saat, veri modeline harcanması gereken bir saattir.

Sürekli kullanacaklarınız#

Başka yerden gelen geliştiriciler için Liquid temelleri — Sürekli kullanacaklarınız
ŞeyNe işe yarar
Nesnelerproduct, collection, cart, customer, shop — sayfanın verisi
SüzgeçlerBiçimlendirme: money, date, image_url, escape
EtiketlerAkış denetimi: if, for, assign, render
Bölüm ve bloklarTema düzenleyicisinde satıcının düzenleyebildiği yapı
Meta alanlarShopify nesnelerine iliştirdiğiniz kendi yapılı verileriniz

Sık düşülen tuzaklar#

  1. Büyük koleksiyonlarda döngüler yavaş işler; Liquid içinde süzmek yerine sayfalayın.
  2. İstek başına hesapladığınız her şey her istekte hesaplanır — önbelleğe dost çıktı önemlidir.
  3. render yalıtılmış bir kapsam alır; include kullanımdan kalktı ve farklı davranır.
  4. Para kuruş olarak saklanır; elle aritmetik yerine money süzgeçlerini kullanın.
  5. Müşteriye özel içerik naif tam sayfa önbelleklemeyi engeller; bu hem performans hem doğruluk kararıdır.

Mantık nereye konmalı#

Veri şekillendirme, bir kez tanımlanıp ucuza okunan meta alanlara ve meta nesnelere aittir. Davranış bir uygulamaya ya da tarayıcıya aittir. Liquid çoğunlukla okumalı ve biçimlendirmelidir. Bu ayrımı izleyen temalar hızlı ve anlaşılır kalır.

Sıkça sorulan sorular

Liquid öğrenmesi zor mu?

Hayır — yetkin bir geliştirici bir günde üretken olur. Shopify'ın yapmanıza izin vermediklerini öğrenmek daha uzun sürer.

Liquid içinde sorgu yazabilir miyim?

Yalnız sayfanın nesne grafiğinin verdiği kadar, artı meta alanlar. Keyfî sorgulama yoktur.

Mantık Liquid'de mi JavaScript'te mi olmalı?

Sunum mantığı Liquid'de, etkileşim JavaScript'te, iş kuralları bir uygulamada ya da veri modelinizde.

shopify liquidliquid şablon dilishopify tema geliştirmeliquid temellerishopify meta alanlar

Tüm rehberler

Son güncelleme 2026-08-04 · shopifydevelopment.info · Hakkımızda

Kuranlar yazıyor

Her rehberi, Shopify mağazaları kuran ve sürdüren geliştiriciler yazar; başka sitelerden türetilmez.

Düzenli gözden geçirilir

Shopify sürekli değişiklik yayımlar. Her rehber son inceleme tarihini taşır ve hiçbir şey değişmediğinde de tarihi yayımlarız.

Ücretli yerleşim yok

Hiçbir uygulama, tema dükkânı, ajans ya da iş ortağı burada anılma, sıralama veya bağlantı satın alamaz.

On iki dil

Her rehber çevrilir, makineyle üstüne yapıştırılmaz — her dilin kendi adresi ve kendi inceleme tarihi vardır.

Sınırlar açıkça

Shopify'ın neyi değiştirmenize izin vermediğini ve kurallarınıza başka bir platformun daha iyi oturduğu durumu açıkça söyleriz.