Системные настройки
В ZoomX есть 2 вида системных настроек - открытые и скрытые. Первые можно найти в админке в интерфейсе системных настроек. Вторые служать для подмены базовых классов компонента.
Открытые системные настройки
| Ключ | По-умолчанию | Описание |
|---|---|---|
| zoomx_autoload_resource | true |
Автоматический поиск ресурса для указанного маршрута. При отключении позволяет использовать виртуальные страницы. |
| zoomx_autodetect_content_type | true |
Включить режим автоматического определения заголовка "Content-Type" для ответа в режиме отключённой автозагрузки ресурса. |
| zoomx_caching | true |
Кэшировать файлы шаблонов. |
| zoomx_cache_route | false |
Кэшировать роуты. Снижает нагрузку при большом количестве роутов. Но в этом режиме нельзя использовать анонимные функции в качестве обработчика. Только контроллеры. |
| zoomx_config_path | {core_path}config/ |
Путь к конфигурационным файлам роутов, исключений и файловых элементов. |
| zoomx_enable_pdotools_adapter | false |
Заменить парсер Fenom на текущий ZoomX парсер (пока только Smarty) для обработки чанков в сниппетах pdoTools. |
| zoomx_enable_exception_handler | true |
Использовать собственный обработчик ошибок. |
| zoomx_file_snippets_path | {core_path}elements/snippets/ |
Директория хранения файловых сниппетов. Можно указывать несколько директорий. В качестве разделителя используйте ";". |
| zoomx_http_method_override | true |
Позволяет указать HTTP методы "PATCH", "PUT" и "DELETE" в элементе формы с именем "_method". |
| zoomx_include_modx | true |
Разрешить объекты $modx и $zoomx в шаблонах. |
| zoomx_include_request_info | true |
Выводит стандартную информацию MODX о запросе (время обработки, количество запросов, память, источник) в режиме JSON ответа. |
| modx_parser_class | ZoomSmarty |
Класс парсера, который используется для обработки контента. Должен имплементировать интерфейс Zoomx\ParserInterface. |
| zoomx_routing_mode | 1 |
Режим роутинга. Возможные значения: 0 - роутинг выключен; 1 - смешанный режим (если роут для данного URI не найден, поиском займётся MODX); 2 - строгий режим (если роут не найден, то обработка завершится с ошибкой 404). |
| zoomx_show_error_details | true |
Показывать полную информацию по ошибке с данными трассировки. |
| zoomx_template_dir | {core_path}components/zoomx/templates/ |
Полный путь к файлам шаблонов. Рекомендую перенести в {core_path}templates/ |
| zoomx_theme | default |
Имя папки в каталоге шаблонов. Позволяет управлять темами сайта. Добавляется в путь, указанный в настройке zoomx_template_dir. Если темы не нужны, можно указать пустое значение. |
| zoomx_use_zoomx_parser_as_default | false |
Использовать ZoomX шаблонизатор и для обработки стандартных MODX шаблонов. При отключении MODX шаблон игнорируется. |
| Smarty | ||
| zoomx_smarty_cache_dir | zoomx/smarty/cache/ |
Путь к файлам кэша шаблонов Smarty относительно папки core/cache/. |
| zoomx_smarty_compile_dir | zoomx/smarty/compile/ |
Путь к компилированным файлам шаблонов Smarty относительно папки core/cache/. |
| zoomx_smarty_config_dir | {core_path}config/ |
Полный путь к файлам конфигов. |
| zoomx_smarty_custom_plugin_dir | {core_path}components/zoomx/smarty/custom_plugins/ |
Полный путь к пользовательским плагинам Smarty. |
| zoomx_modx_tag_syntax | true |
Позволяет использовать синтаксис в стиле MODX тегов - {'*pagetitle'}, {'++setting'}, {'~5'} и {'%lexicon'}. Негативно сказывается на производительности. |
| zoomx_default_tpl | error.tpl |
Используется в строгом режиме для вывода сообщений об ошибках. Этот же шаблон будет использован для вывода ошибок в смешанном режиме, если в роуте будет вызвано исключение. |
| zoomx_template_extension | tpl |
Расширение файлов шаблонов Smarty. Будет добавлено к названию файлового чанка, если он указан без расширения. Также запрещает использовать шаблоны с другими расширениями. |
| zoomx_smarty_security_class | '' |
Класс безопасности. Он должен находится в папке zoomx/smarty/security/. Если файл не указан, то будет использована базовая политика безопасности Smarty. |
| zoomx_smarty_security_enable | false |
Включает режим безопасности. |
Системные настройки для расширения базовых классов
Эти настройки можно самостоятельно создать в соответствующем разделе системных настроек. Или использовать API MODX - $modx->setOption('system_setting', 'new value').
| Ключ | По-умолчанию | Описание |
|---|---|---|
| zoomx_alias_request_handler_class | Zoomx\AliasRequestHandle |
Класс-обработчик запросов в режиме дружественных URL. |
| zoomx_id_request_handler_class | Zoomx\IdRequestHandler |
Класс-обработчик запросов в режиме запросов по id (index.php?id=1). |
| zoomx_cache_manager_class | Zoom\Cache\CacheManager |
Класс кэш-менеджера. Объект этого класса можно получить через zoomx('cacheManager'). |
| zoomx_exception_handler_class | Zoomx\ExceptionHandler |
Класс обработчика ошибок и исключений. |
| zoomx_element_service_class | Zoomx\Support\ElementService |
Класс сервиса для работы с элементами (чанками, сниппетами, плагинами). |
| zoomx_file_response_class | Zoomx\FileResponse |
Класс ответа для возврата файла. |
| zoomx_json_request_class | Zoomx\Json\Request |
Класс, отвечающий за обработку JSON запроса. |
| zoomx_json_response_class | Zoomx\Json\Response |
Класс, отвечающий за подготовку JSON ответа на запрос. |
| zoomx_request_class | ZoomRequest |
Класс, обрабатывающий запрос. |
| zoomx_response_class | ZoomResponse |
Класс, отвечающий за подготовку ответа на запрос. |
| zoomx_view_class | Zoomx\View |
Класс вида (View) для работы с шаблонизатором. |