Установка дополнений из репозитория в MODX: что проверить
Перед установкой дополнения в MODX проверьте его совместимость с вашей версией ядра и PHP, сделайте резервную копию и убедитесь, что сайт сможет скачать пакет. Это снижает риск сломанной админки и долгого отката.
Установка дополнения из репозитория MODX обычно занимает несколько минут, но ошибка совместимости может нарушить работу сайта или админки. До начала проверьте версию MODX и PHP, наличие резервной копии и доступ сервера к источнику пакета; ниже — порядок для MODX Revolution 2.8.x и 3.x. Названия пунктов интерфейса могут немного отличаться в зависимости от версии и перевода.
Что подготовить до установки
Нужна учётная запись с правами администратора в менеджере MODX. Для установки через менеджер сам сервер должен иметь доступ к сети и возможность записывать файлы в каталоги сайта. Если у вас нет доступа к резервным копиям, файловой системе или панели хостинга, попросите подготовить их до начала — после неудачной установки может понадобиться восстановление.
- Уточните версию MODX. Она отображается в менеджере, обычно в разделе системной информации. Запишите полную версию, а не только номер основной ветки.
- Проверьте версию PHP. Сравните её с требованиями дополнения и вашей версии MODX. Требования ищите на странице дополнения или в документации автора.
- Сделайте резервную копию файлов и базы данных. Проверьте, что копия доступна и её можно восстановить. Снимок только файлов не заменяет копию базы данных.
- Найдите страницу дополнения. Проверьте, когда оно обновлялось, для каких версий MODX предназначено и есть ли известные ограничения.
- Убедитесь, что сервер может скачать пакет. Если сайт находится на закрытом сервере или исходящие соединения ограничены, установка через менеджер может не сработать.
Пакет1 — архив дополнения с файлами и описанием действий, которые MODX выполняет при установке. У некоторых пакетов установщик создаёт или меняет объекты в базе данных. Поэтому откат — это не всегда просто удаление папки.
Сначала проверьте совместимость и восстановимость резервной копии, потом нажимайте «Установить». Репозиторий упрощает доставку дополнения, но не гарантирует, что оно подходит именно вашему сайту.
Установка через менеджер MODX
Для MODX Revolution 2.8.x и 3.x общий сценарий одинаков: найти дополнение в установщике, скачать пакет и запустить установку. Интерфейс и доступные источники могут различаться; не ориентируйтесь на скриншоты от другой версии без проверки.
- Откройте установщик дополнений. В менеджере перейдите в раздел Extras и выберите Installer («Установщик»). Проверка: открылась страница установщика со списком доступных пакетов или источников.
- Найдите нужное дополнение. Используйте поиск по точному названию, затем откройте карточку пакета. Сверьте название и автора: похожие названия не означают, что это один и тот же проект. Проверка: вы видите описание именно нужного дополнения и его варианты версий.
- Выберите подходящую версию пакета. Сверьте требования с версией MODX и PHP на сайте. Если автор не указывает совместимость или пакет давно не обновлялся, не устанавливайте его на рабочий сайт без теста. Проверка: выбран пакет, для которого подтверждена совместимость либо есть проверенная тестовая установка.
- Скачайте пакет. В карточке дополнения используйте действие загрузки в установщик. Дождитесь окончания загрузки; не закрывайте страницу, пока операция выполняется. Проверка: пакет появился в списке установщика и доступен для установки.
- Запустите установку и прочитайте сообщения. Если установщик показывает перечень изменений или предупреждения, проверьте их до подтверждения. Не игнорируйте ошибки доступа и сообщения о несовместимости. Проверка: установщик сообщает об успешном завершении, а не только о том, что пакет скачан.
- Проверьте результат на сайте. Откройте нужный раздел менеджера, проверьте настройки дополнения и выполните его основную функцию на тестовой странице. Затем проверьте публичную часть сайта и журналы ошибок. Проверка: нет ошибок в интерфейсе, страница открывается, ожидаемая функция работает.
Названия кнопок и разделов в разных сборках могут отличаться. Если в вашей версии нет описанного пункта или действия, сверьтесь с документацией именно для неё, а не пытайтесь повторить инструкцию для другой ветки MODX.
Если установка не удалась
Сначала сохраните текст сообщения установщика и проверьте журналы MODX и PHP. Не повторяйте установку несколько раз подряд: если часть действий уже выполнилась, повтор может усложнить диагностику.
- Пакет не скачивается. Проверьте доступ сервера к сети, ограничения хостинга и настройки источников пакетов. Если соединение закрыто, попросите администратора проверить исходящий доступ; не отключайте защиту сервера ради установки.
- Ошибка доступа или записи файлов. Проверьте владельца и права каталогов сайта вместе с хостинг-провайдером. Не выдавайте всем пользователям полный доступ к файлам: это создаёт риск для сайта.
- Установщик сообщает о несовместимости. Не обходите предупреждение вслепую. Найдите пакет для своей версии MODX либо проверьте дополнение на копии сайта.
- Установка завершилась, но функция не работает. Очистите кэш MODX через менеджер, проверьте настройки дополнения и журнал ошибок. Если проблема остаётся, зафиксируйте версию MODX, PHP и дополнения — без них автору сложно воспроизвести сбой.
- После установки перестала открываться админка или сайт. Откройте журналы ошибок и восстановите файлы и базу из резервной копии, если не можете безопасно откатить изменения вручную. При сомнениях подключите администратора сервера.
Точные формулировки сообщений зависят от версии MODX, PHP и хостинга. Примеры выше описывают типы проблем, а не гарантированно дословный текст ошибки.
Что делать после установки
Проверьте дополнение не только на главной странице: пройдите сценарий, ради которого его устанавливали, и загляните в журналы после нескольких обращений к сайту. Если обновление ядра или PHP запланировано, заранее выясните, поддерживает ли дополнение целевую версию. Для изменений на рабочем сайте сначала повторите установку на копии, а после успешной проверки обновите резервную копию и запишите версию пакета.
Инвалидация кэша, ручная установка пакета и откат сложных дополнений — отдельные темы; здесь разобран штатный сценарий через менеджер.
1 В MODX пакет часто называют транспортным пакетом: он содержит файлы дополнения и метаданные, по которым установщик может выполнить установку.
Проверка рекламы на риски: Что в макете вызовет вопросы ФАС: превосходные степени, сравнения, обещания результата, маркировка.
Спросить за 40 ₽Источники: Документация MODX Revolution, Репозиторий дополнений MODX
Частые вопросы
Нужно ли делать резервную копию перед установкой небольшого дополнения?
Можно ли поставить дополнение на MODX 3, если оно указано для MODX 2?
Что делать, если нужного дополнения нет в установщике?
Установка зависла или выдала ошибку. Можно попробовать ещё раз?
Что делать, если после установки сломалась админка?
Можно ли удалить дополнение кнопкой из установщика и считать откат завершённым?
Материал носит информационный характер и подготовлен редакцией «Агентуры». Он не является офертой, рекламой или индивидуальной консультацией. Упомянутые продукты, компании и торговые знаки принадлежат их правообладателям. Перед принятием решений, влекущих юридические или финансовые последствия, обратитесь к профильному специалисту.