Плагин Minify_html на событии OnWebPagePrerender сжимает готовый HTML страницы перед отдачей в браузер: убирает лишние переносы строк, повторные пробелы и незначимые комментарии. Работает без сторонних библиотек, на 25 строках кода.
Зачем это нужно
Каждый байт HTML передаётся по сети при каждом запросе страницы. Типичная вёрстка MODX содержит много «воздуха» — переносы строк и отступы от шаблонизатора и редактора. Их сжатие:
- уменьшает размер ответа — обычно на 3–10% до gzip;
- снижает время загрузки на мобильных и медленных каналах;
- не требует изменений в шаблонах — плагин работает на уровне вывода.
Плагин сознательно не делает агрессивную минификацию (склейку тегов, переименование классов, удаление всех комментариев). Такая оптимизация требует полноценного HTML-парсера, а «ручная» — ломает вёрстку. Здесь выбран принцип KISS: делать только безопасные и предсказуемые преобразования.
Что делает плагин
- Прячет от обработки содержимое <script>, <style>, <pre>, <textarea> — там пробелы и переносы значимы и трогать их нельзя.
- Удаляет HTML-комментарии, кроме условных <!--[if …]> и блоков <!--noindex-->.
- Схлопывает переносы строк вместе с окружающими пробелами в один пробел.
- Схлопывает повторные горизонтальные пробелы (табы, двойные пробелы) в один.
- Возвращает защищённые блоки на место и обрезает результат по краям.
Установка
- В админке MODX перейдите в Элементы → Плагины → Создать плагин.
- В поле «Название» укажите Minify_html.
- Вставьте код, он вставлен ниже.
- На вкладке «Системные события» отметьте галочку OnWebPagePrerender.
- Сохраните плагин и очистите кэш сайта.
<?php
$cid = $modx->resource->get('id');
if (empty($cid)) return;
$exclude = $modx->getOption('exclude', $scriptProperties, '12');
if (in_array($cid, array_map('trim', explode(',', $exclude)))) return;
$ct = $modx->resource->getOne('ContentType');
if (!$ct || $ct->get('name') !== 'HTML') return;
$output = &$modx->resource->_output;
if (empty($output)) return;
// 1. Прячем блоки, где whitespace значим
$saved = [];
$output = preg_replace_callback(
'#<(script|style|pre|textarea)\b[^>]*>.*?</\1>#is',
function ($m) use (&$saved) {
$k = "\x00" . count($saved) . "\x00";
$saved[$k] = $m[0];
return $k;
},
$output
);
// 2. Комментарии, кроме условных IE и noindex
$output = preg_replace('/<!--(?!\[if|noindex).*?-->/s', '', $output);
// 3. Любой whitespace с переводом строки → один пробел
$output = preg_replace('/\s*\n\s*/', ' ', $output);
// 4. Повторные горизонтальные пробелы → один
$output = preg_replace('/[ \t]{2,}/', ' ', $output);
// 5. Возвращаем блоки
if ($saved) $output = strtr($output, $saved);
$output = trim($output); Настройка
В поле «Свойства плагина» (или через параметр exclude в вызове) можно задать список ID страниц, которые нужно исключить из сжатия:
| Ключ | Значение по умолчанию | Описание |
| exclude | 12 | ID ресурсов через запятую |
Исключение полезно для страниц с нестандартной разметкой: встроенные виджеты, интерактивные редакторы, страницы с inline-скриптами, чувствительными к форматированию.
Ограничения
Плагин Minify_html не заменяет полноценный минификатор и не претендует на это:
- не склеивает пробелы между inline-тегами (<em>a</em> <em>b</em>) — это сохраняет читаемость;
- не трогает содержимое <script>, <style>, <pre>, <textarea>;
- не поддерживает HTML-комментарии-маркеры JS-фреймворков (Knockout <!-- ko -->, Vue, Alpine) — если они используются, добавьте их в negative lookahead шага 2;
- сжимает скромно — на 3–10% до gzip.
Если нужен больший выигрыш, включайте gzip/brotli на сервере — это даст в разы больше и без риска сломать вёрстку. Плагин хорошо работает в паре с серверным сжатием, а не вместо него.
Проверка результата
- Откройте любую страницу сайта, кроме исключённых.
- Просмотр кода в браузере — HTML должен идти без лишних переносов и отступов.
- Сравните размер до и после через DevTools → вкладка Network → размер ответа.
- Убедитесь, что страницы с <pre> (например, документация с примерами кода) отображаются корректно — отступы внутри сохранены.
Если что-то пошло не так — просто отключите плагин Minify_html на вкладке «Системные события», очистите кэш, и сайт вернётся к исходному поведению.