Шаблоны InSales 4 поколения

Info

Шаблон — редактируемый набор виджетов со своими настройками. В json-файлах задают виджет-листы, виджеты, их блоки и настройки шаблона.

Структура архива

templates/ — liquid-файлы страниц. Общая оболочка и шаблоны страниц описаны в layout.
snippets/ — общие фрагменты Liquid. Из шаблона их подключают тегом {% include 'имя' %}: файл snippets/имя.liquid.
media/ — файлы темы: изображения, стили, скрипты. В старых архивах эта папка называется assets/. При загрузке архива нужна одна из них.
config/settings.json — форма настроек шаблона в редакторе.
config/settings_data.json — значения настроек.
config/messages.json — переводы шаблона.
config/setup.json — состав шаблона при установке: виджет-листы, виджеты, блоки, страницы, меню и другие сущности магазина.
widget_types/ — свои виджеты шаблона. Состав папки виджета описан в разделе виджеты.

При загрузке архива обязательны шаблоны общей оболочки, главной, категории, товара, корзины и страницы: layout.liquid, index.liquid, collection.liquid, product.liquid, cart.liquid, page.liquid.

Создание

Поставить магазин на шаблон 4 поколения можно двумя способами:

Установить готовый шаблон в панели администратора, раздел «Дизайн».
Изменить файлы уже установленного шаблона: «Дизайн» → Действия → Редактировать код.

setup.json

Фрагмент, в котором виджет с пермалинком system_widget_v4_promo_slider_4 добавлен в виджет-лист index-list.

"theme_widgets":{
  "widget_types":[],
  "widget_lists":[
    {
      "name":"index",
      "handle":"index-list",
      "kind":"content",
      "widgets": [
        {
          "settings_data":{
            "hide-mobile":false,
            "hide-desktop":false,
            "img-ratio":"3",
            "autoplay":false,
            "autoplay-delay":"5"
          },
          "widget_type":"system_widget_v4_promo_slider_4",
          "data_handle":"block-list-slider"
        }
      ]
    }
  ]
}

Полное описание файла — на странице setup.json.

settings.json и settings_data.json

settings.json описывает поля в редакторе: группы, подписи и типы. settings_data.json хранит выбранные значения.

Фрагмент значений: шрифт, фон, цвет кнопок и скругление.

{
  "current": "custom",
  "generation": 4,
  "presets": {
    "custom": {
      "bg": "#FFFFFF",
      "color-btn-bg": "#76BC21",
      "controls-btn-border-radius": "0px",
      "font-family": "PT Root UI"
    }
  }
}

Форма — на странице settings.json, значения — на странице settings_data.json.