Liquid referansı

Bu sayfa, kendi temanı ya da alt temanı yazarken kullanacağın Liquid değişkenlerini, filtrelerini ve şablon adlarını listeler. Temanın klasör yapısı, theme.json ve alt temalar için önce Kendi temanı geliştirmek makalesini oku.

Temel kurallar#

• {{ … }} ile basılan her değer otomatik olarak HTML'e karşı korunur (kaçışlanır). Site sahibinin panelde yazdığı ve kaydederken temizlenen HTML içerikleri (sayfa, blog yazısı, popup metni gibi) | raw ile basılır: {{ page.content | raw }}.
• Yalnız bu sayfadaki BorCube filtreleri ve Liquid'in standart filtreleri kullanılabilir. Tanınmayan bir filtre içeren şablon geçersiz sayılır ve kaydedilmez.
• Şablonlar yalnız temanın kendi dosyalarını okuyabilir; sunucuda kod çalıştıramaz.
• Bir sayfanın çizimi 1,5 saniyeyi aşarsa yarıda kesilir. Çok büyük döngülerden kaçın.
• {% render 'parca' %} ile çağrılan parçalar (snippet) şablonun değişkenlerini görmez; ihtiyaç duyduklarını parametre olarak ver: {% render 'price', price: product.price %}. Aşağıdaki genel değişkenler ise her yerde görünür.

Genel değişkenler#

Bu değişkenler her şablonda, bölümde ve parçada kullanılabilir.

site

site.footer_about düz metindir; satır sonlarını korumak için {{ site.footer_about | escape | newline_to_br | raw }} kullan.

user

Giriş yoksa user boştur; {% if user %} ile denetle.

features

Her alan doğru ya da yanlıştır. Bir bölüm panelde kapalıysa ya da lisans paketin içermiyorsa yanlış olur; temalar o bölümün bağlantılarını gizlemelidir.

features.blog, features.support, features.help, features.changelog, features.downloads, features.forms, features.wheel, features.gaming_night, features.members, features.staff, features.forum, features.suggestions, features.leaderboards, features.punishments, features.vote, features.games, features.bazaar, features.play

menus

menus.header bir bağlantı listesidir. Her bağlantıda title, url, icon (boş olabilir), new_tab, external, active (şu anki sayfa mı) ve live (süren oyun gecesi) bulunur. Üst menü öğelerinde ayrıca dropdown ve children (alt bağlantılar) vardır.

menus.footer sütunlardan oluşur: her sütunda title, icon ve links bulunur.

Menüleri site sahibi Yönetim paneli → Görünüm → Üst menü ve Alt menü sayfalarından düzenler; kapalı bölümlerin bağlantıları listeye zaten girmez (Menüler ve Ek CSS).

legal

Onay kutusunu kendin yazmak yerine {% render 'legal-accept', scope: 'register', form: form %} kullan. Sözleşmeler için: Sözleşmeler.

Sayfa değişkenleri#

Genel değişkenlerin yanında her şablon kendi verisini alır. Örneğin özel sayfalar (page şablonu) şunları alır:

Form içeren sayfalarda bir form nesnesi gelir: form.error ve form.success (mesajlar), form.values (gönderilen değerler, hatada formu yeniden doldurmak için) ve form.errors (alan adına göre hata). {% render 'form-alert', form: form %} mesajları basar.

Ana sayfa şablonunda content_for_index, site sahibinin özelleştiricide dizdiği bölümlerin çıktısıdır: {{ content_for_index | raw }}. Bölüm dosyalarında section.id, section.type ve section.settings kullanılır.

Bir şablonun aldığı bütün değişkenleri görmenin en kolay yolu, Bor temasındaki aynı adlı şablonu Görünüm → Kod düzenleyici'de açmaktır. Alt tema yazıyorsan değiştirmediğin şablonlar zaten Bor'dan gelir.

Filtreler#

BorCube'un eklediği filtreler:

Tutarlar her yerde tam sayıdır ve kuruş cinsindendir (1250 = 12,50); onları her zaman credits, credit_amount ya da money ile bas. Kafa ve gövde görselleri sitenin kendi /mc/… adresinden gelir; ziyaretçinin IP adresi başka bir siteye gitmez. Geçersiz oyuncu adlarında Steve görseli kullanılır.

Liquid'in standart filtreleri de kullanılabilir: escape, url_encode, newline_to_br, strip_html, truncate, upcase, downcase, default, size, first, last, join, split, where, sort, map, plus, minus, times, divided_by, date ve diğerleri. raw kaçışlamayı kapatır; yalnız güvendiğin içerikte kullan.

Etiketler#

Liquid'in standart etiketleri (if, unless, case, for, assign, capture, comment, raw, render…) kullanılabilir. BorCube'un eklediği etiket:

Parçaları {% render 'ad' %} ile çağır; snippets/ad.liquid dosyası çizilir.

Şablonlar#

templates/ klasöründeki dosyalar ve kullanıldıkları sayfalar. Bağımsız bir temada layout/theme.liquid, templates/index.liquid ve templates/404.liquid zorunludur; diğer şablonlardan eksik olanı kullanan sayfa hata verir.

Layout'ta {{ content_for_layout | raw }} şablonun çıktısını basar.

Bor'un hazır parçaları#

Bor'u genişleten bir alt tema bu parçaları doğrudan kullanabilir. Bağımsız bir tema yazıyorsan aynı adlarla kendininkini yazabilirsin; ilk üçü güvenlik ve yasal zorunluluklar için gereklidir.

Örnek: kendi kartın#

<article class="kart">
  <img src="{{ product.image | default: settings.logo }}" alt="">
  <h3>{{ product.name }}</h3>
  {% render 'price', price: product.price, original: product.original_price, percent: product.discount_percent %}
  {%- if user -%}
    <p>{{ 'store.balance' | t }}: {{ user.credits | credits }}</p>
  {%- else -%}
    <a href="/giris">{{ 'nav.login' | t }}</a>
  {%- endif -%}
</article>

Örnekteki store.balance ve nav.login Bor'un dil dosyasındaki anahtarlardır. Kendi yazıların için locales/tr.json dosyana yeni anahtarlar ekle; bulunamayan bir anahtar sayfada olduğu gibi görünür.