settings_form.json

Настройки виджета в json формате, которые отображаются в редакторе. Дефолтные значения прописываются в файле settings_data.json

Группы настроек

Имеется возможность группировки настроек, которые будут отображаться в виде подменю с заголовком. В случае если в настройках будет всего одна группа, то заголовок группы отображаться не будет и дроп будет всегда раскрыт. При добавлении параметра general эти настройки виджета выводятся в первую очередь. Остальные настройки можно будет посмотреть включив Расширенный режим настроек.

Пример:

    {
      "Группа 1":[],
      "Группа 2":[],
      "Группа 3":[]
    }

Подгруппы настроек

Каждую группу можно разделить на подгруппы, которые будут визуально разделять настройки для более удобного их использования.

Пример:

    {
      "Группа 1":[
        {
          "group_name":"Подгруппа 1",
          "items":[]
        },
        {
          "group_name":"Подгруппа 2",
          "items":[]
        },
        {
          "group_name":"Подгруппа 3",
          "items":[]
        }
      ],
      "Группа 2":[],
      "Группа 3":[]
    }

Если не нужно разделять настройки на подгруппы, то можно использовать такой формат.

Пример:

    {
      "Группа 1":[
        {
          "items":[

          ]
        }
      ],
      "Группа 2":[],
      "Группа 3":[]
    }

Варианты полей настроек

В настройках можно использовать несколько видов полей настроек:

• Текст
• Число
• Чекбокс
• Селект
• Ползунок
• Кнопки
• Файл
• Цвет
• Блог

Текст (text)

Данный вид имеет следующие параметры:

• name - идентификатор настройки (должен быть уникальным);
• label - заголовок настройки;
• value - значение по умолчанию;
• help - подсказка (будет отображаться рядом с полем);
• type - тип text
• general - значение true или false - boolean | булевый тип. Вывод настройки в основные в редакторе.
• general_position - значение 2 - тип number | число. Порядок вывода настройки в основные в редакторе.
• general_label - значение - "{{ messages.title }}". Добавляет заголовок с переводом из messages в основных настройках виджета в редакторе.
• enable_server_reload - значение true или false - boolean | булевый тип. Перезагрузка шаблона при изменении значения настройки.
• hide_mobile - значение true или false - boolean | булевый тип. Скрыть настройку в мобильной версии редактора

Пример:

    {
      "Группа 1":[
        {
          "group_name":"Подгруппа 1",
          "items":[
            {
              "name":"main_text",
              "label":"Текст",
              "help":"",
              "type":"text"
            }
          ]
        }
      ],
      "Группа 2":[],
      "Группа 3":[]
    }

Основной текст (rich-text)

Данный вид имеет следующие параметры:

• name - идентификатор настройки (должен быть уникальным);
• label - заголовок настройки;
• value - значение по умолчанию;
• help - подсказка (будет отображаться рядом с полем);
• type - тип text
• general - значение true или false - boolean | булевый тип. Вывод настройки в основные в редакторе.
• general_position - значение 2 - тип number | число. Порядок вывода настройки в основные в редакторе.
• general_label - значение - "{{ messages.title }}". Добавляет заголовок с переводом из messages в основных настройках виджета в редакторе.
• enable_server_reload - значение true или false - boolean | булевый тип. Перезагрузка шаблона при изменении значения настройки.
• hide_mobile - Значение true или false - boolean | булевый тип. Скрыть настройку в мобильной версии редактора.

Пример:

    {
      "Группа 1":[
        {
          "group_name":"Подгруппа 1",
          "items":[
            {
              "name":"main_text",
              "label":"Текст",
              "help":"",
              "type":"text"
            }
          ]
        }
      ],
      "Группа 2":[],
      "Группа 3":[]
    }

Число (number)

Данный вид имеет следующие параметры:

• name - идентификатор настройки (должен быть уникальным);
• label - заголовок настройки;
• value - значение по умолчанию;
• help - подсказка (будет отображаться рядом с полем);
• type - тип number;
• general - значение true или false - boolean | булевый тип. Вывод настройки в основные в редакторе
• general_position - значение 2 - тип number | число. Порядок вывода настройки в основные в редакторе.
• general_label - значение - "{{ messages.title }}". Добавляет заголовок с переводом из messages в основных настройках виджета в редакторе.
• enable_server_reload - значение true или false - boolean | булевый тип. Перезагрузка шаблона при изменении значения настройки.
• hide_mobile - значение true или false - boolean | булевый тип. Скрыть настройку в мобильной версии редактора.
• with_btns - изменение отображения Range slider на поле с кнопками '+' и '-'.
• min - значение 2 - тип number | число. Минимальное значение настройки.
• max - значение 2 - тип number | число. Максимальное значение настройки.
• step - значение 2 - тип number | число. Шаг(интервал) на которое увеличиться число.

Пример:

{
  "class":"range",
  "name":"img-ratio",
  "label":"{{ messages.image_ratio }}",
  "min":0.5,
  "max":2.5,
  "step":0.1,
  "type":"number",
  "with_btns": true
}

Чекбокс (checkbox)

Данный вид имеет следующие параметры:

• name - идентификатор настройки (должен быть уникальным);
• label - заголовок настройки;
• value - значение по умолчанию;
• help - подсказка (будет отображаться рядом с полем);
• type - тип checkbox;
• general - значение true или false - boolean | булевый тип. Вывод настройки в основные в редакторе.
• general_position - значение 2 - тип number | число. Порядок вывода настройки в основные в редакторе.
• general_label - значение - "{{ messages.title }}". Добавляет заголовок с переводом из messages в основных настройках виджета в редакторе.
• enable_server_reload - значение true или false - boolean | булевый тип. Перезагрузка шаблона при изменении значения настройки.
• hide_mobile - значение true или false - boolean | булевый тип. Скрыть настройку в мобильной версии редактора.

Пример:

    {
      "Группа 1":[
        {
          "group_name":"Подгруппа 1",
          "items":[
            {
              "name":"hide_caption",
              "label":"Скрыть заголовок",
              "value":null,
              "help":"",
              "type":"checkbox"
            }
          ]
        }
      ],
      "Группа 2":[],
      "Группа 3":[]
    }

Селект (select)

Данный вид имеет следующие параметры:

• name - идентификатор настройки (должен быть уникальным);
• label - заголовок настройки;
• value - значение по умолчанию;
• help - подсказка (будет отображаться рядом с полем);
• type - тип select;
• general - значение true или false - Boolean | булевый тип. Вывод настройки в основные в редакторе.
• general_position - значение 2 - тип number | число. Порядок вывода настройки в основные в редакторе.
• general_label - значение - "{{ messages.title }}". Добавляет заголовок с переводом из messages в основных настройках виджета в редакторе.
• enable_server_reload - значение true или false - boolean | булевый тип. Перезагрузка шаблона при изменении значения настройки.
• hide_mobile - значение true или false - boolean | булевый тип. Скрыть настройку в мобильной версии редактора.

Пример:

    {
      "Группа 1":[
        {
          "group_name":"Подгруппа 1",
          "items":[
            {
              "name":"font_family",
              "options":[
                [
                  "OpenSans",
                  "google:Open+Sans"
                ],
                [
                  "Roboto",
                  "google:Roboto"
                ]
              ],
              "value":null,
              "label":"Шрифт",
              "type":"select"
            }
          ]
        }
      ],
      "Группа 2":[],
      "Группа 3":[]
    }

Ползунок (Range slider)

Данный вид имеет следующие параметры:

• name - идентификатор настройки (должен быть уникальным);
• label - заголовок настройки;
• value - значение по умолчанию;
• help - подсказка (будет отображаться рядом с полем);
• type - тип range;
• general - значение true или false - boolean | булевый тип. Вывод настройки в основные в редакторе.
• general_position - значение 2 - тип number | число. Порядок вывода настройки в основные в редакторе.
• general_label - значение - "{{ messages.title }}". Добавляет заголовок с переводом из messages в основных настройках виджета в редакторе.
• enable_server_reload - значение true или false - boolean | булевый тип. Перезагрузка шаблона при изменении значения настройки.
• hide_mobile - Значение true или false - boolean | булевый тип. Скрыть настройку в мобильной версии редактора.
• min - значение 2 - тип number | число. Минимальное значение.
• max - значение 2 - тип number | число. Максимальное значение.
• step - значение 2 - тип number | число. Шаг значений.
• unit - значение "vw" - тип string | строка. Единица измерения (vw, px и т.п).
• with_btns - значение true или false - boolean | булевый тип. Изменение отображения Range slider на поле с кнопками '+' и '-'.

Пример:

    {
      "Группа 1":[
        {
          "group_name":"Подгруппа 1",
          "items":[
            {
              "class":"range",
              "name":"layout-pt",
              "min":0,
              "max":10,
              "step":0.5,
              "label":"{{ messages.indentation_height }}",
              "type":"range",
              "unit":"vw"
            }
          ]
        }
      ],
      "Группа 2":[],
      "Группа 3":[]
    }

Кнопки (button-group)

Данный вид имеет следующие параметры:

• name - идентификатор настройки (должен быть уникальным);
• label - заголовок настройки;
• value - значение по умолчанию;
• help - подсказка (будет отображаться рядом с полем);
• type - тип button-group;
• general - значение true или false - boolean | булевый тип. Вывод настройки в основные в редакторе.
• general_position - значение 2 - тип number | число. Порядок вывода настройки в основные в редакторе
• general_label - значение - "{{ messages.title }}". Добавляет заголовок с переводом из messages в основных настройках виджета в редакторе.
• enable_server_reload - значение true или false - boolean | булевый тип. Перезагрузка шаблона при изменении значения настройки.
• hide_mobile - значение true или false - boolean | булевый тип. Скрыть настройку в мобильной версии редактора.
• min - значение 2 - тип number | число. Минимальное значение.
• max - значение 2 - тип number | число. Максимальное значение.
• step - значение 2 - тип number | число. Шаг значений.

• unit - значение "vw" - тип string | строка. Единица измерения (vw, px и т.п).

• with_btns - значение true или false - boolean | булевый тип. Изменение отображения Range slider на поле с кнопками '+' и '-'.

• hide_mobile - значение true или false - boolean | булевый тип. Скрыть настройку в мобильной версии редактора.
• title - значение - {{ messages.align_left }}. Добавляет заголовок с переводом из messages в основных настройках виджета в редакторе.
• icon - значение "vw" - тип string | строка. Пример: mdi-text-align-left.

Пример:

{
  "name":"widget-align",
  "options":[
    {
      "value": "left",
      "title": "{{ messages.align_left }}",
      "icon": "mdi-text-align-left"
    },
    {
      "value": "center",
      "title": "{{ messages.align_center }}",
      "icon": "mdi-text-align-center"
    },
    {
      "value": "right",
      "title": "{{ messages.align_right }}",
      "icon": "mdi-text-align-right"
    }
  ],
  "value":null,
  "label":"{{ messages.alignment }}",
  "type":"button-group"
}

Файл (Пример из настроек шаблона)

Данный вид имеет следующие параметры:

• name - идентификатор настройки (должен быть уникальным);
• label - заголовок настройки;
• value - значение по умолчанию;
• help - подсказка (будет отображаться рядом с полем);
• type - тип file;
• general - значение true или false - boolean | булевый тип. Вывод настройки в основные в редакторе
• general_position - значение 2 - тип number | число. Порядок вывода настройки в основные в редакторе.
• general_label - значение - "{{ messages.title }}". Добавляет заголовок с переводом из messages в основных настройках виджета в редакторе.
• enable_server_reload - значение true или false - boolean | булевый тип. Перезагрузка шаблона при изменении значения настройки.
• hide_mobile - значение true или false - boolean | булевый тип. Скрыть настройку в мобильной версии редактора.
• min - значение 2 - тип number | число. Минимальное значение.
• max - значение 2 - тип number | число. Максимальное значение.
• step - значение 2 - тип number | число. Шаг значений.
• unit - значение "vw" - тип string | строка. Единица измерения (vw, px и т.п).
• with-generate-logo - значение true или false - boolean | булевый тип. Добавить генератор логотипов в редакторе.

Пример:

    {
      "Группа 1":[
        {
          "group_name":"Подгруппа 1",
          "items":[
            {
              "name":"logotype",
              "label":"Логотип",
              "value":null,
              "type":"file"
            }
          ]
        }
      ],
      "Группа 2":[],
      "Группа 3":[]
    }

Цвет

Данный вид имеет следующие параметры:

• name - идентификатор настройки (должен быть уникальным);
• label - заголовок настройки;
• value - значение по умолчанию;
• help - подсказка (будет отображаться рядом с полем);
• type - тип color;
• general - значение true или false - boolean | булевый тип. Вывод настройки в основные в редакторе.
• general_position - значение 2 - тип number | число. Порядок вывода настройки в основные в редакторе
• general_label - значение - "{{ messages.title }}". Добавляет заголовок с переводом из messages в основных настройках виджета в редакторе.
• enable_server_reload - значение true или false - boolean | булевый тип. Перезагрузка шаблона при изменении значения настройки.
• hide_mobile - значение true или false - boolean | булевый тип. Скрыть настройку в мобильной версии редактора.
• clearable - значение true или false - boolean | булевый тип. Возможность очистить цвет фона в редакторе.
• fallback - значение - color-btn-bg или bg. Возвращает заданный цвет если он не указан пользователем.

Пример:

    {
      "Группа 1":[
        {
          "group_name":"Подгруппа 1",
          "items":[
            {
              "name":"color_text",
              "label":"Цвет текста",
              "value":"#ffffff",
              "help":"",
              "type":"color"
            }
          ]
        }
      ],
      "Группа 2":[],
      "Группа 3":[]
    }

Блог

Данный вид имеет следующие параметры:

• name - идентификатор настройки (должен быть уникальным);
• label - заголовок настройки;
• value - значение по умолчанию;
• help - подсказка (будет отображаться рядом с полем);
• type - тип color;
• general - значение true или false - boolean | булевый тип. Вывод настройки в основные в редакторе.
• general_position - значение 2 - тип number | число. Порядок вывода настройки в основные в редакторе.
• general_label - значение - "{{ messages.title }}". Добавляет заголовок с переводом из messages в основных настройках виджета в редакторе.
• enable_server_reload - значение true или false - boolean | булевый тип. Перезагрузка шаблона при изменении значения настройки.
• hide_mobile - значение true или false - boolean | булевый тип. Скрыть настройку в мобильной версии редактора.
• edit_admin_link - Значение - product_options. Ссылка на товар в панели администратора.

Пример:

    {
      "Группа 1":[
        {
          "group_name":"Подгруппа 1",
          "items":[
            {
              "class": "text",
              "name": "permalink_blog",
              "label": "{{ messages.blog_choice }}",
              "value": null,
              "type": "blog",
              "general": true
            }
          ]
        }
      ],
      "Группа 2":[],
      "Группа 3":[]
    }

Использование настроек

Пример файла settings.json:

    {
      "Группа 1":[
        {
          "group_name":"Цвета",
          "items":[
            {
              "name":"color-background",
              "label":"Цвет фона",
              "value":"#ffffff",
              "help":"",
              "type":"color"
            },
            {
              "name":"color-text",
              "label":"Цвет текста",
              "value":"#ffffff",
              "help":"",
              "type":"color"
            },
            {
              "name":"color-link",
              "label":"Цвет ссылок",
              "value":"#ffffff",
              "help":"",
              "type":"color"
            }
          ]
        },
        {
          "group_name":"Шрифт",
          "items":[
            {
              "name":"font_family",
              "options":[
                [
                  "OpenSans",
                  "google:Open+Sans"
                ],
                [
                  "Roboto",
                  "google:Roboto"
                ]
              ],
              "value":null,
              "label":"Шрифт",
              "type":"select"
            },
            {
              "name":"font_weight",
              "label":"Начертание шрифта",
              "value":null,
              "min": 100,
              "max": 600,
              "step": 100,
              "type":"range"
            }
          ]
        },
        {
          "group_name":"Логотип",
          "items":[
            {
              "name":"logotype.png",
              "label":"Логотип",
              "value":null,
              "help":"",
              "type":"file"
            }
          ]
        }
      ],
      "Группа 2":[],
      "Группа 3":[]
    }

Пример получения значений настроек:

Вызов значения какого-либо параметра задается переменной {{ widget_settings.необходимый_метод }}

Пример liquid:

Шрифт: {{ widget_settings:font_family }}
Цвет текста: {{ widget_settings:color_text }}

Пример JSON

{
  "{{ messages.content_settings }}": [
    {
      "items": [
        {
          "class": "text",
          "name": "title",
          "label": "{{ messages.title }}",
          "value": null,
          "type": "text"
        },
        {
          "class": "range",
          "name": "benefit_row_gap",
          "min": 0,
          "max": 10,
          "step": 0.5,
          "label": "{{ messages.benefit_row_gap }}",
          "type": "range"
        },
        {
          "class": "range",
          "name": "benefit_img_ratio",
          "label": "{{ messages.benefit_img_ratio }}",
          "min": 0.5,
          "max" : 2,
          "step": 0.1,
          "type": "range"
        },
        {
          "class": "range",
          "name": "benefit_img_border_radius",
          "label": "{{ messages.benefit_img_border_radius }}",
          "min": 0,
          "max" : 50,
          "step": 1,
          "type": "range"
        }
      ]
    }
  ]
}