Ставим MODx впервые

Первичная установка MODx должна выполняться из авторской сборки. Лучше каждую новую версию ставить в собственную папку, например, MODx 0.9.6.3 мы ставим на локальной машине (работает комплект Denwer) в папку  c:\WebServers\home\modx0963\.

Об установке локального сервера см. специальную заметку.  Там мы упомянули, что для MODx приготовлен специальный каталог c:\WebServers\home\modx0963\www.

Сборку MODx из ZIP-архива modx-0.9.6.3.zip распаковываем в www, чтобы получились папки и файлы:

c:\WebServers\home\modx0963\www\assets\
c:\WebServers\home\modx0963\www\install\
c:\WebServers\home\modx0963\www\manager\
c:\WebServers\home\modx0963\www\sample-robots.txt
c:\WebServers\home\modx0963\www\ht.access
c:\WebServers\home\modx0963\www\index.php
c:\WebServers\home\modx0963\www\index-ajax.php

 Далее заходим браузером в http://modx0963/install/. Открывается страница установки:

Выбираете русский язык и следуете дальше по шагам, очень внимательно читая все сообщения. Настоятельно рекомендуем прямо сейчас ознакомиться с заметкой о кодировках.

На этом этапе устанавливается логин и пароль главного администратора сайта. Так как сайт локальный, пароль может быть простенький, но когда-то и переезжать на хостинг придется... Так что лучше сразу, "по взрослому".

Не забудьте этот пароль! Как ни смешно, но мы встречали знаем пару человек, которые это единственный пароль умудрились забыть!
Пароль записан в базе данных в зашифрованном виде и его просто так ни прочитать, ни заменить. Хотя заменить возможно - об этом мы как-нибудь напишем в специальной заметке.

Теперь заходим браузером на http://modx0963/ и видим демонстрационный сайт со стороны посетителя (front-end):

Ну, тут мы его немножко попортили  - написали несколько тестовых фраз по-русски. Вообще-то рекомендуем этот "сайт" держать как эталонный и не особо редактировать в нем контент. Разве что на главной странице написать что-нибудь по-русски, да проверочные волшебные фразы В чащах Юга жил-был цитрус, да, но фальшивый экземпляр в разных регистрах. Это чтобы проверить отображение всех русских букв - бывали проблемы с некоторыми.

Если всё сделано правильно - сайт будет работать. Под правильно мы имеем ввиду:

а) Применяйте кодировку UTF-8. Все оправдания использования windows-1251 несостоятельны. Поверьте на слово если не нам, так гуру MODx. Подробнее см. заметку о кодировках в MODx.

б) Не работайте с базой данных пользователем root даже на своей собственной машине. Создайте пользователя (лучше с именем, как у сайта, например modx0963, и с ограниченными правами. Например с привилегиями  SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, RELOAD, PROCESS, FILE, REFERENCES, INDEX, ALTER, SHOW DATABASES, CREATE TEMPORARY TABLES, LOCK TABLES, EXECUTE, REPLICATION SLAVE, REPLICATION CLIENT, но не GRANT и SUPER. Это позволит избежать ряда проблем.  Подробнее см. заметку о кодировках в MODx.

Для рабочего сайта можно сделать отдельную инсталляцию или просто скопировать установленную первичную эталонную инсталляцию и базу данных. Разумеется, базу данных надо сделать с другим именем, и не забыть прописать именно её в config.inc.php.

Однако чаще всего сайт не заново создается, а переводится из старой CMS. Вот этот наш сайт сначала жил под собственной CMS на JSP с базой данных в Firebird, потом перехал на CMC Etomite, там мигрировал несколько раз до версии Etomite 1.1, потом перехал под MODx (уж не помним какой из 0.9.х версий, а сейчас - под 0.9.6.3.  Каждый переезд сопровождался множеством приключений. И это еще только начало...

Подробную пошаговую инструкцию по переезду  с Etomite на MODx мы еще напишем.

Вообще-то можно сделать и очень просто, с минимумом действий, но лучше потратить время и полностью переработать сайт - от дизайна до используемых шаблонов.

В других заметках мы разберем "чисто конкретно"  многие вопросы, а пока обратим внимание на первоочередные действия.

Минимальные настройки MODx в административной панели.

Заходим в Инструменты - Конфигурация и далее заглядываем на вкладки Сайт, Семантические URL, Пользователи, Интерфейс и представление, Файл-менеджер. 

Вкладка Сайт

Первым делом нужно установить русский язык (если "оно само") не установилось.

Язык Системы Управления: Russian (UTF-8)
Кодировка: Unicode (UTF-8) -utf-8

Вводим Заголовок  нашего сайта.

Вкладка Семантические URL

 Нет никаких причин, чтобы не использовать эту возможность. Без включения Семантических URL в адресную строку браузера будет выводиться нечто наподобие http://www.mysite.ru/index.php?1494. А если включены, то будет  http://www.mysite.ru/1494.html. Уже лучше.

Но если мы еще пометим Использовать псевдонимы в URL  - Да, то вместо "номерной" страницы у нас будут использоваться "человекопонятные" псевдонимы. Например http://www.mysite.ru/ustanovka-modx.html

  А вот Автоматически генерировать псевдоним следует установить Нет. Заголовки наших страниц русские, MODx не сможет корректно генерировать из них псевдонимы. Для автоматического создания псевдонимов нам придется установить плагин AutoAliasRus2Lat.

И, наконец, для того, чтобы семантические URL заработали, необходимо настроить файл .htacces.  В сборке MODx имется файл ht.accsess в корне сайта, вот его-то надо переименовать в  .htacces. Здесь записывается множество настроек, некоторые мы будем впоследствии добавлять, но на первый раз достаточно убедиться, что в .htaccess есть и не закомментированы строки:

RewriteEngine On
# The Friendly URLs part
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php?q=$1 [L,QSA] 

Вкладка Пользователи

Рекомендуем для начала оставить всё по умолчанию.

Вкладка Интерфейс и представление

Здесь самое важное - подбор текстового редактора - "по руке". Или по ноге.  На эту тему у нас есть несколько специальных заметок.

 Вкладка Интерфейс и представление

Здесь нужно проверить Путь файлового менеджера. Он должен быть наподобие z:/home/my_site/www/assets/. Тем самым мы ограничиваем папкой assets возможность изменять, загружать и удалять файлы.

На этом черновые настройки MODx можно считать законченными.

Далее, если мы хотим сделать свой сайт многофункциональным, придется много поработать.  Об этом - серия наших других заметок о MODx.