Справочник системных настроек
Все системные настройки компонента имеют префикс mpc_ и сгруппированы по областям (mpc_paths, mpc_general, mpc_resource, mpc_media, mpc_contacts, mpc_lexicons) — в админке MODX они так и разложены по вкладкам. Менять их можно в Система → Системные настройки (фильтр по пространству имён migxpageconfigurator).
Большинство настроек достаточно задать один раз при установке — какие именно и почему важны до первой нарезки, разобрано в разделе Начало работы. Здесь — полная сводка по группам; настройки, у которых есть свой тематический раздел, помечены ссылкой.
Когда применяются
Часть настроек влияет на нарезку (пути, медиа, лексиконы) — после их изменения шаблон нужно перенарезать. Часть влияет на рендер (lazy-load, языки) — изменения видны после сброса кэша.
Пути и файлы
Все пути считаются относительно папки элементов pdoTools (pdotools_elements_path), кроме явно абсолютных. Подробнее о структуре файлов — в Начало работы.
| Настройка | По умолчанию | Назначение |
|---|---|---|
mpc_path_to_src | templates/ | папка с исходными файлами-шаблонами (откуда берётся нарезка) |
mpc_path_to_sections | sections/ | куда складываются файлы-секции |
mpc_path_to_chunks | chunks/ | куда складываются вырезанные чанки |
mpc_path_to_dist | parsed/ | папка готовых (запечённых) файлов страниц |
mpc_path_to_presets | presets/ | папка пресетов |
mpc_path_to_samples | components/migxpageconfigurator/elements/samples/ | заготовки плейсхолдеров (foreach и т.п.) |
mpc_tpl_file_extension | .tpl | расширение файлов шаблонов |
mpc_wrapper_name | wrapper | имя файла-обёртки с общим HTML |
mpc_manifests_path | components/migxpageconfigurator/console/manifests/ | папка манифестов для CLI — см. Консольные команды |
mpc_theme | (пусто) | активная тема оформления на весь сайт. Пусто → базовая вёрстка. См. Темизация |
mpc_theme_templates | (пусто) | тема для отдельных шаблонов, JSON вида {"5":"dark","12":"summer"}. Приоритетнее mpc_theme. См. Темизация |
mpc_themes_subdir | _themes/ | подпапка внутри папки секций, где лежат темы. См. Темизация |
Базовые
| Настройка | По умолчанию | Назначение |
|---|---|---|
mpc_common_config_name | mpc_config | имя TV, в которой хранится конфиг секций |
mpc_config_tv_id | (пусто) | id этой TV (заполняется при установке) |
mpc_base_section_name | mpc_base | имя MIGX-конфигурации с прототипами полей (типы) |
mpc_static_block_page_id | (пусто) | id ресурса «Типы страниц» — хранилище статических секций и базовый уровень наследования. См. Статические секции |
mpc_tv_category | (пусто) | категория-владелец TV, которые создаёт нарезка. Пусто → категория самого пакета |
mpc_dev_mode | 0 | режим разработки: при нарезке чистит весь parsed/ (медленнее, но без устаревших страниц) |
mpc_edit_mode | false | служебный флаг режима правки |
mpc_tmplvar_ids | (пусто) | ограничение списка TV (служебное) |
mpc_exclude_fields_path | components/migxpageconfigurator/elements/fields/exclude_fields.json | список полей, исключённых из обработки |
mpc_allowed_tags | b,i,... | HTML-теги, разрешённые внутри значений полей |
mpc_allow_modx_tags | 0 | разрешать ли MODX-теги ([[ ]]) в значениях полей |
Поля ресурса
Управляют тем, какие нативные поля ресурса можно править через data-mpc-rfield и визуальный редактор. См. Разметка → Поля ресурса.
| Настройка | По умолчанию | Назначение |
|---|---|---|
mpc_editable_resource_fields | longtitle, description, introtext, content, menutitle | белый список полей ресурса, разрешённых к правке |
mpc_protected_resource_fields | id, … | поля, которые править нельзя ни при каких условиях |
Изображения и медиа
Подробно — в разделе Работа с медиа.
| Настройка | По умолчанию | Назначение |
|---|---|---|
mpc_media_source | (пусто) | id медиа-источника MODX для загрузки картинок (нужен визуальному редактору) |
mpc_thumb_snippet | mpcThumb | сниппет обрезки картинок (по width/height полей) |
mpc_common_thumb_params | q=90&zc=1&f=webp | параметры обрезки по умолчанию (качество, обрезка, формат) |
mpc_lazyload_attr | data-lazy | атрибут ленивой загрузки (в него уезжает реальный src) |
mpc_lazyload_enabled | 1 | включить ленивую загрузку |
mpc_fake_img_path | assets/components/migxpageconfigurator/images/fake-img.png | заглушка-картинка в src до ленивой подгрузки |
mpc_expand_attr | data-svg | атрибут «развернуть SVG инлайн» |
mpc_expand_enabled | 1 | включить инлайн-разворот SVG |
mpc_download_paths | {"images":"", …} | куда скачивать внешние медиа по типам |
mpc_download_extensions | jpg, png, … | какие расширения скачивать |
mpc_mime_to_ext_path | components/migxpageconfigurator/elements/media/mime_to_ext.json | карта MIME → расширение (для скачанных без расширения) |
Настройки обрезки в MODX 3
В версии для MODX Revolution 3 обрезка работает «на лету» через Glide (см. Работа с медиа), поэтому набор настроек другой:
| Настройка | По умолчанию | Назначение |
|---|---|---|
mpc_thumb_enabled | Да | включить генерацию миниатюр (заменяет mpc_thumb_snippet) |
mpc_common_thumb_params | fit=crop&fm=webp&q=90 | параметры обрезки в синтаксисе Glide |
mpc_glide_signing_key | (генерируется при установке) | секретный ключ подписи адресов миниатюр (защита от подбора размеров) |
mpc_thumb_cache_path | assets/components/migxpageconfigurator/cache/thumbs/ | публичная папка кеша готовых миниатюр |
mpc_thumb_driver | gd | движок обработки картинок: gd или imagick |
mpc_thumb_max_pixels | 16777216 | потолок площади миниатюры (ширина×высота) — доп. защита |
mpc_thumb_gc_ttl | 2592000 | время жизни файла кеша в секундах (старше — удаляются при чистке) |
Настройка mpc_thumb_snippet в MODX 3 не используется (миниатюрщик-сниппет убран).
Контакты
Подробно — в разделе Работа с контактами.
| Настройка | По умолчанию | Назначение |
|---|---|---|
mpc_contacts_page_id | (пусто) | id ресурса «Контакты» (общее хранилище контактов сайта) |
mpc_contacts_page_alias | (пусто) | псевдоним ресурса контактов (задаётся в окне установки). Пусто → создаётся ресурс contacts на шаблоне «Контакты»; указан существующий → контакты привязываются к нему (шаблон не меняется); указан несуществующий → создаётся на шаблоне «Контакты» |
mpc_contacts_tv_name | contacts | имя TV с контактами |
mpc_contacts_tv_id | (пусто) | id этой TV |
mpc_contact_lexicon_fields | caption | какие под-поля контакта переводимы (уходят в лексикон). Запись поле — у всех типов, тип:поле — только у контакта этого типа (напр. caption, address:value) |
mpc_phone_format | 8 (\2) \3-\4-\5 | шаблон форматирования телефона для вывода |
mpc_phone_regexp | /(\d)(\d{3})(\d{3})(\d{2})(\d{2})$/ | разбор номера на группы под формат |
Лексиконы и языки
Подробно — в разделе Лексиконы и мультиязычность.
| Настройка | По умолчанию | Назначение |
|---|---|---|
mpc_use_lexicons | 0 | включить режим лексиконов (переводимые значения уходят в словари) |
mpc_translated_content | text, image, … | какие типы контента считаются переводимыми |
mpc_exclude_lexicons_filename | components/migxpageconfigurator/services/exclude_lexicons.inc.php | файл со списком полей-исключений |
mpc_lexicon_path | components/migxpageconfigurator/lexicon/ | папка с файлами лексиконов |
mpc_lexicons_namespace | migxpageconfigurator | пространство имён лексиконов MODX |
mpc_lexicon_filename_field | alias | поле ресурса, по которому именуется файл лексикона |
mpc_cmp_resource_label_field | pagetitle | поле-подпись ресурса в интерфейсе |
mpc_default_language | ru | язык по умолчанию (источник оригиналов) |
mpc_available_languages | (пусто) | список доступных языков через запятую (ru,en) |
mpc_lang_cookie_name | mpc_lang | имя cookie с текущим языком |
mpc_lang_cookie_domain | (пусто) | домен cookie (пусто → текущий хост; задать для общих поддоменов) |
mpc_set_language_on_request | Да | выставлять ли язык автоматически на каждый запрос. Вкл — пакет сам ставит язык (по cookie). Выкл — язык ставит проект (свой плагин). Для тонкой настройки есть событие mpcOnBeforeSetLanguageSettings |
mpc_arbitrary_lexicon_topics | (пусто) | топики для произвольных лексиконных ключей через запятую; топик, использованный в data-mpc-lexicon, обязан быть в этом списке, иначе ключ на сайте не загрузится |