
В Modx стандартные URL часто формируются с расширением .html, что может мешать чистой структуре ссылок и усложнять SEO-оптимизацию. Удаление этого суффикса позволяет получить «чистые» URL без потери функциональности сайта и перенаправлений.
Для отключения .html в Modx необходимо изменить параметр friendly_urls в System Settings на Yes и указать friendly_urls_suffix как пустую строку. Это автоматически исключит добавление суффикса при генерации новых страниц.
Важно дополнительно настроить файл .htaccess в корне сайта. Необходимо раскомментировать или добавить правила переписывания URL с использованием mod_rewrite, чтобы сервер корректно обрабатывал запросы без .html и не создавал дубли страниц. Например, правило RewriteCond %{REQUEST_FILENAME} !-f и RewriteRule ^(.*)$ index.php?q=$1 [L,QSA] обеспечивает перенаправление всех запросов на движок Modx.
После внесения изменений следует проверить работу всех страниц и ссылок, включая внутренние меню и формы. Для сайтов с большим количеством проиндексированных страниц рекомендуется настроить 301 редиректы со старых URL с .html на новые чистые ссылки, чтобы сохранить позиции в поисковых системах и избежать ошибок 404.
Проверка текущих настроек дружественных URL в Modx

Для точной проверки состояния дружественных URL необходимо убедиться, что системные настройки Modx соответствуют требованиям корректного формирования ссылок без .html в конце.
Перейдите в «Система» → «Настройки» и выполните проверку следующих ключевых параметров:
| Параметр | Описание | Рекомендуемое значение |
|---|---|---|
| friendly_urls | Включает поддержку ЧПУ (Человеко-Понятных URL) | Да |
| friendly_alias_urls | Разрешает использование алиасов ресурсов вместо ID | Да |
| use_alias_path | Формирует URL с учётом структуры каталогов | Да, если требуется вложенная структура |
| friendly_url_suffix | Добавляет суффикс к URL (например, .html) | Оставить пустым для удаления .html |
После изменения параметров необходимо очистить кеш Modx через «Управление» → «Очистить кеш» для применения новых настроек.
Для проверки корректности работы URL используйте вкладку «Ресурсы» и откройте несколько страниц. Убедитесь, что ссылки формируются без .html и соответствуют структуре сайта. Если ссылки содержат старый суффикс, проверьте файл .htaccess на наличие правил редиректа, которые могут добавлять .html к URL.
Редактирование системных настроек для отключения.html

Для удаления .html из URL в Modx изменяются системные настройки, отвечающие за генерацию ЧПУ.
- Включение friendly URLs: В разделе Система → Настройки → Системные настройки найдите параметр
friendly_urlsи установите значениеДа. - Удаление суффикса: Параметр
friendly_urls_suffixсодержит.htmlпо умолчанию. Очистите поле, чтобы URL формировались без суффикса. - Настройка base URL: Параметр
base_urlдолжен быть установлен в/или соответствовать корню сайта. Неправильный путь приведет к ошибкам маршрутизации. - Очистка кэша: После изменения настроек перейдите в Управление → Очистка кэша для обновления ЧПУ.
Проверка .htaccess:
- Включен
RewriteEngine On. - Правило
RewriteCond %{REQUEST_FILENAME} !-fисключает существующие файлы из перезаписи. - Правило
RewriteRule ^(.*)$ index.php?q=$1 [L,QSA]обеспечивает маршрутизацию без .html.
После внесения изменений проверьте работу всех страниц и ссылок. Любая ошибка 404 указывает на неправильную настройку friendly URLs или base URL.
Использование правил перезаписи в.htaccess

Для удаления .html в конце URL в MODX необходимо использовать модуль Apache mod_rewrite. В корневом файле .htaccess включите механизм перезаписи командой RewriteEngine On.
Основное правило для удаления расширения выглядит так:
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)\.html$ /$1 [R=301,L]
Эта конфигурация выполняет проверку: если запрашиваемый ресурс не является существующим файлом или директорией, 301 редирект убирает .html из URL, сохраняя структуру ссылок для поисковых систем.
Для корректной работы внутренних ссылок MODX следует дополнительно настроить Friendly URLs в системных настройках, установив friendly_urls=1 и friendly_urls_strict=0. Это предотвращает дублирование страниц и ошибки 404 после удаления расширения.
Если требуется обработка вложенных каталогов, рекомендуется использовать универсальное правило:
RewriteRule ^([^\?]*)\.html$ /$1 [R=301,L]
Данное правило сохраняет GET-параметры, корректно перенаправляет сложные URL и минимизирует нагрузку на сервер. После внесения изменений очистите кэш MODX и проверьте работу всех внутренних ссылок.
Настройка шаблонов страниц без расширения

В MODX удаление расширений типа .html осуществляется через настройки дружественных URL и конфигурацию шаблонов. Основной принцип – использование ЧПУ без указания типа файла.
Алгоритм настройки:
- Перейдите в Системные настройки → Сео → friendly_alias. Включите опцию, если она отключена.
- Установите use_alias_path в значение
Да, чтобы иерархия ресурсов отображалась в URL. - Настройте friendly_urls в
Да. Это позволяет MODX генерировать ссылки без расширений. - В friendly_urls_suffix оставьте поле пустым. Это ключевой шаг для удаления
.htmlс конца URL.
Для корректной работы необходимо убедиться, что сервер поддерживает mod_rewrite (Apache) или аналогичные правила для Nginx:
- Apache: проверьте наличие
.htaccessи включитеRewriteEngine On. - Nginx: настройте
try_files $uri $uri/ /index.php?$args;в блоке location.
После этого для каждого ресурса, у которого включен алиас, система будет автоматически формировать URL без расширения. Для шаблонов рекомендуется:
- Использовать уникальные алиасы для всех страниц, чтобы избежать конфликтов.
- Не включать точки и специальные символы в алиасах.
- Проверять генерацию ссылок через сниппеты типа
[[~id]], чтобы убедиться, что ссылки корректны.
Если необходимо перенаправление старых URL с .html, создайте правило 301 в .htaccess или настройте плагин Redirector. Это позволит сохранить SEO-показатели и избежать 404 ошибок.
Изменение ссылок на существующих ресурсах

Для удаления расширения .html с URL на существующих ресурсах в Modx необходимо изменить настройки системы и обновить пути ресурсов. В разделе «Система» → «Настройки» включите параметр «friendly_urls» и отключите «friendly_url_suffix». Это уберет автоматическое добавление .html к новым и существующим страницам.
После изменения настроек выполните массовое обновление URI через инструменты Modx. В таблице modx_site_content обновите поле «uri» для всех ресурсов: удалите суффикс .html, оставив чистый путь. Для крупных сайтов рекомендуется использовать SQL-запрос с функцией REPLACE: UPDATE modx_site_content SET uri = REPLACE(uri, '.html', '') WHERE uri LIKE '%.html';
Проверьте правильность перенаправлений. Для сохранения SEO-трафика создайте правило 301 в .htaccess: RewriteRule ^(.*)\.html$ /$1 [R=301,L]. Это обеспечит автоматическое перенаправление старых URL на новые без потери позиции в поисковых системах.
Обновите внутренние ссылки на сайте. Используйте поиск по базе данных или сторонние инструменты для замены ссылок в содержимом шаблонов, чанков и ресурсов. Все ссылки с .html должны указывать на новые чистые URI.
После выполнения изменений очистите кэш Modx через «Управление» → «Очистить кэш» и проверьте работу сайта. Любые ресурсы, имеющие конфликты URI после удаления .html, необходимо исправить вручную, чтобы избежать ошибок 404.
Проверка работы сайта после удаления.html

После удаления расширения .html необходимо проверить корректность перенаправлений. Используйте инструмент браузера или расширения типа Redirect Path, чтобы убедиться, что старые URL перенаправляются на новые без ошибок 301.
Пройдите по всем ключевым страницам сайта и убедитесь, что контент загружается корректно, изображения и скрипты работают без ошибок 404. Особое внимание уделите динамическим страницам и разделам с фильтрами, где изменение URL может нарушить маршрутизацию.
Проверьте внутренние ссылки: используйте Screaming Frog или Netpeak Spider для сканирования сайта. Они покажут все устаревшие ссылки, которые ведут на URL с .html, и помогут оперативно исправить их.
Анализируйте данные из Google Search Console. После удаления .html наблюдайте за отчетом «Покрытие» и «Страницы с ошибками», чтобы выявить битые ссылки и страницы с проблемами индексации.
Проверьте внешние ссылки на сайт через Ahrefs или Majestic. Обновление URL на внешних ресурсах важно для сохранения SEO-эффекта и предотвращения потери трафика.
Не забудьте проверить карту сайта (sitemap.xml) и robots.txt. Убедитесь, что новые URL присутствуют в карте сайта и правильно обрабатываются поисковыми системами без конфликтов с предыдущими правилами.
Наконец, проведите нагрузочное тестирование ключевых страниц, чтобы убедиться, что изменение структуры URL не повлияло на скорость загрузки и стабильность сервера.
Исправление возможных ошибок 404 после изменения URL

После удаления расширения .html из URL в MODX ресурсы становятся доступными по новым адресам, что приводит к появлению ошибок 404 для старых ссылок. Первым шагом необходимо создать 301 редиректы с устаревших URL на новые. В MODX это реализуется через системный плагин «Redirector» или добавление правил в .htaccess:
Пример правила для Apache:
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)\.html$ /$1 [R=301,L]
Для Nginx редирект на уровне конфигурации сервера выглядит так:
rewrite ^/(.*)\.html$ /$1 permanent;
После внедрения редиректов важно проверить существующие внутренние ссылки. Используйте MODX-панель для массового обновления ссылок в чанках, шаблонах и ресурсах. Ошибки 404 можно отследить через логи сервера или инструменты аналитики, например Google Search Console.
Если на сайт ведут внешние ссылки, рекомендуем сгенерировать карту сайта с актуальными URL и отправить её в поисковые системы. Это ускорит переиндексацию и минимизирует потерю трафика.
Для динамических ресурсов, где URL формируется через сниппеты, убедитесь, что все вызовы автоматически формируют новый формат без .html. Проверка всех ссылок через сканер сайта предотвращает скрытые ошибки 404.
Вопрос-ответ:
Почему в URL моего сайта на Modx появляется .html в конце, и как это убрать?
В Modx добавление .html к URL происходит из-за настроек дружественных ссылок (friendly URLs). Чтобы убрать это расширение, нужно открыть системные настройки и найти параметр, отвечающий за суффикс URL, обычно он называется «friendly_url_suffix». Удалив .html из этого поля и сохранив изменения, ссылки на сайте перестанут содержать это расширение. После изменений рекомендуется очистить кэш сайта, чтобы новые URL корректно применились.
Влияет ли удаление .html на существующие страницы и SEO моего сайта?
Удаление .html изменяет адреса всех страниц, поэтому старые ссылки станут недоступны, что может повлиять на поисковый трафик. Чтобы сохранить SEO, следует настроить 301 редиректы с прежних URL на новые без .html. Это можно сделать через файл .htaccess или специальные плагины для Modx. Такой подход позволяет избежать ошибок 404 и сохраняет позиции страниц в поисковых системах.
Можно ли убрать .html только у новых страниц, не трогая старые?
Да, это возможно с помощью настроек шаблонов или индивидуальной настройки ресурсов. Например, при создании новых страниц можно указывать пустое значение суффикса URL или использовать другой шаблон с нужными правилами формирования ссылок. Старые страницы при этом сохранят свои адреса с .html. Такой метод удобен, если сайт большой и перенастройка всех ссылок сразу нежелательна.
После удаления .html некоторые ссылки перестали работать. Что делать?
Если ссылки перестали работать, скорее всего, сервер или Modx всё ещё кэширует старые URL, либо отсутствуют перенаправления с прежних адресов. Сначала очистите кэш сайта и браузера. Затем проверьте файл .htaccess — возможно, нужно обновить правила перезаписи URL. Для безопасности можно настроить 301 редиректы со старых ссылок на новые без .html, чтобы пользователи и поисковые системы корректно попадали на нужные страницы.
