Меню

Настройка раздела в modx



MODX. Урок 2: Первичная настройка системы

Продолжаем знакомиться с MODX Revolution. На прошлом уроке мы поставили чистую систему и залогинились в админке. Чтобы подготовить проект к удобной разработке, нужно произвести ряд манипуляций в настройках системы. Это не панацея, а один из вариантов, любой из параметров вы сможете поменять на свое усмотрение.

Устраняем предупреждения

Начнем с устранения первых двух красных предупреждений на стартовом экране админки.

Первое предупреждение касается открытого каталога ядра. Это лечится следующим образом: идем в файловую структуру сайта, заходим в папку core и видим htxs-файл, который неправильно именован. Все, что нам нужно сделать – это правильно его переименовать. Ставим точку в начале, сохраняем, снова заходим в админку, обновляемся и видим, что первое предупреждение пропало.

Также рекомендую изменить htxs-файлы еще в двух местах: один лежит прямо в корне сайта (тоже неправильно именованный – меняем его, ставим точку в начале), и еще один htxs-файлик есть в папке manager – находим его и также переименовываем. Все это делается для обеспечения безопасности проекта.

Смотрим дальше – есть еще одно красное предупреждение, которое касается открытости файла для записи конфигурационного файла. Он находится в папочке core – config – и вот этот php-файл «config_inc php» нужно поставить доступным «только для чтения». На платформе Windows это делается элементарно: ставится галочка «только для чтения», а вот на боевом сервере вам уже придется изменить соответствующим образом права, поставить их доступными «только для чтения». После этого мы снова возвращаемся в админку, обновляемся и видим, что все предупреждения пропали.

Настраиваем правильное формирование URL

Следующее, что нужно сделать – настроить правильное формирование URL в системе.

Посмотрим, как MODX формирует URL для страниц изначально.

Если сейчас открыть главную страницу, то видно, что URL страницы формируется с помощью get-запроса. С точки зрения SEO это не очень хорошо. Чтобы это поправить, нам нужно сделать следующее:

Настройки –> системные настройки –> в фильтре по разделу выбираем пункт «дружественный url» –> опускаемся ниже –> и в последних пяти строчках, где написано «нет», ставим «да» (таким образом мы активируем систему дружественных url). Более подробно ознакомиться с каждым пунктом можно, нажав на плюсик и прочитав, что это означает. На данном этапе мы этого не будем делать, и просто поставим все значения «да».

Нужно изменить еще одно значение – это транслитерация всех псевдонимов – здесь, если развернуть, идет описание этого пункта. Для выбора русского языка поставьте Russian.

Для нормальной SEO-настройки рекомендую изменить суффикс контейнера «пустое значение», убрать его полностью.

Дальше идем в содержимое – типы содержимого – и напротив «html» указываем пустое значение. Таким образом мы добьемся правильного формирования URL-адресов.

Очищаем кэш системы, нажимаем – «перегенерировать все URL» и снова запускаем главную страничку сайта. Смотрим, что уже нет никакого index.php c параметром, а открывается просто домен. И так же теперь будут формироваться имена других страниц. Единственное, что еще нужно обязательно сделать, чтобы происходила транслитерация псевдонимов (то есть с русского переводилось на латинские буквы) – это установить один компонент в систему – «транслит». Идем в приложения, установщик – загрузить дополнение – и пишем: «транслит». Загружаем дополнение, возвращаемся в управление пакетами, и производим его непосредственную установку в систему. После того, как компонент установлен, он автоматом перехватит формирование URL и дальнейшее формирование страничек будет уже происходить с транслитерацией. Назовем, например, страницу – «Вторая страница», сохранимся, обновимся и после этого обратим внимание на поле «Псевдоним». Мы увидим, что он полностью транслитерировал данное название из заголовка. Теперь, если мы нажмем на «посмотреть», то увидим в адресной строке формирование URL, как раз состоящее из транслитерации.

Вот и всё, что касается первичной настройки системы. До новых встреч. Спасибо за внимание!

Источник

Урок 2. Первоначальная настройка MODX Revolution

Планируете ли вы создавать крупный информационный портал, сайт-организации, простейшую интернет-визитку, вам по окончании процесса установки MODX в любом случае потребуется произвести базовую настройку системы.

Настроек в этой системе управления огромное количество, меньше, чем звезд на небе, но достаточно, чтобы изначально несколько растеряться. Не будем бросаться в крайности. Рассмотрим только основные системные настройки, без упоминания которых теряется весь смысл самообучения…

Первое, что нужно сделать, это избавиться от ошибки настройки системы «Каталог ядра в открытом доступе», если такое сообщение появляется. Исправляем согласно инструкции сообщения, то есть переименовываем файл ht.access, расположенный в папке core, дав ему название .htaccess.

Сделать это можно либо через FTP-клиент, либо через файловый менеджер панели управления хостинга, либо с помощью файл-менеджера административной части MODX (вкладка «Файлы» в левой части окна).

Если вы переместили папку core за корневую директорию, установив MODX при помощи расширенного пакета, третий способ вам не поможет.

Обновив окно, убедитесь, что сообщение пропало.

Читайте также:  Debian установка настройка bind9

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

Системных настроек в Revo огромное количество

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

Значок «+» в левой части названия настройки откроет подсказку о том, для чего данный пункт предназначен. А в поле «Значение» меняются сами параметры каждой настройки. Их, в зависимости от типа настройки, вводят или вручную, или выбирают из списка.

Основные параметры системы, которые обычно редактируются непосредственно после установки MODX

Раздел «Сайт»

  • Название сайта: нужное нам наименование проекта, произвольная форма
  • Сообщение о недоступности сайта: текст, который будет отображаться в режиме отключенного (неопубликованного) сайта, произвольная форма
  • Публиковать по умолчанию: будет ли новый документ доступен для просмотра посетителями сразу после создания и сохранения, на ваш выбор, варианты Да/Нет

Раздел «Система и сервер»

  • Отображение RSS-канала «Новости MODX»: отключаем (Нет)
  • Отображение RSS-канала «Уведомления безопасности MODX»: отключаем (Нет)

Раздел «Панель управления»

  • Показывать текст подсказки рядом с полем: описание пунктов меню, полезно только при знакомстве с системой, в дальнейшем можно отключать, варианты Да/Нет
  • Формат даты в панели управления: можно сменить на наш, родной, d-m-Y
  • Первый день недели: ставим 1, мы же не Стругацкие

Раздел «Дружественные URL» – режим ЧПУ

  • Транслитерация псевдонимов: russian (для включения транслитерации дополнительно требуется установить дополнение translit)
  • Суффикс контейнера: Очищаем
  • Использовать дружественные URL: Да
  • Строгий режим дружественных URL: Да
  • Проверять на дублирование URI во всех контекстах: Да

Включив на сайте ЧПУ (режим дружественныу URL), переименуйте дополнительно ht.access в корне сайта в .htaccess, иначе при попытке перехода на страницы, отличные от главной, получите ошибку 404.

Подтверждение изменений или сохранение параметров не требуется, все происходит автоматически.

Можно дополнительно посетить раздел «Типы содержимого» (пункт меню «Содержимое») и очистить поле «Расширение файла» в параметре HTML. Теперь адрес страниц станет без расширения, то есть http://адрес_Сайта/about вместо http://адрес_Сайта/about.html.

На этом первоначальную настройку можно считать завершенной. Далее идет установка из репозиториев самых необходимых для плодотворной и удобной разработки дополнений MODX Revo.

Источник

Урок 3. Дерево документов и создание страниц

Дерево документов MODx располагается в левой части администраторской панели.

Страницы и категории в MODx называются ресурсами.

В самом верху дерева указано название сайта, которое задается на странице системной конфигурации. Напомним, что поменять название своего сайта Вы можете, проследовав по вкладкам Инструменты – Конфигурация – Сайт – Заголовок сайта.

По умолчанию у вас уже создан один документ с названием MODx CMS Install Success, который и служит главной страницей вашего сайта. В скобках указан ID ресурса, это целое число и оно уникальное для каждой страницы.

1. Нажмите на название этой страницы в дереве документов. Перед вами появится страница редактирования ресурса. Отредактируйте этот созданный по умолчанию ресурс в соответствии с рисунком ниже.

В принципе, тут все интуитивно понятно.

Вкладка общие

На этой вы заполняете основные атрибуты вашей страницы, а именно следующие поля:

«Заголовок» [ *pagetitle*] – вписываете название вашей страницы.

«Расширенный заголовок» [ *longtitle*] – в этом поле вы можете вписать расширенный заголовок вашей страницы. Можете это поле оставить пустым или скопировать сюда содержимое поля «Заголовок».

«Описание» [ *description*] – в это поле вы можете внести информацию, которую хотите разместить в мета теге Description для данной страницы.

«Псевдоним» [ *alias*] – здесь нужно вписать имя страницы (латинскими буквами), которое вы хотите видеть в URL. Если вы его оставите пустым, оно заполнится автоматически исходя из заголовка страницы, если настроен плагин TransAlias о котором мы упоминали в процессе установки CMS MODx. Если плагин вы не настроили, то пустое поле заменится на идентификатор ресурса.

«Аннотация» [ *introtext*] – поле с кратким описанием страницы, например первый абзац или что-нибудь в этом роде.

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

Читайте также:  Настройка nvidia with cuda

«Пункт меню» [ *menutitle*] – не обязательное поле, но вы можете его использовать, если ваш заголовок страницы очень длинный и его не удобно использовать в качестве пункта в меню. В этом случае в качестве названия пункта меню Вы можете использовать это поле.

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

«Показывать в меню» – убрав галочку с этого пункта, Вы запретите показ вашей страницы в меню.

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

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

Вкладка «Настройка страницы»

2. Здесь можно указать дополнительные параметры для создаваемой/редактируемой страницы. После чего сохраните страницу.

3. Для создания новой страницы, нажмите следующую пиктограмму, расположенную вверху дерева документов

4. В окне создания ресурса заполните необходимые поля и сохраните ресурс.

После сохранения ресурс появится в дереве ресурсов.

5. Создайте типичные страницы для сайтов-визиток и наполните демо-данными, аналогично рис. 3.5:

  • Главная
  • О нас
  • Услуги
  • Контактная информация
  • Новости

После создания ресурсов ваше дерево будет выглядеть как на рисунке ниже.

Чтобы в дереве ресурсов ресурсы расположились в определенной последовательности, в окне редактирования ресурса устанавливайте номер Позиция в меню в нужном порядке.

На рисунке 3.6 изображено дерево документов, в котором все страницы опубликованы и разрешены к показу в меню. Если в Вашем дереве документов название страницы будет черного цвета, это значит, что Вы в настройках указали Не показывать в меню. Если название страницы будет розового цвета и написано курсивом, это значит – Вы убрали галочку Публиковать на вкладке с настройками страницы и Ваша страница не будет видна посетителям сайта.

Создание динамического меню. Сниппет Wayfinder

Сниппет это PHP код, который мы можем вызывать из шаблона сайта. Результат работы сниппета вставляется в место вызова. Чтобы посмотреть список сниппетов, которые идут в комплекте MODx по умолчанию, проследуйте по вкладкам в администраторской панели: Элементы Управление элементами Сниппеты. Все они доступны для редактирования.

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

Вызов осуществляется по имени сниппета, помещенном между квадратными скобками с восклицательными знаками. Например, если имя определенного сниппета – Name, то вызов его будет осуществляться следующей конструкцией, помещенной в шаблон:

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

Для того, чтобы передать некоторые значения параметров используется конструкция:

Обратите внимание на вопросительный знак после имени сниппета, он говорит о том, что далее следуют объявление передаваемых параметров. Названию каждого передаваемого параметра предшествует знак &, а его значение заключено в обратные одинарные кавычки. Это те кавычки, которые на русской клавиатуре добавляются нажатием клавиши с буквой Ё. Не перепутайте, один неверный знак, и вы долго будете мучиться и разбираться, почему ничего не работает.

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

При кэшируемом вызове результат работы сниппета заносится в кэш, и при повторной загрузке страницы код сниппета не выполняется заново, а на место вызова сразу подставляется предыдущий результат, взятый из кэш.

Для организации динамических меню в MODx мы будем использовать встроенный сниппет Wayfinder.

Результатом работы Wayfinder является вывод ненумерованного списка, элементами которого будут ссылки на дочерние документы для той страницы, на которой мы вызываем этот сниппет. Для примера, если у нас структура документов такая, как изображена на рисунке ниже

то, если мы вызовем на главной странице сниппет

результатом его работы будет список из 4 ссылок на дочерние страницы. Список будет иметь вид:

Сниппет выводит список всех дочерних документов. Для вывода дочерних документов необходимо сниппету Wayfinder передать параметр startId, в который записываем ID того документа, ссылки на дочерние страницы которого мы будем выводить.

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

Читайте также:  Пошаговая настройка nanostation m2

Сейчас давайте посмотрим, что же представляет из себя главное меню сайта в нашем шаблоне. Если Вы помните меню с логотипом у нас хранится в одном чанке под названием HEADER. И что мы видим?

Меню представляет из себя обычный ненумерованный список, помещенный в контейнер с id=»topnav». Это значит, что HTML-разметка меню будет представлять из себя обычный список, а всю задачу по внешнему виду берет на себя CSS файл, который мы подключали ранее. Но мы с Вами уже в курсе, как можно этот ненумерованный список динамически вывести в MODx. Поэтому удаляем из чанка HEADER вот этот код (список)

6. А на его месте вызываем сниппет Wayfinder с передаваемым ему параметром startId=`0`.

Вызов сниппета должен находиться в контейнере с id=»topnav»

В результате мы получим главное меню с автоматическими сгенерированными ссылками и названиями пунктов. При этом названия пунктов взяты как названия пунктов меню, указанных на странице редактирования ресурсов, а URL ссылки определяется псевдонимом, указанным на странице редактирования ресурсов.

Если мы будем переходить между пунктами, мы сможем увидеть в адресной строке браузера, как меняются URL страниц. Внешний вид страниц, правда, остается неизменным, это потому что у нас пока нет изменяемой информации на странице.

Давайте посмотрим на исходный код получившегося главного меню:

Обратите внимание, что сниппет Wayfinder автоматически генерирует класс для активного пункта меню class=»active» и его название даже совпало с прописанным в нашем случае в CSS классом active. Поэтому при переходе по меню, активный пункт у нас подсвечивается зеленым цветом, так как и было изначально в шаблоне.

По умолчанию, для активного пункта меню Wayfinder всегда будет генерировать class=»active», поэтому, если в Вашем шаблоне он описывается другим классом, измените его в CSS файле. Если Вы внимательно посмотрите еще раз на исходный код сгенерированного списка, то вы увидите, что последний пункт меню по умолчанию обозначается классом last, это тоже имейте ввиду, так как часто для оформления последнего пункта меню требуется прописывать стили отдельно. В этом случае для его оформления можете воспользоваться классом last.

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

7. И так, чтобы меню не сползало под логотип нам нужно изменить длину одного или двух пунктов меню. В нашем случае лучше всего вместо названия пункта Главная страница напишите просто Главная. Это можно сделать, не изменяя название самого ресурса. Просто идем на страницу редактирования ресурса с именем Главная страница и в поле Пункт меню вписываем короткое название нашего пункта – Главная.

8. Сохраняем ресурс, обновляем страницу в браузере, название пункта изменилось, и меню уже не скатывается под логотип.

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

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

Что Вам чаще всего может пригодиться при работе с меню? Конечно же его сортировка. Допустим, Вам хочется чтобы пункты меню располагались в следующем порядке: Главная, О нас, Услуги, Новости и в конце Контактная информация. По умолчанию выставлена сортировка по параметру menuindex, который Вы устанавливаете при редактировании ресурсов в поле Позиция в меню.

9. Чем меньше цифра, тем раньше идет пункт в меню. Поэтому при редактировании ресурсов Вы можете установить для каждой страницы соответствующее значение позиции в меню. Чтобы отсортировать пункты в меню в последовательности, описанной выше, измените значения Позиция в меню: Главная – 0, О нас – 1, Услуги – 2, Новости – 3 и в конце Контактная информация – 4.

10. Обновите страницу. Как видите пункты Новости и Контактная информация поменялись местами.

11. Так же, часто может понадобиться убирать пункты меню из показа в меню. Например, пока у нас нет новостей, мы хотели бы этот пункт не показывать в меню. Не проблема, идем на страницу редактирования ресурса Новости и убираем галочку Показывать в меню.

12. Обновите страницу в браузере, после чего этот пункт не будет отображаться.

После этого в дереве документов название ресурса Новости будет черного цвета.

На этом, собственно, организация меню окончена. Мы научились выводить динамическое меню в MODx c помощью встроенного сниппета Wayfinder. При этом вы уже на практике попробовали отсортировать пункты меню и убирать из показа в меню выборочные пункты.

Источник

Adblock
detector