Особенности установки системы MODX версии 1.0.10
Версия MODX 1.0.10 не требует специальной доработки перед установкой, и при правильной настройке хостинга должна достаточно легко устанавливаться. Вместе с тем не слишком опытным пользователям рекомендуется следовать рекомендациям, изложенным ниже, чтобы избежать проблем при установке системы. Однако следует отметить, что в последних версиях MODX при установке активно используется технология AJAX, и при возникновении проблем сложнее обнаружить их источник и внести необходимые исправления.
Подготовка к установке MODX
ВНИМАНИЕ! MODX Revolution – совершенно другая система, так что при скачивании не спутайте ее с MODX 1.0.10. В настоящее время MODX Revolution требует в несколько раз больше ресурсов на хостинге и работает в несколько раз медленнее, поэтому для большинства сайтов более подходит традиционная версия MODX 1.0.10. Установка системы MODX Revolution в данной статье не рассматривается.
В первую очередь необходимо загрузить дистрибутив системы с официального сайта MODX: modx.com. Если вы возьмете дистрибутив с любого другого сайта, то рискуете получить систему с неизвестными и потенциально опасными исправлениями. В отличие от предыдущих версий, обязательных исправлений в дистрибутив для корректной работы с русским языком вносить не надо, однако рекомендуется познакомиться с советами по доработке MODX. Если вы устанавливаете MODX для ознакомления, можете взять оригинальный дистрибутив, но если вы планируете использовать систему на создаваемых сайтах, лучше подготовить собственный дистрибутив, исправив некоторые элементы под свои требования. О полезных исправлениях можно узнать, обратившись на форум MODx.
Перед установкой системы можно внести незначительные исправления в некоторые файлы дистрибутива. В папке manager/includes следует создать пустой файл, назвав его config.inc.php. При некоторых настройках хостинга он будет необходим, а хуже от его присутствия не будет, конечно, если вы устанавливаете систему, а не обновляете ее старую версию. Кроме того можно переименовать в корневой папке файл ht.access в .htaccess, а файл sample-robots.txt в robots.txt, после чего рекомендуется просмотреть файлы и внести в них необходимые исправления. Сохраните исправленный дистрибутив, после чего можно приступать к установке системы.
Определенные сложности возникают при установке MODX на хостинге под управлением системы ISPManager, так как папка, где расположена панель управления системы, называется так же, как и папка с файлами административной части MODX. Некоторые правят дистрибутив MODX, изменяя manager на что-то другое, некоторые пытаются изменить название папки в ISPManager, но для решения проблемы ничего такого делать не требуется. В настройках ISPManager для конкретного домена следует установить флажок Отключить ISPManager, а если такой флажок отсутствует или отключение запрещено, на хостинге в конфигурационный файл веб-сервера httpd.conf в секцию VirtualHost для конкретного сайта надо добавить одну строку:
Alias /manager/ /реальный_путь_к_папке_сайта/manager/
После этого при вводе http://my_site.ru/manager/ будет запускаться административная часть MODX, а при вводе https://my_site.ru/manager/ будет запускаться панель ISPManager. Следует отметить, что на других клиентов виртуального хостинга данное изменение никак не повлияет, добавить единственную строку очень просто, и следует добиваться этого от хостера. При использовании других панелей управления хостингом проблем не возникает. Однако если вы планируете пользоваться бесплатным хостингом, его настройки могут не соответствовать требованиям MODX, и менять их не будут, так что не рекомендуется работать с любыми бесплатными хостингами.
Непосредственно перед установкой
В процессе установки системы MODX база данных может быть создана автоматически, но рекомендуется заранее создать и настроить нужную базу данных. Для этого можно воспользоваться панелью управления хостингом или популярной программой phpMyAdmin. После того, как база создана, необходимо правильно настроить ее, чтобы при работе с MODX не возникали проблемы с кодировкой. Настоятельно рекомендуется использовать кодировку UTF-8, если нет веских причин отказаться от ее применения. Выберите для созданной базы данных кодировку utf8 и сравнение utf8_general_ci или utf8_unicode_ci. Это можно сделать с помощью средств phpMyAdmin или выполнив команду ALTER DATABASE `имя_базы_данных` DEFAULT CHARACTER SET utf8 COLLATE utf8_ general _ci, где вместо имя_базы_данных вводится соответствующее имя. Убедившись, что кодировка и сравнение установлены правильно, запомните или запишите имя пользователя и пароль доступа к базе данных – они потребуются при установке. Также необходимо знать адрес хоста базы данных – чаще всего это localhost, но может быть и другой, в зависимости от особенностей хостинга.
После этого требуется скопировать в нужную папку дистрибутив системы. При установке на хостинг следует использовать любую программу, поддерживающую работу с FTP. В большинстве случаев файлы после закачки будут защищены от изменений, и перед установкой потребуется установить иные права доступа к некоторым файлам и папкам. Требуется разрешить полный доступ к следующим папкам (установить права 777): assets/cache, assets/images, assets/export, assets/files, assets/flash и assets/media . Также требуется разрешить изменение следующих файлов (установить права 666): assets/cache/siteCache.idx.php, assets/cache/sitePublishing.idx.php, manager/includes/config.inc.php. Изменить права можно с помощью панели управления хостингом или используя программу работы с FTP.
Процедура установки MODX 1.0.10
Введите в браузере адрес сайта, на который планируется установить MODX. В рамке на красном фоне вы увидите сообщение MODX is not currently installed or the configuration file cannot be found. При отсутствии этого сообщения следует проверить правильность размещения на сервере закачанных файлов дистрибутива. Для начала установки следует щелкнуть мышью на ссылке install now.
На экране появится первая страница мастера установки. Выберите в списке Choose language значение Russian и нажмите кнопку Next, чтобы дальше все общение велось на русском языке. Следует отметить, что при этом будет использоваться кодировка UTF-8 и если ваш сервер неправильно с ней работает, вы не сможете установить систему. В таком случае можете выбрать английский язык – English. На появившейся странице выберите вариант Новая установка и нажмите кнопку Далее, чтобы приступить к настройке особенностей установки. Следует отметить, что обновление системы может вызвать ряд затруднений, и к нему следует приступать только после того, как вы успешно освоите новую установку.
Заполните верхние три поля, введя сведения о базе данных и пользователе базы, после чего щелкните мышью на расположенной ниже ссылке. Если сведения верны и база доступна, появится сообщение об успешном завершении проверки и появятся поля для ввода очередных данных. Если этого не произошло, значит, какие-то настройки хостинга мешают провести проверку. Если вы не используете бесплатный хостинг и не работаете с ISPManager без описанных выше исправлений, ошибок быть не должно, и при возникновении проблем следует обратиться за помощью на форум MODX.
В случае успешной проверки базы необходимо ввести в следующее поле имя базы данных, созданной и настроенной ранее, а также задать префикс таблиц. Выбрав метод сопоставления SET CHARACTER SET и сопоставление utf8_ general_ci, щелкните мышью на ссылке, расположенной ниже. При возникновении ошибки можно попробовать метод SET NAMES, который также рекомендуется использовать при проблемах с кодировкой на конкретном хостинге. При успешной проверке появится следующая группа полей. Далее вводится идентификатор и пароль администратора сайта, адрес его электронной почты. Эти сведения потребуются для доступа в административную часть сайта. Также выбирается язык работы административной части сайта – рекомендуется выбрать Russian-UTF8. Нажмите кнопку Далее, чтобы перейти к следующей странице.
В большинстве случаев лучше не менять настройки, предлагаемые по умолчанию, по крайней мере, при первой установке системы. Правда есть единственное исключение – рекомендуется убрать флажок «Установить/Обновить mm_demo_rules», чтобы не устанавливать чанк, используемые в демонстрационном сайте, и нарушающий работу обычного сайта. Также можно убрать флажки «Установить/Обновить MODxHost» и «Установить/Обновить WebLoginSidebar» и флажки в группе установки параметров (TV). Вам предлагается установить все предлагаемые чанки, модули, сниппеты и плагины, но не устанавливать тестовый сайт. Для запуска процесса установки следует нажать кнопку Установить. Будет выполнен ряд проверок, в результате которых должны выводиться сообщения OK. Если какие-то проверки закончились неудачно, требуется устранить проблему и повторить данный шаг. Установив флажок, подтверждающий, что вы согласны с условиями лицензии, следует нажать кнопку Установить, чтобы приступить к установке системы. В описании установки все сообщения должны заканчиваться словами OK или Установлен, а в нижней части страницы должно появиться сообщение Установка успешно завершена!. Нажав кнопку Закрыть, вы перейдете на страницу входа в административную часть сайта, но пока не следует вводить свой идентификатор и пароль.
Не закрывая окно браузера, выполните ряд действий с файлами, расположенными на хостинге. Следует удалить папку install, если она не была удалена автоматически. Также запретите редактирование файла manager/includes/config.inc.php. Для этого при работе в UNIX-подобных системах назначьте файлу права доступа 644, а при работе с Windows установите атрибут Только чтение. Теперь вы готовы к работе с системой MODX.
Первый запуск системы и вход в административную часть
Если при установке не возникло проблем, административная часть сайта будет использовать русский язык и кодировку UTF-8. Если приглашение входа содержит нечитаемые символы, значит, установка была выполнена неверно. Скорее всего, хостинг неверно работает с кодировкой UTF-8, но это встречается крайне редко. В большинстве случаев вы увидите нормальный текст на русском языке.
Необходимо отметить, что в MODX, начиная с версии 0.9.6.2, в административной части выводятся новости и сообщения безопасности, загружаемые из интернета. Если имеются проблемы доступа с хостинга к каким-то сайтам интернета, возможно возникновение ошибки. Если в дальнейшем вы увидите сообщение, начинающееся на Fatal error: Maximum execution time, системе не удалось связаться с нужным сайтом за отведенное время.
Введя идентификатор и пароль администратора, нажмите кнопку Войти. Если после входа в систему вы увидите на вкладке Конфигурация сообщение Конфигурация содержит ошибки, требуется устранить проблемы перед продолжением работы. При отсутствии ошибок данная вкладка не выводится в административной части. Чтобы быть уверенным, что никаких проблем с русским языком не возникнет, попробуйте изменить название имеющейся единственной страницы сайта на русское, а также добавьте в содержимое этой страницы несколько русских слов, после чего убедитесь, что название не испортилось после сохранения. Выйдите из административной части сайта и перейдите на главную страницу сайта, не забыв обновить страницу в браузере. Если и тут русские буквы отображаются правильно, можно считать, что установка завершена, и вы можете приступать к повседневной работе с MODX версии 1.0.10.
В случае, если у вас возникли проблемы при установке или эксплуатации системы MODX, вы можете обратиться за помощью на форум MODx, где всегда можно найти нужных специалистов. Хотя имеется несколько русскоязычных сайтов, посвященных MODX, форум на официальном сайте системы является лучшим местом для получения квалифицированных консультаций.
