Особенности установки системы MODx версии 0.9.6.3
Версия MODx 0.9.6.3 не вызывает проблем при установке у опытных пользователей, однако у тех, кто ранее не работал с этой CMS, могут возникнуть определенные затруднения. Чтобы избежать проблем, необходимо следовать рекомендациям, изложенным ниже. Следует отметить, что особенности установки новой версии системы описаны в этой статье: установка MODx 1.0.2.
Подготовка к установке MODx
Вначале следует скачать дистрибутив системы с официального сайта MODx: modx.com. Скачивая дистрибутив с любого другого сайта, вы рискуете получить систему с неизвестными и потенциально опасными исправлениями. Далее рекомендуется изменить дистрибутив, чтобы лучше поддерживался русский язык в MODx 0.9.6.3, а также внести дополнительные исправления MODx 0.9.6.3. Даже если вы не собираетесь изменять дистрибутив, полезно прочитать о возможных проблемах, перейдя по соответствующим ссылкам.
Перед установкой системы можно внести дополнительные исправления в некоторые файлы дистрибутива. В папке manager/includes следует создать пустой файл, назвав его config.inc.php. При некоторых настройках хостинга он будет необходим, а хуже от его присутствия не будет. Кроме того можно переименовать в корневой папке файл ht.access в .htaccess, а файл sample-robots.txt в robots.txt, если вы уверены, что хотите использовать данные файлы без изменений. Сохраните исправленный дистрибутив, после чего можно приступать к установке системы.
Непосредственно перед установкой
В процессе установки системы MODx база данных может быть создана автоматически, но рекомендуется заранее создать и настроить нужную базу данных. Для этого можно воспользоваться панелью управления хостингом или популярной программой phpMyAdmin. После того, как база создана, необходимо правильно настроить ее, чтобы при работе с MODx не возникали проблемы с кодировкой. Настоятельно рекомендуется использовать кодировку UTF-8, если нет веских причин отказаться от ее применения. Выберите для созданной базы данных кодировку utf8 и сравнение utf8_unicode_ci или utf8_general_ci. Это можно сделать с помощью средств phpMyAdmin или выполнив команду ALTER DATABASE `имя_базы_данных` DEFAULT CHARACTER SET utf8 COLLATE utf8_unicode_ci, где вместо имя_базы_данных вводится соответствующее имя. Убедившись, что кодировка и сравнение установлены правильно, запомните или запишите имя пользователя и пароль доступа к базе данных – они потребуются при установке. Также необходимо знать адрес хоста базы данных – чаще всего это localhost.
После этого требуется скопировать в нужную папку дистрибутив системы. При установке на хостинг следует использовать любую программу, поддерживающую работу с FTP. В большинстве случаев файлы после закачки будут защищены от изменений, и перед установкой потребуется установить иные права доступа к некоторым файлам и папкам. Требуется разрешить полный доступ к следующим папкам (установить права 777): assets/cache, assets/images и assets/export. Также требуется разрешить изменение следующих файлов (установить права 666): assets/cache/siteCache.idx.php, assets/cache/sitePublishing.idx.php, manager/includes/config.inc.php. Изменить права можно с помощью панели управления хостингом или используя программу работы с FTP.
Процедура установки MODx 0.9.6.3
Введите в браузере адрес сайта, на который планируется установить MODx. В рамке на красном фоне вы увидите сообщение MODx is not currently installed or the configuration file cannot be found. При отсутствии этого сообщения следует проверить правильность размещения на сервере закачанных файлов дистрибутива. Для начала установки следует щелкнуть мышью на ссылке install now.На экране появится первая страница мастера установки. Выберите в списке Choose language значение russian и нажмите кнопку Next, чтобы дальше все общение велось на русском языке. Следует отметить, что при этом будет использоваться кодировка UTF-8. На появившейся странице нажмите кнопку Начать, чтобы перейти к следующему шагу. На экране появится краткое описание условий использования системы MODx. Вы можете прочитать полный текст лицензии, перейдя по соответствующей ссылке, а для продолжения установки следует установить флажок Я согласен с условиями лицензии и нажать кнопку Далее. На следующей странице выберите вариант Новая установка и нажмите кнопку Далее, чтобы приступить к настройке параметров установки.
Заполните верхние три поля, введя сведения о базе данных, после чего щелкните мышью на расположенной ниже ссылке. Если сведения верны и база доступна, появится сообщение об успешном завершении проверки. Введите в следующее поле имя базы данных, созданной и настроенной ранее, а также задайте префикс таблиц. Выбрав метод сопоставления SET CHARACTER SET и сопоставление utf8_unicode_ci, щелкните мышью на ссылке, расположенной ниже. При возникновении ошибки можно попробовать метод SET NAMES, который также рекомендуется использовать при проблемах с кодировкой на конкретном хостинге. Далее вводится идентификатор и пароль администратора сайта, адрес его электронной почты. Эти сведения потребуются для доступа в административную часть сайта. Нажмите кнопку Далее, чтобы перейти к следующей странице.
В большинстве случаев лучше не менять настройки, предлагаемые по умолчанию, по крайней мере, при первой установке системы. Вам предлагается установить все предлагаемые чанки, модули, сниппеты и плагины, но не устанавливать тестовый сайт. Для запуска процесса установки следует нажать кнопку Установить. Будет выполнен ряд проверок, в результате которых должны выводиться сообщения OK. Если какие-то проверки закончились неудачно, требуется устранить проблему и повторить данный шаг. Нажав кнопку Установить, вы приступите к установке системы. В описании установки все сообщения должны заканчиваться словами OK или Установлен, а в нижней части страницы должно появиться сообщение Установка успешно завершена!. Нажав кнопку Закрыть, вы перейдете на страницу входа в административную часть сайта, но пока не следует вводить свой идентификатор и пароль.
Не закрывая окно браузера, выполните ряд действий с файлами, расположенными на хостинге. Следует удалить папку install, если она не была удалена автоматически. Также запретите редактирование файла manager/includes/config.inc.php. Для этого при работе в UNIX-подобных системах назначьте файлу права доступа 644, а при работе с Windows установите атрибут Только чтение. Теперь вы готовы к работе с системой MODx.
Первый запуск системы и вход в административную часть
Если при установке не возникло проблем, административная часть сайта будет использовать русский язык и кодировку UTF-8. Если приглашение входа содержит нечитаемые символы, значит, установка была выполнена неверно. Скорее всего, вы не внесли необходимые исправления в дистрибутив MODx или хостинг неверно работает с кодировкой UTF-8, но это встречается крайне редко. В большинстве случаев вы увидите нормальный текст на русском языке.
Необходимо отметить, что в MODx, начиная с версии 0.9.6.2, в административной части выводятся новости и сообщения безопасности, загружаемые из интернета. Если имеются проблемы доступа с хостинга к каким-то сайтам интернета, возможно возникновение ошибки. Если в дальнейшем вы увидите сообщение, начинающееся на Fatal error: Maximum execution time, системе не удалось связаться с нужным сайтом за отведенное время.
Введя идентификатор и пароль администратора, нажмите кнопку Войти. Если после входа в систему вы увидите сообщение Конфигурация содержит ошибки, требуется устранить проблемы перед продолжением работы. Чтобы быть уверенным, что никаких проблем с русским языком не возникнет, попробуйте изменить название имеющейся единственной страницы сайта на русское, а также добавьте в содержимое этой страницы несколько русских слов, после чего убедитесь, что название не испортилось после сохранения. Выйдите из административной части сайта и перейдите на главную страницу сайта, не забыв обновить страницу в браузере. Если и тут русские буквы отображаются правильно, можно считать, что установка завершена, и вы можете приступать к повседневной работе с MODx версии 0.9.6.3.
В случае, если у вас возникли проблемы при установке или эксплуатации системы MODx, вы можете обратиться за помощью на форум MODx, где всегда можно найти нужных специалистов. Хотя имеется несколько русскоязычных сайтов, посвященных MODx, форум на официальном сайте системы является лучшим местом для получения квалифицированных консультаций.