1.3. Site Configs
- Alex
Функциональность "Site Configs" является упрощённым вариантом использования события OnAfterConfigRead и доступна для всех конфигурационных файлов (префиксов) в системе. Для использования данной функциональности не требуется создавать или регистрировать новые классы или hooks.
Описанная далее функциональность доступна начиная с Core v 5.0.0.
Расположение файлов
На данный момент все site configs располагаются в директории "admin/system_presets". Каждый из файлов, находящихся в этой директории влияет только на один, связанный с ним, конфигурационный файл. Для того, чтобы создать новый site config нужно знать название конфигурационного файла, на который требуется повлиять и префикс, который в нём указан.
Например, если конфигурационный файл называется "categories_config.php" и в нём объявлен префикс "c", то файл, содержащий site config должен называться "categories_c.php" (убираем из названия конфигурационного файла "_config.php" и добавляем к нему "_<prefix>.php").
Формат файлов
В каждом site config допускается объявлять глобальные переменные из перечисленного ниже списка. В результате обработки каждой из этих переменных будет изменена одна или более опция из конфигурационного файла, с которым этот site config связан.
Название переменной | Описание |
|---|---|
| В данной переменной перечисляются названия тех секций в дереве административной консоли, которые требуется спрятать от пользователя. $remove_sections = Array (
'in-portal:configure_categories',
'in-portal:configuration_custom',
); |
| В данной переменной перечисляются названия тех секций в дереве административной консоли, которые требуется показывать только тогда, когда включён режим отладки ( $debug_only_sections = Array (
'in-portal:email_events',
'in-portal:phrases',
); |
| В данной переменной перечисляются названия кнопок на панели инструментов, которые нужно спрятать. Кнопки указываются отдельно для каждого требуемого title preset. $remove_buttons = Array (
'email_log_list' => Array ('view'),
'catalog' => Array ('up', 'home'),
); |
| В данной переменной перечисляются те физические поля, которые нужно спрятать с формы редактирования, связанной с данным |
| В данной переменной перечисляются те виртуальные поля, которые нужно спрятать с формы редактирования, связанной с данным |
| В данной переменной перечисляются те физические поля, которые нужно показывать на форме редактирования, связанной с данным |
| В данной переменной перечисляются те виртуальные поля, которые нужно показывать на форме редактирования, связанной с данным |
| В данной переменной перечисляются те физические поля, которые являются обязательными к заполнению на форме редактирования, связанной с данным |
| В данной переменной перечисляются те виртуальные поля, которые являются обязательными к заполнению на форме редактирования, связанной с данным |
| В данной переменной перечисляются те вкладки, которые нужно спрятать на форме редактирования, связанной с данным |
| В данной переменной перечисляются те поля, которые нужно спрятать из набора колонок, показываемых в списке записей связанных с данным |
Стандартный набор site configs доступен в архиве: "core/install/site_configs.zip" и обновляется при каждом релизе.