Установка дополнений MODX из репозитория: разбор на примере

В MODX можно установить дополнение прямо из менеджера, но нажатие кнопки «Установить» ещё не подтверждает, что пакет подходит вашей версии ядра и сайта. На примере FormIt разберём путь от проверки совместимости до тестовой отправки формы, а заодно сравним установку через менеджер и вручную. В примере речь о MODX Revolution; точные названия пунктов меню могут различаться в зависимости от версии и перевода панели управления.

Что проверить до установки

FormIt обрабатывает отправку форм и может отправлять уведомления по электронной почте. Для простого теста понадобится тестовый сайт на MODX Revolution, доступ к панели управления с правами установки пакетов и форма, отправку которой можно проверить. На рабочем сайте сначала сделайте резервную копию файлов и базы данных. Не обновляйте ядро и не ставьте несколько дополнений одновременно: если что-то сломается, будет сложнее найти причину.

• Запишите версию MODX: её можно посмотреть в панели управления, обычно в разделе системной информации.
• Проверьте требования и сведения о совместимости FormIt на странице дополнения и в описании пакета перед установкой. Не считайте надпись «доступно» доказательством совместимости с вашей конфигурацией.
• Убедитесь, что сайт работает по HTTPS и что у вас есть доступ к почтовым настройкам, если будете тестировать отправку письма.
• Проверьте, что у файлов MODX и базы данных есть актуальные резервные копии, которые вы умеете восстановить.

Если это интернет-магазин или сайт с заявками, сначала повторите установку на копии. Цена ошибки здесь — не только неработающая форма: можно пропустить обращения, пока сайт выглядит исправным.

Установка FormIt через менеджер дополнений

В стандартной панели MODX Revolution установщик пакетов обычно находится в меню Extras (Дополнения) и называется Installer (Установщик). В разных версиях интерфейса подписи и расположение могут отличаться. Если пункта нет, проверьте права пользователя и документацию именно для вашей версии MODX, а не устанавливайте найденный в интернете пакет-файл наугад.

1. Откройте установщик. Найдите его в меню Extras и дождитесь загрузки списка пакетов. Проверка: интерфейс показывает каталог дополнений и поле поиска либо список доступных пакетов.
2. Найдите FormIt. Введите название в поиск и откройте карточку пакета. Сверьте имя, описание, автора и сведения о совместимости; не выбирайте похожее название только потому, что оно первым появилось в выдаче. Проверка: вы открыли карточку именно FormIt и видите сведения о версии пакета.
3. Выберите версию. Если установщик предлагает несколько вариантов, проверьте их требования к MODX и зависимости. Не выбирайте автоматически самый новый пакет, если документация не подтверждает совместимость с установленным ядром. Проверка: выбранная версия не помечена как неподходящая вашей конфигурации, а список зависимостей понятен.
4. Запустите установку. Подтвердите действие в установщике и дождитесь завершения. Не закрывайте страницу и не перезапускайте процесс, пока панель показывает установку. Проверка: установщик сообщает об успешной установке, а FormIt появляется среди установленных пакетов.
5. Очистите кэш и проверьте сайт. Используйте команду очистки кэша в панели MODX, затем откройте страницу с тестовой формой. Проверка: страница загружается без ошибки, форма отображается и отправляется.

Наличие пакета в списке установленных подтверждает только то, что MODX завершил операцию установки. Оно не проверяет бизнес-сценарий: обработку обязательных полей, получение письма или запись заявки туда, куда вам нужно.

Живой тест: отправляем форму

Проверьте FormIt на отдельной тестовой странице, а не на форме, от которой зависит поток заявок. Добавьте вызов сниппета по официальной документации FormIt для установленной версии и выведите тестовую форму. Синтаксис и параметры вызова здесь намеренно не приводим: они зависят от версии пакета и разметки формы, а копируемый пример без этих условий легко превращается в неработающую инструкцию.

Отправьте форму с корректными данными, затем повторите тест с пустым обязательным полем и с некорректным адресом электронной почты. Убедитесь, что посетитель получает ожидаемый результат, а заявка или уведомление попадают в нужное место. Если используется отправка почты, проверьте доставку и папку спама; сообщение об успешной отправке формы не доказывает, что письмо дошло.

Установка пакета заканчивается не тогда, когда исчезла полоска загрузки, а когда вы проверили сценарий, ради которого ставили дополнение.

Менеджер или ручная установка

Вручную обычно устанавливают пакет, когда его нет в доступном каталоге, нужен конкретный архив или установка через панель не проходит. Это не способ обойти проверку совместимости: перед загрузкой всё равно нужно проверить происхождение пакета, его версию и инструкции автора. Стандартный путь через менеджер удобнее для знакомства с дополнением, ручной требует больше контроля над файлами и доступами.

Что ломается и как откатить изменения

Если установщик сообщает об ошибке, не запускайте установку снова вслепую: сначала зафиксируйте текст ошибки и проверьте, появился ли пакет в списке установленных. Если после установки перестала открываться панель или сайт, восстановление зависит от того, успел ли пакет изменить файлы и данные. Поэтому до начала работы нужны резервные копии и понятный план возврата, а не только кнопка «Удалить».

• Пакет не находится. Проверьте написание названия и доступность каталога. Если поиск не помогает, откройте официальную страницу дополнения и сверьте, где автор публикует пакет.
• Установщик сообщает о несовместимости. Не обходите предупреждение на рабочем сайте. Сверьте версии MODX и пакета с требованиями автора; при отсутствии подтверждения проверьте пакет на копии.
• Страница после установки показывает ошибку. Очистите кэш, проверьте журналы ошибок MODX и веб-сервера. Если проблема появилась сразу после установки, сравните результат с резервной копией.
• Форма отправляется, но письма нет. Отдельно проверьте почтовую конфигурацию и доставку. Это может быть проблема почты, а не установка FormIt.
• Панель зависла во время установки. Не повторяйте операцию, пока не проверите состояние файлов и пакета. При сомнениях восстановите копию или обратитесь к администратору сервера.

Зависимость¹ — другой пакет или компонент, который нужен дополнению для работы. Если установщик предлагает поставить дополнительные пакеты, проверьте их назначение и совместимость: зависимость тоже меняет сайт и может повлиять на его работу.

Что делать дальше

После установки проверьте не только тестовую отправку, но и сценарий отказа: пустые поля, неверные данные, недоступность почты. На рабочем сайте следите за журналом ошибок и фактическим числом доставленных заявок, а не только за сообщениями об успешной отправке. Обновления FormIt и MODX проверяйте отдельно: перед каждым обновлением сверяйте требования, делайте резервную копию и сначала тестируйте изменения на копии сайта.