Установка
- Качаем архив с актуальной версией с офф. сайта;
- Разархивируем в рабочую директорию на хостинге или на локальном веб-сервере;
- Создаем для сайта базу данных MySQL/MariaDB;
- Запускаем в бразуере
sitename.ru/setup, гдеsitename.ru- домен нашего сайта. Этим мы запустим установку системы. - В разделе "Параметры" выставляем следующее:
- Новая установка;
- Права, назначаемые новому каталогу - 755;
- Права, назначаемые новому файлу - 644;
- Отключить сжатие CSS/JS - Да;
- Отправлять заголовок "X-Powered-By" - Нет. Это заголовок, отправляемый сервером о системе, на которой работает сайт. С одной стороны, это влияет на мировую статистику использования modX, с другой стороны снижает безопасность т.к. хакеры могут узнать на какой системе сайт и при наличии активных уязвимостей, сломать его;
- В разделе "Информация о подключении" выставляем следующее:
- Тип базы данных - mysql;
- Указываем данные подключения - сервер, логин, пароль, имя базы;
- Выбираем префикс таблиц с обязательным нижним подчеркиванием на конце. Он будет использован для создания таблиц. По умолчанию, modx_, но мы можем выбрать любой другой$
- Нажимаем "проверить подключение". Если "Успешно" то оставляем предложенную кодировку -
utf8и сопоставление -utf8_general_ci, если нет - исправляем ошибки; - Нажимаем "Попытка создания или выборки из базы данных";
- Указываем персональные данные для учетной записи.
- Нажимаем "Установить". Исправляем ошибки, если таковые есть;
- Пробуем войти в админку используя ранее указанные логин и пароль.
- Если все в порядке то система установлена и можно приступить к настройке.
Настройка
Создаем ресурс для 404 ошибки т.е. для страницы, на которую будет перенаправлен посетитель, если вдруг запрашиваемая страница будет отсутствовать на сайте;
Идем в "Системные настройки" (В правом верхнем углу шестеренка, в выпадающем списке 1 пункт - Системные настройки) и далее по пунктам:
| Раздел | Ключ | Значение | Описание |
| Словарь и язык | locale | ru_RU.UTF8 | Установка русской локали по умолчанию. Это также повлияет на возможность редактировать файлы средствами modX |
| Сайт | site_name | %Свое название сайта% | Название проекта, которое можно будет выводить на сайте через плейсхолдер ++site_name |
| Сайт | publish_default | Да | Да |
| Сайт | error_page | id, созданного ресурса для 404 | На эту сраницу будет пересылаться посетитель, если запрашиваемая им страница будет отсутствовать на сайте |
| Система и сервер | feed_modx_news_enabled | Нет | Убрать отображение виджетов безопасности и новостей modX |
| Система и сервер | feed_modx_security | Нет | |
| Система управления | manager_week_start | 1 | Ставим первый день недели |
| Система управления | manager_time_format | H:i | Выставляем 24-часоой формат времени в админке, вместо английских pm и am |
| Дружественные URL | friendly_urls | Да | Включаем ЧПУ (Человекопонятные урлы), чтобы вместо адресов страниц index?id=23 было catalog/. Потребуется донастройка файла .htaccess в корне сайта |
| Дружественные URL | friendly_urls_strict | Да | Включаем переадрессацию на канонический урл ресурса |
Включив ЧПУ, нужно переименовать файл ht.access в корне сайта на .htaccess.
Установка компонентов
Здесь будет перечислен список основных компонентов, которые упростят разработку и сделают сайт удобнее.
| Название | Описание | Документация |
| Translit | Автоматическая транслитерация алиасов для вновь создаваемых ресурсов. После установки, выставляем в системных настройках automatic_alias - Да, friendly_alias_translit - russian |
- |
| Filetranslit | Автоматическая транслитерация загружаемых файлов ерез файловый менеджер | - |
| Ace | Подсветка кода для редакторов сниппетов, чанков, шаблонов и т.д. | - |
| CKEditor | Текстовый редактор для контента. | ссылка |
| Collections | Модуль для удобного хранения ресурсов в дереве слева. Дочерние ресурсы помещаются в специальный контейнер родительского ресурса и выводятся там пачками. | ссылка |
| MIGX | Компонент, добавляющий новый тип TV-поля в виде таблиц, которые можно самому настроить | ссылка |
| pdoTools | Один из базовых компонентов для комфортной работы с ресурсами: гибкий функционал для выборок ресурсов и вывода их на сайте. Шаблонизатор Fenom, расширяющий возможности разработки | ссылка |
| FormIt | Компонент отправки форм из фронта сайта | ссылка |
| AjaxForm | Компонент отправки форм без перезагрузки страницы. Работает совместно с FormIt | |
| SimpleSearch | Компонент для поиска по сайту | ссылка |
| phpThumbOn | Компонент для обработки и вывода изображений | ссылка |