From In-Portal Developers Guide

Revision as of 15:53, 4 November 2009

Настройка системы
Статьи в этой категории
Configuration Как включить SSL-режим Site Configs

Функциональность "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',
);

$remove_buttons = Array (
	'email_log_list' => Array ('view'),
	'catalog' => Array ('up', 'home'),
);

$hidden_fields = Array (
	'EmailLogId', 'FromUser', 'AddressTo',
);

$virtual_hidden_fields = Array (
	'ThumbPath', 'FullUrl',
);

$debug_only_fields = Array (
	'EmailLogId', 'FromUser', 'AddressTo',
);

$debug_only_virtual_fields = Array (
	'ThumbPath', 'FullUrl',
);

$required_fields = Array (
	'EmailLogId', 'Subject',
);

$virtual_required_fields = Array (
	'ThumbUrl', 'ThumbPath',
);

$hide_edit_tabs = Array (
	'Default' => Array ('general', 'groups'),
	'RegularUsers' => Array ('groups'),
);

$hide_columns = Array (
	'Default' => Array ('Тimestamp', 'Еvent'),
);

Стандартный набор site configs доступен в архиве: "core/install/site_configs.zip" и обновляется при каждом релизе.