MigxPageConfigurator и mpcVisualEditor — теперь на MODX 3, с темами оформления и облачными ассетами

Связка MigxPageConfigurator (MPC) и mpcVisualEditor (mpcVE) — это «нарезал статичную вёрстку → получил сайт, который контент-менеджер правит визуально прямо на странице». Если вы её уже знаете — у нас большое обновление. Если ещё нет — самое время познакомиться.

Главное: оба пакета переехали на MODX 3

• Современный стек: MODX 3, PSR-4, актуальные зависимости.
• Версия для MODX 2 развивается параллельно — новинки доступны на обеих платформах. На MODX 3 дополнительно: новый движок миниатюр и админка лексиконов на Vue.
• Новая схема миниатюр в MODX 3. Вместо внешних генераторов миниатюр версия для тройки несёт собственный движок превью на league/glide: генерация по подписанным URL (защита от подбора параметров), свой кэш, конвертация на лету (по умолчанию — в «webp»), настраиваемые драйверы и параметры обработки. Без завязки на сторонние сниппеты.

Темы оформления — одна база контента, сколько угодно дизайнов (и на 2, и на 3)

Самое интересное обновление, и оно сразу на обеих версиях. В MPC контент и вёрстка живут раздельно: что показываем (тексты, переводы, картинки, значения полей) хранится отдельно и адресуется по имени «секция.поле», а как показываем — в чанках секций, которые MPC генерирует из вашей размеченной вёрстки. На этом построен полноценный механизм тем:

• Тема — это второй комплект вёрстки, который вы готовите привычным способом: размечаете HTML атрибутами

  data-mpc-*

  и режете одной командой, только в папку темы.
• Контент не дублируется и не перетирается — он общий для всех тем.
• Тема работает как оверрайд-слой: переопределяете только секции с другой разметкой, остальное берётся из базовой вёрстки.
• Переключение — системной настройкой, на весь сайт или для отдельных шаблонов.

Сгенерировать вёрстку темы (контент не трогается) и включить её:

mpc cut all --theme=dark
mpc theme set dark

Итог: наполнили сайт один раз — а сезонный скин, A/B-вариант дизайна или быстрый рестайл клиентского проекта собираете без повторного наполнения. И всё это контент-менеджер по-прежнему правит визуально.

Источники файлов: храните ассеты в облаке и не думайте, кто их загрузил

Все загрузки медиа идут через MODX Media Sources, поэтому ассеты можно держать в облаке (S3 и любой источник, который вы настроите). Но главное — единый пайплайн: неважно, кто добавляет картинку, контент-менеджер через визуальный редактор или верстальщик при нарезке макета — файл проходит одним путём:

• попадает в нужный источник и в правильную папку (по типу и по полю — постер видео не уедет в папку с роликами);
• проходит через ваши проектные плагины и события

  OnFileManagerBeforeUpload

  /

  OnFileManagerUpload

  — включая авто-конвертацию из «jpg» в «webp»;
• получает корректный финальный URL после возможной конвертации.

Никакого «у редактора одна логика загрузки, у нарезки — другая»: один механизм, один источник, предсказуемый результат.

Что ещё нового

• История изменений с откатом — модалка «кто, когда, что» с инлайн-диффом и откатом правки одним кликом.
• Удобнее работать со списками — всегда видимая кнопка-хэндл для смены порядка строк и бейдж у секций-копий с адресом оригинала.
• Произвольные ключи переводов через

  data-mpc-lexicon

  , выключатель установки языка и событие

  setLanguageSettings

  .
• Сниппет

  mpcContacts

  — выборка контактов по типу, плейсменту и ключу с рендером через чанк.
• Только в MODX 3 — админка лексиконов на Vue 3 + PrimeVue (из VueTools): трёхпанельный интерфейс, экспорт в XLSX/ZIP, импорт.

Совместимо с MODX 2 и MODX 3. mpcVisualEditor работает в связке с MPC; админка лексиконов на Vue — в версии для MODX 3 (нужен пакет VueTools).