Первые шаги

Оглавление

• Устранение ошибок
• Создание первых страниц
• Первое изменение системных настроек MODx
• Создание первого шаблона и немного больше

После успешной установки MODx вы увидите страницу входа менеджера. Используйте логин и пароль, которые вы указали при установке и войдите в систему. Вы увидите приветствующее окно, что-то вроде этого:

#

Устранение ошибок

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

1. Для начала, в корневом каталоге переименуем файл ht.access в .htaccess
2. Далее удаляем файл /core/docs/changelog.txt. Дабы злоумышленнику не так просто было узнать на какой CMS работает наш сайт и тем более текущую версию CMS.

После этих двух шагов, сообщение об ошибках исчезнет, но это не все. Давайте попробуем перейти по ссылке http://example.com/core/docs/changelog.txt. Вы должны увидеть страницу с 404 ошибкой, но этого не происходит. Вместо 404 ошибки, вы скорее всего видите главную страницу вашего сайта. А происходит это, потому что при чистой установке MODx, ваш сайт имеет всего одну страницу и она же является страницей 403 и 404.

Давайте исправим этот момент, заодно научимся создавать ресурсы в MODx (они же страницы вашего сайта) и переустановим некоторые системные настройки вашего сайта.

#

Создание первых страниц

В MODx есть несколько способов создать новый ресурс (документ):

1. В главном меню сайта, в разделе «Содержимое» есть пункт меню «Новый документ», щелкнув на который, вы перейдете к созданию нового ресурса.
2. В левом блоке «Древовидное представление ресурсов» будет открыт первый раздел «Ресурсы» (если он не открыт, нажмите на панель Ресурсы, чтобы открыть его) в строке меню. Вы можете использовать иконку «Создать ресурс» (иконка со знаком «плюс» напротив веб-контекста «Website») или щелкнуть правой кнопкой мыши на значок веб-контекста «Website», выбрать «Создать», а затем «Документ».

Откроется окно «Новый ресурс». Вы увидите множество вкладок и полей. Для начала давайте зададим заголовок для нашего ресурса — «Страница не найдена». Обязательно установите флажок «Опубликован». Нажмите на плавающую кнопку Сохранить, чтобы сохранить новый документ.

И теперь, если вы посмотрите на дерево слева, вы увидите ваш новый документ в списке. Из новосозданного ресурса, нажмите кнопку «Просмотреть». Вы увидите нечто похожее:

У каждого ресурса должен быть свой контент. Давайте наполним нашу новую страницу 404 неким смыслом, в поле «Содержимое» внесем следующий текст:

Извините! Страница, которую Вы ищете, не может быть найдена.

По аналогии создадим ресурс «Доступ запрещен» и укажем контент:

Извините! У Вас нет доступа к этой странице.

#

Первое изменение системных настроек MODx

Теперь у нас есть два ресурса, которые можно назвать системными. И нам необходимо указать их в системных настройках MODx. Для этого в правом верхнем углу наводим мышку на шестеренку и выбираем пункт «Системные настройки». Далее делаем фильтр core -> Сайт и видим перечень системных настроек, которые относятся к выбранному нами фильтру.

Наша задача изменить значение для вывода ошибок 404 и 403. Для этого нужно найти настройки с ключами error_page и unauthorized_page и указать в значениях этих настроек идентификаторы страниц, которые вы создали ранее. Узнать идентификаторы страниц просто — в древовидном меню слева, напротив каждого ресурса указана цифра. Это и есть идентификатор ресурса. Указываем значение для настроек:

• error_page — 2
• unauthorized_page — 3

Теперь, если вы вновь попробуете обратиться по ссылке http://example.com/core/docs/changelog.txt, вы получите вывод страницы «Страница не найдена». Таким образом создаются ресурсы (страницы) сайта и редактируются системные настройки MODx.

При небольшом опыте работы с MODx, советуем вам менять только те системные настройки, в которых вы точно разобрались.

#

Создание первого шаблона и немного больше

Вы наверное уже заметили, что после установки MODx, страницы сайта уже имеют некий дизайн. Это стандартный дизайн MODx который используется в качестве примера. Разметка страниц обычно задается в «Шаблонах», давайте посмотрим на текущий шаблон. Нажмите на вкладку «Элементы» в древовидном меню слева. Это откроет набор элементов, которыми вы можете управлять, чтобы добавить динамический контент на страницы вашего сайта.

Создание шаблона практически идентично созданию ресурса, лишь за исключением того, что в главном меню нет пункта «Создать шаблон». Раскроем раздел «Шаблоны» и откроем шаблон с именем «Начальный шаблон». Если вы знакомы с HTML / CSS / JS, то для вас не составит труда разобраться в разметке текущего шаблона. Он во многом будет вам понятен, лишь некоторые его элементы могут вызывать у вас вопросы. Давайте удалим всю имеющуюся разметку и оставим только то что нам нужно, дабы разобраться с нюансами составления шаблонов в MODx.

Пропишем следующий код в «Начальный шаблон» и сохраним его:

<!doctype html>
<html lang="ru">
<head>
    <base href="[[!++site_url]]">
    <meta charset="[[++modx_charset]]">
    <meta name="viewport"
          content="width=device-width, user-scalable=no, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0">
    <meta http-equiv="X-UA-Compatible" content="ie=edge">
    <title>[[*pagetitle]] - [[++site_name]]</title>
</head>
<body>

[[*content]]

</body>
</html>

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

• [[*pagetitle]] — текущий заголовок страницы.
• [[++site_name]] — имя сайта, данную опцию можно найти в уже более менее знакомых вам системных настройках.
• [[!++site_url]] — базовая настройка, динамически создается на основе значения HTTP_HOST вашего сервера, а также некоторых других переменных.
• [[++modx_charset]] — Используемая кодировка символов, чаще всего UTF-8. Так же принимает значение из системной настройки.
• [[*content]] — этим плейсхолдером мы выводим весь контент, который задаем в ресурсе.

Наверняка вы заметили, что в плейсхолдере [[! ++site_url]] есть восклицательный знак. Это означает что мы вызываем данный плейсхолдер некэшируемым. Чтобы вызвать данный плейсхолдер кэшируемым, необходимо убрать восклицательный знак. Про плейсхолдеры и настройки вы сможете почитать на других страницах документации. Пока что давайте создадим новый шаблон со следующей разметкой:

<!doctype html>
<html lang="ru">
<head>
    <base href="[[!++site_url]]">
    <meta charset="[[++modx_charset]]"/>
    <meta name="viewport"
          content="width=device-width, user-scalable=no, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0">
    <meta http-equiv="X-UA-Compatible" content="ie=edge">
    <title>[[*pagetitle]] - [[++site_name]]</title>
</head>
<body>

Мой первый шаблон.

</body>
</html>

Создали и сохранили. Далее идем в наш ресурс под названием «Главная» и меняем у него шаблон с «Начальный шаблон» на новосозданный вами шаблон. Он должен быть уже в списке:

Выбрали и сохраняем ресурс. Если вы все сделали верно, то при просмотре главной страницы вашего сайта, вы должны видеть надпись:

Мой первый шаблон.

Эту надпись мы указали в разметке шаблона, вместо плейсхолдера [[*content]].

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