Обновление MODX Evolution до последней версии

Несмотря ни на что, MODX Evolution по прежнему жива (хотя сейчас, в большей степени, все проекты веду на ветке Revolution). Система хороша как для небольших сайтов и сайтов-визиток, так и вполне себе серьезных проектов, плюс обладает очень шустрой и в последних версиях весьма красивой панелью управления. Единственное, не рекомендовал бы на её основе делать интернет-магазин. Сегодня расскажу, как обновить систему MODX Evolution до последней версии (на данный момент 1.2.1).

Обновление движка сайта на MODX Evolution

1. Для начала следует сделать бекап всех файлов и базы данных сайта. Обычно этот шаг я пропускаю, так как бекапы за последние несколько дней имеются у хостера и можно легко откатиться назад.
2. Переименовываем папки assets и manager. Папки assets и manager переименовываем _assets и _manager соответственно. Из этих каталогов далее мы перенесем нужные нам файлы. Также удаляем index.php и index-ajax.php (они заменятся новыми файлами из дистрибутива)
3. Заливаем файлы нового дистрибутива MODX Evolution на сервер. В корень нашего сайта распаковываем архив нового дистрибутива Modx Evolution.
4. Переписываем файл конфигурации config.inc.php. Из старой копии каталога _manager/includes/ переносим файл конфигурации config.inc.php в новый каталог manager/includes/. Наличие данного файла даёт понять установщику MODX, что мы делаем обновление, а не новую установку.
5. Открываем сайт и нажимаем на ссылку install now. Тут нам будет предложено сделать обновление существующей установки - просто следуем инструкциям, устанавливаем все дополнения и соглашаемся с условиями лицензии. На этом обновление движка завершено и можно благополучно заходить в админку.

Перенос дополнений и шаблонов из _assets в assets

Если с админкой у нас сразу всё хорошо, то этого нельзя сказать про сам сайт. Либо у нас выводится только контент, без всякого оформления, либо вообще видим просто ругань на экране "MODX encountered the following error while attempting to parse the requested resource:".

Без паники, это нормально - у нас просто остались не перенесены из каталога _assets шаблоны и разные дополнения и сниппеты.

Сверяем чего не хватает и переносим недостающие файлы и каталоги:

/assets/templates/
/assets/snippets/
/assets/plugins/
/assets/modules/
/assets/images/
/assets/files/

После того как всё перенесено и заработало не забываем удалить старые каталоги _manager и _assets.