Warp7 настройки config.xml

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

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

PHP:

<?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 отобразит название вкладки.

PHP:

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

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

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




Тип Описание

• section Определяет раздел для описания
• radio Определяет радио кнопку
• checkbox Определяет чекбокс
• select Определяет раскрывающийся список
• text Определяет текстовый ввод
• textarea Определяет текстовую область.

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

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

PHP:

<!-- 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

Автор перевода