Для установки дополнения Articles необходим MODx Revolution версии 2.2. В данный момент вышел только второй релиз-кандидат в MODx Revolution, который я, к сожалению, так и не смог корректно поставить на виртуальный линукс-хостинг, поэтому пока отрабатываю всё локально. Статья, является переводом части Руководства MODx Revolution, изображения тоже оттуда.

Будем считать, что вы установили MODx Revolution 2.2, дополнение Articles (которое вместе с собой автоматически устанавливает getPage, tagLister, Archivist и др.) Теперь можно приступать к созданию блога… 

Создание блога

Создать блог просто – нажмите правой кнопкой мыши на любом документе в дереве ресурсов слева в менеджере и выберите опцию “Create”. Нажмите “Create Articles Here”:

 Создание блога в MODx Revolution

Появится окно создания контейнера Articles Container, который и является по сути блогом, который может содержать любое количество статей (записей блога), что вам и нужно.

Первая закладка Articles

Итак вы видите новое окно редактора, как показано на снимке: Вкладка ArticlesВы можете устанавливать следующие поля на первой вкладке:

  • Container** **Title – название заголовка вашего контейнера или вашего блога.
  • Container** **Alias – это наш ЧПУ (псевдоним) контейнера. Если у данный контейнер находится в корне сайта и установлен псевдоним как “blog”, то адрес блога будет отображаться как www.mysite.com/blog/
  • Description – короткое описание вашего блога.
  • Menu** **Title – заголовок вашего блога, показываемый как пункт меню. По-умолчанию, если вы ничего не указали, то он будет равен названию страницы - pagetitle.
  • Link** **Attributes - любые HTML атрибуты ссылки для показа в ссылке меню, когда блог отображается в меню.
  • Hide** from **Menus – если выставлена галочка, то ваш блог не будет показан в любом меню вашего сайта.
  • Published – когда проставленно, ваш блог будет опубликован.

Давайте продолжим и дадим вашему контейнеру статей название “My Blog” и псевдоним “blog”. После этого жмите вкладку “Template”.

Вкладка Template

Вкладка Template состоит из параметров шаблонизации вашего блога, таких как: выбор используемого шаблона и другие функции вывода.Вкладка Template

Поля данной вкладки:

  • Uses** **Template – Шаблон для вашего блога. Дополнение Articles обеспечивает простой шаблон, но вы можете его сменить на свой.
  • Content – контент блога – здесь вы можете поменять как поле [[*content]] будет рендерится в вашем шаблоне контейнера статей.
  • Article** **Template – шаблон по-умолчанию для ваших статей (может быть для каждой статьи переназначен).
  • Article** Row **Chunk – чанк вывода постов на фронтальной странице или страницах архива. По-умолчанию дополнение Articles обеспечивает свой чанк.
  • Articles** Per **Page – количество отображаемых записей блога, 10 по-умолчанию.

Теперь, вы можете установить поле “Template” в “sample.ArticlesContainerTemplate” или в “sample.ArticleTemplate”.

Если вы хотите поменять содержимое этих шаблонов, очень рекомендуется, чтобы вы вначале сделали копию и переименовали их. Любые изменения в шаблонах-образцах будут перезаписаны, после каждого обновления дополнения Articles.

Обратите внимание на поле  “Content”. В данный момент оно выглядит так:

[[+articles]] [[+paging]] Вы можете поменять его для реструктуризации размещения и разметки записей блога как в зависимости от пагинации (разбиения на страницы). Вы можете также вставлять здесь HTML разметку и теги MODX.

Давайте продолжим и нажмём на вкладку “Advanced Settings”.

Вкладка Advanced Settings

Здесь несколько полей в отдельных вертикальных вкладках:Вкладка настроек Advanced settings 

  • Опции архивов

  • Archive Listing Chunk – чанк для каждого выводимого месяца/года.

  • Archive Listings to Show – количество отображаемых месяц/годов.

  • Archive By Month – архивировать или нет помесячно или погодово. Yes – архивировать помесячно.

  • Archive** CSS **Class - CSS класс, применяемый к выводу каждого архива.

  • Archive Alternate CSS Class -  CSS класс, применяемый к каждому парному ряду архива.

  • Опции тегов

  • Tag Listing Chunk – чанк для вывода тегов на страницах вывода.

  • Tag Listings to Show – количество тегов для вывода популярных тегов.

  • Tag CSS Class - CSS класс списка тегов.

  • Tag Alternate CSS Class - CSS класс парного ряда в списке тегов.

  • RSS опции

  • RSS Alias (Permalink) – псевдоним (постоянная ссылка) для фида RSS, прикрепляемого к ссылке на блог. Может быть списком, разделённым запятыми. Например, если вы установите его в “rssfeed.rss”, то ссылка вашего блога mysite.com/blog/rssfeed.rss покажет RSS фид.

  • Number of RSS Items – количество последних выводимых RSS объектов в RSS ленте.

  • RSS Feed Chunk – чанк для шаблонизации RSS ленты.

  • RSS Item Chunk – чанк каждого объекта в RSS ленте.

Для более подробной информации по настройкам комментированиия смотрите документацию Quip.

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

Выводы.

Теперь нажмите “Save” и у вас появился работающий блог! Теперь вы можете нажать “View” для просмотра вашего блога. Ниже вы увидите таблицу, в которой можете редактировать и создавать новые статьи блога.