Используем типы страниц в MaxSite CMS

Часто типы страниц путают с типом данных. Стандартно в MaxSite CMS тип данных определяется по URL. Например для рубрик используется префикс category (http://сайт/category/XXX), для меток - tag (http://сайт/tag/XXX), для страниц - page (http://сайт/page/XXX) и т.п.

Тип страниц же задаётся в админ-панели. Изначально присутствует два типа blog и static, но без проблем можно добавить другие типы. Страницы типа blog предназначены для вывода на главной странице и в лентах записей, например рубрики, метки и т.п. Тип static предназначен для тех записей, которые не должны быть выведены в таких лентах. Обычно это некая фиксированная «статичная» страница, например «О себе», «Контакты» и т.п. Доступ к таким страницам осуществляется по прямой ссылке, которые как правило размещают в меню или сайдбаре.

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

Предположим мы хотим на сайте организовать какой-то отдельный тематический раздел (например book). В этом разделе записи будут выводиться обычной лентой (как в рубриках), только в алфавитном порядке.

Для начала сделаем в админ-панели новый тип book. Настройки основные - Типы страниц:

Обратите внимание, что удалить тип страниц нельзя.

Теперь при создании или редактировании записей можно будет выбрать тип book.

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

Далее в настройках виджета указываем тип страниц.

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

Теперь давайте разберёмся как выводить book-записи на отдельной странице. Для этого есть несколько вариантов. Мы остановимся на создании отдельного типа данных - book. То есть наши записи будут выводиться по адресу http://сайт/book. Адрес может быть произвольным - он никак не связан с типом страниц.

Поскольку записи будут выводиться как в рубриках, то скопируем файл type/category.php из default-шаблона в type-каталог своего шаблона. Переименуем файл в book.php. MaxSite CMS автоматически сопоставит book в адресе с файлом book.php.

Если перейти на http://сайт/book, то увидим 404-страницу. Это происходит из-за того, что в файле получается тип данных book - тип данных, который не определен по-умолчанию в системе и для него неизвестен алгоритм получения страниц. Исправляется это очень просто. Открываем файл и находим строчку

...
// параметры для получения страниц
$par = array( ...

Это массив, в котором следует указать нужные нам параметры.

Добавляем ключи:

...
'custom_type' => 'home', 
'type' => 'book',
'order' => 'page_title',
'order_asc' => 'asc',
...

Первый ключ указывает алгоритм, по которому формируются SQL-запросы. У нас обычный вариант, как на главной, поэтому ставим home. Второй - указывает на тип страниц.

Поскольку мы хотим выводить записи по алфавиту, то задаём order (поле сортировки) и order_asc (порядок).

Обновляем страницу и видим, что book-записи прекрасно выводятся.

Правда, поскольку у нас исходный файл от вывода рубрик, то в «наследство» мы получили и некоторые блоки от рубрик. Нет особой сложности в том, чтобы удалить блок «category_show_rss_text». В блоке «category-show-desc» можно вывести какое-то своё описание book-записей. Также нужно будет добавить в mso_head_meta() свои значения для title.

С точки зрения MaxSite CMS между типами страниц нет никакой принципиальной разницы. Всё дело только в том, как организовать их получение и вывод записей. Самый простой - связать по адресу. Получение же страниц - стандартная функция mso_get_pages(), которая присутствует во всех типах данных.

Спасибо за идею статьи Александру Шиллингу! Вы также можете предложить свой вариант.