Перейти до основного вмісту
Тема Liquid є пакетом текстових файлів, які рендеряться на сервері за допомогою Liquid. Якщо ви знайомі з темами Shopify, структура буде вам звичною.

Папки

Кожній темі потрібні layout/theme.liquid, templates/index.json і config/settings_schema.json.

Секції та схема

Секція оголошує свої налаштування та блоки в блоці {% schema %}. Візуальний редактор будує на його основі форму налаштувань.
sections/hero.liquid
Значення налаштувань із форматованим текстом і HTML очищаються на сервері під час збереження.

Об’єкти

Фільтри

Екрануйте весь текст товарів і клієнтів за допомогою | escape. Назви та описи пишуть люди.

Теги

App blocks: add_to_cart, buy_now, cart_count, cart_drawer, checkout_button, powered_by, variant_picker.

Сторінки платформи

Оформлення замовлення, кошик, вхід, обліковий запис і відстеження замовлень завжди працюють на PapelShip. Ви можете оформити сторінку навколо них за допомогою шаблону, що містить рівно один заблокований блок:
templates/checkout.liquid
Блок має розташовуватися безпосередньо в шаблоні, а не в сніпеті. JavaScript теми ніколи не завантажується на цих сторінках, а поля картки завжди належать платформі.

Публікація

Збереження є чернетками: активний магазин залишається на опублікованій версії, доки ви не опублікуєте зміни.
  1. Редагуйте копію в редакторі коду або візуальному редакторі. Збереження (Ctrl+S) перевіряє файл і створює версію; інший редактор одразу показує зміну.
  2. Перегляньте копію в редакторі.
  3. Натисніть Publish в будь-якому з редакторів. Він показує список неопублікованих файлів і спершу перевіряє кожен файл теми.
AI-агенти можуть зберігати чернетки, але не можуть публікувати. Див. AI-агенти (MCP).