Переклади в темі

Тема не пише слів відвідувача в розмітці — лише ключі через фільтр t: {{ 'ui.cart_empty' | t }}. Тоді сторінка говорить мовою, яку обрав покупець, а загальні слова (кошик, «Головна», наявність, пошук) вже перекладено дев’ятьма мовами інтерфейсу: uk, en, ru, de, es, fr, it, pl, pt.

Де шукається слово

Тож тема описує лише своє. Ключ, якого немає ніде, видно на сторінці як є (sec.picks_title) — так помилку легко помітити в превʼю.

Текст за замовчуванням у схемі секції — порожній або ключ слова: "default": "t:sec.buy". Ключ перекладається мовою сторінки так само, як фільтр t. Звичайних слів у default і presets не буває: секцію, яку власник додав і не заповнив, покупці побачать будь-якою мовою. Заготовки на кшталт «Текст відгуку покупця» — ключі ph.* спільного словника.

Групи ключів

locales — вкладений JSON: ключ ui.cart_empty — це {"ui": {"cart_empty": "…"}}. Мови — лише з переліку вітрини, значення — лише рядки, файл до 256 КБ. Пишіть щонайменше uk і en.

Перебити спільне слово

Тема перебиває слово спільного словника, назвавши той самий ключ у своїх locales, — і лише тими мовами, якими назвала. Nexa каже «Кошик порожній — саме час обрати ґаджет» замість спільного «Кошик поки порожній.» українською й англійською; німецькою сторінка бере спільне німецьке слово, а не англійське слово теми, бо крок 2 іде раніше за крок 3.

// resources/themes/nexa/locales/uk.json (уривок)
{
  "ui": {"cart_empty": "Кошик порожній — саме час обрати ґаджет.", "to_catalog": "До техніки"},
  "sec": {"header_hours": "Щодня 9:00–21:00"}
}

Тексти, які змінює власник

Текст, який власник може змінити, — налаштування з порожнім default і підставою з перекладу. Порожнє поле говорить мовою сторінки, а вписаний власником текст перемагає:

{%- assign s_hours = section.settings.hours | default: 'sec.header_hours' | t -%}
{% if s_hours != blank %}<span>{{ s_hours }}</span>{% endif %}

{% schema %}
{"name": "Шапка", "enabled_on": {"groups": ["header"]},
 "settings": [{"id": "hours", "type": "text", "label": "Графік (порожньо — текст теми)", "default": ""}]}
{% endschema %}

Контакти й числа

Телефон, пошта, адреса й графік магазину — з «Налаштувань», а не з тексту теми: shop.phone, shop.email, shop.address.summary, shop.working_hours. Секція може дати власнику своє поле й упасти на них, коли воно порожнє:

{%- assign phone = section.settings.phone | default: shop.phone -%}
{% if phone != blank %}<a href="tel:{{ phone | remove: ' ' }}">{{ phone }}</a>{% endif %}

Число з відмінком — сніпет products-count набору сторінок: {% render 'products-count', count: collection.products_count %} → «1 товар / 3 товари / 5 товарів». Правила української, російської й польської; для інших мов — «1 product / 5 products». Слова беруться з ui.products_one, ui.products_few і ui.products_many, тож тема може перебити й їх.

Підстановок у t немає: слово з місцем для значення (ui.rating_of — «Оцінка %rating з 5») заповнюйте фільтром replace: {{ 'ui.rating_of' | t | replace: '%rating', rating }}.

Жодного слова в розмітці

Правило для тем каталогу й офіційних тем: у Liquid поза {% comment %} і {% schema %} немає тексту для відвідувача — ні в розмітці, ні в рядках у лапках. Кожен ключ, який тема просить у t, має текст українською й англійською — у locales теми або в спільному словнику. Підписи налаштувань у схемі (label) — для власника в редакторі, вони лишаються в схемі.

{# Ні #}
<button>Додати в кошик</button>
{% assign title = section.settings.title | default: 'Новинки' %}

{# Так #}
<p>{{ 'ui.sold_out' | t }}</p>
{% assign title = section.settings.title | default: 'sec.new_title' | t %}