Modx ClientConfig — пользовательские системные настройки

ClientConfig - пользовательские системные настройки MODX Revo

В прошлом уроке мы немного сделали сайт динамичнее при помощи дополнительных полей (TV). Сегодня продолжим добавлять динамику сайта, но теперь при помощи пользовательских системных настроек (они быстрее TV) и поможет в этом пакет ClientConfig.

Что такое ClientConfig и для чего он нужен

ClientConfig — это пакет (доп. компонент) для MODX, который позволяет администратору сайта настраивать параметры конфигурации для клиентов. Обычно используется для хранения адресов соц сетей, телефонов, слоганов сайта, почты, адресов и тому подобного и их дальнейшего вывода на сайте (соответственно быстрого редактирования).

Установка

Устанавливается стандартно из официального репозитория.

Настройка параметров конфигурации

Откройте в меню «Пакеты» -> «Конфигурация» и нажмите «Администрирование» в правом верхнем углу.

вход в администрирование клиент конфиг

Далее переходим во вкладку Группы и создаем новую группу, пусть будет «Контакты» (групп может быть множество — создаются только ради удобства — для категоризации настроек на вкладках в представлении клиентов), сохраняем.

Создание группы для настроек

 

Теперь мы можем добавить некоторые настройки на вкладке «Настройки». Просто нажмите кнопку Добавить настройку и заполните форму и сохраняем.

Добавление настройки

Таким же образом я добавил email и соц сети (для них создал отдельную группу).

созданные группы и настройки

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

Вывод настроек в код

После создания настроек и их можно вызвать в код несколькими способами:

[[++key]]

$modx->getOption (‘key’)

{$_modx->config.key} — на fenom

 

Дополнительная документация

Давайте рассмотрим некоторые из вариантов настройки ниже.

Настройки содержат ряд фиксированных опций:

Ключ — обязательно заполняйте на английском (без пробелов), он используется для обращения на настройку и получения значений настройки.

Название: видимое имя поля.

Тип поля: допустимый тип поля; см. особенности ниже.

Описание: описание поля для предоставления дополнительного контекста для поля. Виден при наведении на поле.

Настройка обязательна: если поле обязательно должно иметь значение, поставьте галочку.

Значение по умолчанию: задайте если знаете (либо укажите любое — чтобы можно было сразу вывести в код).

Группа: группа, в которой должно отображаться это поле

Опции: доступно только для подмножества типов полей. Подробности смотрите ниже.

Важно! Если есть системные настройки или контекстные настройки с одним и тем же [[++key]], настройки в ClientConfig переопределят их.

Типы полей

Вы можете выбрать несколько типов полей для ваших конфигураций. Тип x в скобках предназначен для ExtJS.

Текст (xtype: textfield)
Текстовая область (тип: текстовая область)
Number (xtype: numberfield)
Флажок (xtype: xcheckbox)
Дата (xtype: datefield)
Время (xtype: timefield)
Selectbox (xtype: modx-combo); свойства: текст == значение || текст2 == значение
Вы можете использовать тип поля Selectbox, чтобы имитировать логическое поведение yes || no для определенных параметров системы, установив параметры поля.

В следующем уроке создадим дополнительные шаблоны и начнем наполнять сайт.

Оценить статью
web-revenue.ru
Добавить комментарий