Locale ve Çeviriler

Tema metinlerini sabit kodlamak yerine locales/ klasöründeki sözlüklerden okuyarak mağazanızı çok dilli yapabilirsiniz. T-SOFT, her section/snippet render edildiğinde o bloğa ait çeviri grubu + ortak (common) grup otomatik olarak t nesnesine yüklenir; Twig'de {{ t.<anahtar> }} ile erişirsiniz.

<h2>{{ t.block_title }}</h2>
<button>{{ t.next }}</button>

Sözlük yapısı

Locale dosyaları bloklara göre gruplandırılmış JSON nesneleridir. Her üst-düzey anahtar bir section veya snippet adına karşılık gelir; ek olarak common bloğu tüm tema boyunca kullanılabilen ortak metinleri tutar.

{
  "common": {
    "next": "Sonraki",
    "previous": "Önceki",
    "add_to_cart": "Sepete Ekle",
    "cancel": "Vazgeç",
    "save": "Kaydet",
    "search": "Ara"
  },
  "cart": {
    "block_title": "Sepetim",
    "total": "Sepet Toplamı",
    "go_to_checkout": "Satın Al",
    "clear_cart": "Sepeti Temizle"
  },
  "blog-list": {
    "search_result": "<b>%SEARCH_WORD%</b> ile ilgili <b>%COUNT%</b> sonuç bulundu",
    "no_blog": "Görüntülenecek blog bulunamadı"
  },
  "_cookie-law": {
    "cookie_settings_title": "Çerez Tercihleri",
    "accept_all": "Hepsini Kabul Et"
  }
}

Otomatik enjeksiyon

section/cart.twig render edildiğinde t nesnesi şunlardan oluşur:

t = { ...common, ...cart }       # cart anahtarları common'ı ezer

Yani Twig içinde:

<h2>{{ t.block_title }}</h2>      {# cart.block_title → "Sepetim" #}
<button>{{ t.go_to_checkout }}</button>  {# cart.go_to_checkout → "Satın Al" #}
<button>{{ t.cancel }}</button>   {# common.cancel → "Vazgeç" #}
<button>{{ t.next }}</button>     {# common.next → "Sonraki" #}

Aynı şekilde snippets/_cookie-law.twig içinde:

<div class="cookie-banner">
  <h3>{{ t.cookie_settings_title }}</h3>
  <button>{{ t.accept_all }}</button>
  <button>{{ t.cancel }}</button>  {# common'dan #}
</div>

Default locale + tema override

T-SOFT, her temayla birlikte varsayılan bir locale sözlüğü yükler; yaygın anahtarlar (sepet, ödeme, ürün, kategori, blog…) zaten tanımlıdır. Temanız bu sözlüğü iki şekilde genişletebilir:

Placeholder değişkenleri

Çeviri metinleri %PLACEHOLDER% formunda yer tutucu içerebilir:

{
  "product-list": {
    "search_result": "<b>%SEARCH_WORD%</b> ile ilgili <b>%COUNT%</b> sonuç bulundu",
    "search_result_empty": "<b>%SEARCH_WORD%</b> ile ilgili sonuç bulunamadı",
    "total_result": "<b>%COUNT%</b> sonuç listelendi"
  }
}

Twig'de |replace filtresine bir nesne (hash) geçirerek değerleri yerleştirin. Çeviri HTML içeriyorsa zincirin sonuna |raw ekleyin:

{% set COUNT = "<span class='text-primary font-bold'>" ~ TOTAL ~ "</span>" %}

{% if SEARCH_WORD %}
  <div>{{ t.search_result|replace({'%SEARCH_WORD%': SEARCH_WORD, '%COUNT%': COUNT})|raw }}</div>
{% else %}
  <div>{{ t.total_result|replace({'%COUNT%': COUNT})|raw }}</div>
{% endif %}

Tek placeholder için de aynı pattern:

{{ t.search_result_empty|replace({'%SEARCH_WORD%': SEARCH_WORD})|raw }}

Dinamik anahtar — t[değişken]

Anahtar bir değişkenden geliyorsa köşeli parantez ile erişin:

{% for key, translation_key in ALLOWED_SORTS %}
  <option value="{{ key }}">
    {{ t[translation_key] }}
  </option>
{% endfor %}

Burada translation_key bir string değişken ("sort_by_default" gibi). Nokta notasyonu (t.translation_key) değişkeni çözmez; köşeli parantez gerekir.

Yeni bir dil ekleme

Konvansiyonlar

Hızlı kontrol

# Temadaki tüm t.<anahtar> çağrılarını çıkar
grep -rEho 't\.[a-z0-9_]+' section/ snippets/ | sort -u

# Bir anahtarın hangi locale dosyasında olduğunu bul
grep -rn '"go_to_checkout"' locales/

Sıradaki adım