Warp 7: config.xml

В настройках шаблона вы можете контролировать базовые предпочтения для макетов шаблона, виджетов и меню. У каждой вкладки меню есть своя собственная панель опций, которая определена в файле config.xml.

Элементы <fields>

Элементы <fields> определяют вкладки меню и создают панели для опций.

<?xml version="1.0" encoding="utf-8"?>
<config>
    <fields name="Settings" icon="uk-icon-cogs">
        ...
    </fields>
    <fields name="Layouts" icon="uk-icon-columns">
        ...
    </fields>
    <fields name="Modules" icon="uk-icon-th">
        ...
    </fields>
    <fields name="Menus" icon="uk-icon-reorder">
        ...
    </fields>
    <fields name="Information" icon="uk-icon-info-sign">
        ...
    </fields>
</config>

Добавление новой вкладки в меню

Элемент <fields> добавит новую вкладку в настройки шаблона. Значение атрибута name отобразит название вкладки.

<fields name="MY-MENUITEM" icon="uk-icon-info-sign">
    ...
</fields>

Элементы <field>

Элемент <field> внутри элементов <fields> определяет опции для вкладок меню.

Базовые типы XML

Вы можете использовать базовые типы XML для создания новых опций настроек вашего шаблона. Например, это могут быть радио кнопки, чекбоксы или поля ввода.

Специальные типы XML

Существуют также специфичные для Warp7 типы: layouts, verify, styles, compile и info.

Пример разметки

<!-- Section field -->
<field type="section" name="Headline" description="A description text." /><!-- Checkbox field -->
<field type="checkbox" name="my-option-1" value="1" label="A description text." /><!-- Radio field -->
<field type="radio" name="my-option-2" value="1" label="A description text." /><!-- Select field -->
<field type="select" name="my-option-3" default="0">
    <option value="0">Option A</option>
    <option value="1">Option B</option>
    <option value="2">Option C</option>
    <option value="3">Option D</option>
</field><!-- Text field -->
<field type="text" name="my-option-4" /><!-- Textarea field -->
<field type="textarea" name="my-option-5" rows="8" />

Добавление новых опций

Для создания новой опции, добавьте элемент <field> к той настройке (внутри элемента <fields>), к которой вы желаете добавить свою опцию. Вы также можете скопировать имеющуюся и изменить её согласно своим требованиям.

config.json

Когда кто-то сохраняет настройки шаблона, они сохраняются в минифицированном файле config.json. При каждом сохранении файл будет перезаписан.

В шаблонах Warp присутствует отдельный файл config.default.json, в котором хранятся все настройки по умолчанию. Это дает вам возможность восстановить все настройки и сделать бэкап вашего собственного файла config.json, делая ваши настройки устойчивыми к обновлениям.

Для просмотра файла рекомендуем использовать JSON Formatter.

Объект конфига

Переменные из файла config.xml хранятся в объекте конфига. Для доступа к значению переменной, просто используйте метод get. Подробнее об этом читайте в материале Макет шаблона.