Перейти к основному содержанию
Тема Liquid представляет собой пакет текстовых файлов, которые отрисовываются на сервере с помощью Liquid. Если вы знакомы с темами Shopify, структура покажется вам знакомой.

Папки

Каждой теме нужны layout/theme.liquid, templates/index.json и config/settings_schema.json.

Секции и схема

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

Объекты

Фильтры

Экранируйте любой текст товаров и клиентов с помощью | escape. Названия и описания пишут люди.

Теги

Блоки приложений: 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. Нажмите Опубликовать в любом из редакторов. Сначала отображается список неопубликованных файлов, и проверяется каждый файл темы.
ИИ-агенты могут сохранять черновики, но не могут публиковать. См. ИИ-агенты (MCP).