Оглавление

Начальная настройка

После того как вы скачали установочный пакет MODx Revolution обычной (Traditional) версии, загрузите .zip архив на свой сервер. Далее необходимо распаковать архив с файлами на вашем сервере. Скопируйте или переместите все файлы в новом извлеченном каталоге версии MODx в каталог, в который вы хотите установить MODx. Вы можете удалить извлеченную папку и ее содержимое, а также ZIP-файл MODx после завершения установки.

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

Использование FTP для копирования распакованных файлов на сервер может привести к повреждению или неполной передаче, что скорее всего повлечет за собой ошибки во время установки системы и невозможность работать с ней в дальнейшем.

Помимо прочего, копирование файлов через FTP крайне долгий процесс. Лучше всего заливать файлы на сервер в ZIP-архиве, и распаковывать их уже непосредственно на сервере, с помощью утилит хостинг-провайдера.

Установка MODx в корневой каталог на чистом сайте

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

Установка MODx на поддомен

Наряду с предыдущим вариантом, так же является предпочтительным. Идеально подходит для разработки сайтов. Например, разместив сайт на поддомене dev, можно вести разработку основного сайта именно на нем, не затрагивая при этом работу основного сайта. После завершения разработки, на поддомене dev. можно прописать редирект в файле .htaccess. Это нужно на тот случай, если пользователь вдруг попадет на поддомен dev.

Пример редиректа:

# Редирект с поддомена, без явного указания имени поддомена
RewriteCond %{HTTP_HOST} ^(.+).example.com$
RewriteRule (.*) http://example.com/$1 [L,R=301,QSA]

# Редирект с поддомена, с явным указанием имени поддомена
RewriteCond %{HTTP_HOST} ^dev.example.com$ [NC]
RewriteRule (.*) http://example.com/$1 [L,R=301,QSA]

Установка MODx в подкаталог

Разработка сайтов часто начинается в подкаталоге, а затем по завершению, сайт перемещается в корневой каталог. Метод подкаталога полезен, если у вас есть существующий сайт, который должен оставаться доступным для пользователей во время разработки. Также можно оставить MODX в подкаталоге и использовать .htaccess редиректы, чтобы переписать ваши URL-адреса в корень.

Установка MODx рядом с существующим статическим HTML-сайтом

Если ваш существующий рабочий сайт является статическим html с index.html или подобной стартовой страницей в корне, вы можете установить MODx в корневую папку рядом со статическим сайтом на время разработки. Когда вы будете готовы начать работу с MODx, переименуйте или переместите ваши статические HTML-файлы, и MODx начнет работать вместо вашего старого html сайта.

Не включайте Friendly URL при использовании этого метода до тех пор, пока ваши HTML-файлы не будут перемещены или переименованы. Ну и обязательно сделайте резервную копию существующего сайта перед установкой MODx Revolution или внесением каких-либо изменений в текущую файловую структуру.

Установка MODx рядом с существующим динамическим сайтом под управлением любой CMS

Не устанавливайте MODx Revolution в каталог, в котором работает другой динамический сайт (под управлением CMS), пока этот сайт не будет удален. Используйте, например, метод подкаталога для разработки MODx в этом случае.

Наиболее безопасными, удобными и практичными способами установки MODx Revolution являются:

  1. Установка MODx в корневой каталог на чистом сайте
  2. Установка MODx на поддомен
  3. Установка MODx в подкаталог

Установка MODx Revolution

Переходим к процессу установки. В веб-браузере обращаемся к имени вашего сайта и запускаем скрипт установки, дописав /setup.

Пример:

http://example.com/setup/

Перед запуском установки убедитесь, что ваши каталоги core/cache/ и core/config/ доступны для записи в PHP.

После этого, вам будет представлен экран с некоторыми опциями установки:

Выбор языка Backend админ-панели MODx.

Using Friendly URLs

Теперь необходимо выбрать вариант установки и задать права каталогам и файлам.

Using Friendly URLs

Продолжаем настройку на этой же странице. Теперь нам необходимо задать права для новых каталогов и файлах. Можете оставить по умолчанию. Так же рекомендую снять галочку с пункта "Отправлять заголовок X-Powered-By". Это необходимо для дополнительной безопасности вашего сайта.

Using Friendly URLs

Когда закончите настройки - нажимаем кнопку «Далее».

Параметры базы данных

Теперь вам необходимо ввести параметры соединения с вашей базой данных.

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

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

Using Friendly URLs

Заметки по работе с MySQL

Если вы используете свой сервер MySQL с отключенной сетью, вы можете указать имя сокета следующим образом: unix_socket=MySQL.

Заметки по работе с Microsoft SQL Server

Поддержка Microsoft SQL Server была представлена в MODX Revolution 2.1

В зависимости от конфигурации вашего SQL сервера, вы можете указать свой хост по-разному.

  • Named pipe: (local)/SQLEXPRESS
  • Tcp/ip: 127.0.0.1,2301 (IP, port)

Когда закончите настройки - нажимаем кнопку «Далее».

Кодировки и сопоставления

Появляется другая форма для настройки кодировки и сопоставления вашей базы данных:

Базовая установка MODX

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

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

Заметки по работе с Microsoft SQL Server

MODX был протестирован только с набором символов SQL Server Latin1.

Создание пользователя-администратора

Эта форма имеет несколько полей для настройки администратора вашего сайта. Данный пользователь будет иметь все возможные права (sudo). Укажите данные пользователя, которые вы хотите использовать для главного администратора вашего сайта.

Создание пользователя-администратора

MODx рекомендует не использовать значения «admin» в причинам безопасности. Создавайте надежные данные пользователя.

Конфигурации некоторых хост-серверов не позволяют MODx отправлять электронные письма, если электронная почта в системной настройке MODx с ключом emailsender (значение устанавливается автоматически, при вводе email в данных администратора, в предыдущем пункте данной документации) недопустима для текущего домена сайта.

Если MODx не отправляет электронные письма с регистрацией или формой, проверьте отправителя электронной почты и установите для него действительный адрес электронной почты для текущего домена сайта.

Нажмите «Далее», когда закончите ввод данных.

Проверка перед установкой

Далее MODx сообщит вам, если какие-либо ошибки произошли во время установки, и предложит вам попытаться переустановить систему. Если напротив всех пунктов зеленое значение, значит все прошло хорошо.

Проверка перед установкой MODx

Когда установка будет успешной, нажмите «Далее», чтобы продолжить установку. Далее вам будет представлен последний шаг.

Успешная установка

Теперь можете просмотреть отчет об установке MODx.

Успешная установка MODx

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

Успешная установка MODx

ВНИМАНИЕ: установочный пакет представляет из себя очень мощный контроль над вашим сервером. НЕ оставляйте его на хостинге после завершения установки MODx. Лучшим решением будет - его удаление.

Когда все будет готово, нажмите «Войти», чтобы увидеть форму входа в интерфейса админ-панели.

На этом установка базовой версии MODx завершена!