• Ростов-на-Дону
  • пн-пт 10:00–20:00

Минификация HTML на лету в MODX 3

Плагин Minify_html для MODX 3 сжимает HTML прямо на выходе страницы: убирает лишние переносы строк, повторные пробелы и незначимые комментарии. Работает без сторонних библиотек, не трогает скрипты, стили и блоки с примерами кода. Подключается за минуту, нужные страницы можно исключить.

  • 10
  • 0
  • 20.10.2026

Плагин Minify_html на событии OnWebPagePrerender сжимает готовый HTML страницы перед отдачей в браузер: убирает лишние переносы строк, повторные пробелы и незначимые комментарии. Работает без сторонних библиотек, на 25 строках кода.

Зачем это нужно

Каждый байт HTML передаётся по сети при каждом запросе страницы. Типичная вёрстка MODX содержит много «воздуха» — переносы строк и отступы от шаблонизатора и редактора. Их сжатие:

Плагин сознательно не делает агрессивную минификацию (склейку тегов, переименование классов, удаление всех комментариев). Такая оптимизация требует полноценного HTML-парсера, а «ручная» — ломает вёрстку. Здесь выбран принцип KISS: делать только безопасные и предсказуемые преобразования.

Что делает плагин

  1. Прячет от обработки содержимое <script>, <style>, <pre>, <textarea> — там пробелы и переносы значимы и трогать их нельзя.
  2. Удаляет HTML-комментарии, кроме условных <!--[if …]> и блоков <!--noindex-->.
  3. Схлопывает переносы строк вместе с окружающими пробелами в один пробел.
  4. Схлопывает повторные горизонтальные пробелы (табы, двойные пробелы) в один.
  5. Возвращает защищённые блоки на место и обрезает результат по краям.

Установка

  1. В админке MODX перейдите в Элементы → Плагины → Создать плагин.
  2. В поле «Название» укажите Minify_html.
  3. Вставьте код, он вставлен ниже.
  4. На вкладке «Системные события» отметьте галочку OnWebPagePrerender.
  5. Сохраните плагин и очистите кэш сайта.

 

<?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 не заменяет полноценный минификатор и не претендует на это:

Если нужен больший выигрыш, включайте gzip/brotli на сервере — это даст в разы больше и без риска сломать вёрстку. Плагин хорошо работает в паре с серверным сжатием, а не вместо него.

Проверка результата

  1. Откройте любую страницу сайта, кроме исключённых.
  2. Просмотр кода в браузере — HTML должен идти без лишних переносов и отступов.
  3. Сравните размер до и после через DevTools → вкладка Network → размер ответа.
  4. Убедитесь, что страницы с <pre> (например, документация с примерами кода) отображаются корректно — отступы внутри сохранены.

Если что-то пошло не так — просто отключите плагин Minify_html на вкладке «Системные события», очистите кэш, и сайт вернётся к исходному поведению.

 

Комментариев пока нет.

Оставить комментарий