Warp 7 framework

Warp 7: config.xml

Joomla
Добавление в избранное
Сохранить
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 для создания новых опций настроек вашего шаблона. Например, это могут быть радио кнопки, чекбоксы или поля ввода.

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

Специальные типы 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. Подробнее об этом читайте в материале Макет шаблона.

Оригинальная статья:
Dmitry Rekun
Работаю в банковской сфере, а с веб-разработкой (непосредственно с Joomla) столкнулся в 2007 году. Теперь это моё хобби, а в редких случаях и вторая работа. Какое-то время вёл свой блог, но решил попробовать работать в команде. И вот c 2012 года я здесь :)

Подпишитесь на рассылку новостей CMScafe