MaxSite CMS для чайников. Шаблонная практика

Давайте сегодня закрепим полученные знания и немного поэкспериментируем. За основу возьмем Clouds. Создадим новый каталог в шаблонах «clouds-my» и скопируем в него все файлы из «clouds». В нашем каталоге в файле info.php сразу поправьте название шаблона (ключ «name»). Переключите в админ-панели шаблон. Все дальнейшие действия будем делать в «clouds-my».

Начнем с новых типов данных. На нашем форуме недавно был вопрос о том, как сделать отображение личных записей. Как известно в MaxSite CMS у любой записи могут быть т.н. статусы: черновик (draft), опубликовано (publish) и личное (private). Предположим все личные записи должны отображаться в виде отдельного адреса и быть видны только автору.

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

Сделаем свой type-файл

Пусть наши личные записи отображаются по адресу: http://сайт/private, а для отображения конкретной записи в конце указываем её номер: http://сайт/private/номер.

Если вы усвоили предыдущий материал, то знаете, что нам нужно сделать каталог «type» и в него поместить файл private.php. Для начала нам достаточно небольшого каркаса:

<?php if (!defined('BASEPATH')) exit('No direct script access allowed'); 
  
mso_cur_dir_lang('templates');
  
$pages = mso_get_pages(array(), $pagination);
  
if (!$pages and mso_get_option('page_404_http_not_found', 'templates', 1) ) header('HTTP/1.0 404 Not Found'); 
  
require(getinfo('template_dir') . 'main-start.php');
  
echo NR . '<div class="type type_private">' . NR;
  
if ($pages)
{ 	
	foreach ($pages as $page) : 
  
		extract($page);
  
		echo NR . '<div class="page_only">' . NR;
	  
		mso_page_title($page_slug, $page_title, '<h1>', '</h1>', true);
  
		echo '<div class="info">';
			mso_page_date($page_date_publish, 
				array(	'format' => 'D, j F Y г.', // 'd/m/Y H:i:s'
						'days' => t('Понедельник Вторник Среда Четверг Пятница Суббота Воскресенье'),
						'month' => t('января февраля марта апреля мая июня июля августа сентября октября ноября декабря')), 
						'<span>', '</span><br>');
			mso_page_edit_link($page_id, 'Edit page', ' [', ']');
		echo '</div>';
		  
		echo '<div class="page_content type_home">';
			mso_page_content($page_content);
			mso_page_content_end();
		echo '<div class="break"></div>';
			
		echo '</div>';
		echo NR . '</div><!--div class="page_only"-->' . NR;
		
	endforeach;
	
	mso_hook('pagination', $pagination);
}
else 
{
	echo '<h1>' . t('404. Ничего не найдено...') . '</h1>';
	echo '<p>' . t('Извините, ничего не найдено') . '</p>';
	echo mso_hook('page_404');
}
  
echo NR . '</div><!-- class="type type_private" -->' . NR;
  
require(getinfo('template_dir') . 'main-end.php');
?>

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

Первый запуск

Если набрать в браузере http://сайт/private мы должны увидеть сообщение, что ничего не найдено. Действительно, ведь мы используем дефолтные параметры для mso_get_pages(), которые не подходят под нашу задачу.

Статус записи

Статус записи в mso_get_pages() задается параметром page_status. Меняем:

$pages = mso_get_pages(
	array(
		'page_status' => 'private',
	), $pagination);

Сохраняем, обновляем в браузере и опять получаем 404-страницу. А всё дело в том, что функция mso_get_pages() не в курсе какой у нас тип данных. Точнее она использует тот, который определен системой, в нашем случае это page_404. Чтобы в этом убедиться перед mso_get_pages() выполним:

pr(getinfo('type'));

Функция mso_get_pages() использует текущий тип данных для генерации запросов к БД. Для обычной записи - это один вариант, для рубрик - другой и т.д. Стандартно существуют такие варианты:

• home - главная/лента записей
• page - одиночная страница
• category - записи рубрики
• tag - метки/мета
• archive - архив по дате
• search - поиск
• author - страница автора

Каждый из этих вариантов по разному интерпретирует входящие параметры. Например второй сегмент в «page» указывает на короткую ссылку записи. Для «home» вообще не учитываются сегменты. Ну и понятно, что для типа «page_404» возращается пустой массив.

Таким образом нам нужно определить по какому варианту мы будем выводить наши личные записи. Очевидно, что лучше всего нам подходит «home». Для явного указания типа данных в mso_get_pages() используется параметр «custom_type». Проверим.

$pages = mso_get_pages(
	array(
		'page_status' => 'private',
		'custom_type' => 'home',
	), $pagination);

Обновляем страницу и вуаля!, все заработало.

Ссылки на страницы

Обратите внимание на то, как формируются ссылки на одиночные страницы - с «page». Вы уже поняли, что за вывод ссылок отвечает функция mso_page_title() и, похоже, именно в ней зарыт нужный нам ключик.

Обратитесь к предыдущему материалу, чтобы посмотреть как объявлена эта функция. Мы видим, что есть параметр $type. Давайте укажем его как «private» (по-умолчанию он «page»). Меняем в коде:

mso_page_title($page_slug, $page_title, '<h1>', '</h1>', true, true, 'private');

Обновляем в браузере и сразу получаем нужные нам адреса.

Однако у нас может быть еще одна проблема если вы, как автор, будете использовать разбивку страниц с помощью cut. В таких ссылках на «далее» всё-равно окажется «page». Чтобы исправить это недоразумение укажем в mso_get_pages() параметр «link_page_type» равным «private».

Только авторам

Теперь нам нужно сделать так, чтобы записи отображались исключительно их авторам. Для этого в mso_get_pages() служит параметр «page_id_autor». В нем нужно указать номер автора. Очевидно, что автор должен вначале залогиниться на сайте, с тем, чтобы мы могли узнать его id.

В MaxSite CMS можно узнать номер залогиненного юзера (не комюзера!) так

getinfo('users_id')

Если же залогиненн кто-то другой, то функция вернет пустую строку. То есть наша задача состоит в том, чтобы передать в mso_get_pages() номер юзера, а если номера нет, то выводить 404-страницу. Меняем:

if ($users_id = getinfo('users_id'))
{
	$pages = mso_get_pages(
		array(
			'page_status' => 'private',
			'link_page_type' => 'private',
			'custom_type' => 'home',
			'page_id_autor' => $users_id,
		), $pagination);
}
else $pages = false;

Здесь мы получаем номер юзера в $users_id и сразу же проверяем условие, чтобы у него было какое-то значение. Если условие выполнено, то получаем записи, где указываем номер юзера. Если условие не выполнено, то ставим $pages = false, что равносильно 404-странице.

Вывод одиночной страницы

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

• Смотрим наличие второго сегмента.
• Если его нет, то выводим как сейчас список страниц.
• Если есть, задаем вывод указанной страницы.

Для получения произвольного сегмента используется функция mso_segment(). Для генерации одиночной страницы мы указываем custom_type = page. Для того, чтобы убрать деление страниц на «далее» указываем cut равным false. Ну и соответственно подставляем разные опции для mso_get_pages().

if ($users_id = getinfo('users_id'))
{
	if (mso_segment(2)) 
	{
		$par = array(
			'custom_type' => 'page',
			'page_id_autor' => $users_id,
			'cut' => false,
		);
	}
	else
	{
		$par = array(
			'page_status' => 'private',
			'link_page_type' => 'private',
			'custom_type' => 'home',
			'page_id_autor' => $users_id,
		);
	}
	
	$pages = mso_get_pages($par, $pagination);
}
else $pages = false;

Обратите внимание, что мы не передаём в mso_get_pages() (в варианте одиночной страницы) короткую ссылку (slug) по той причине, что эта функция, если явно не указывать slug, автоматически получает его из второго сегмента.

Пагинация

Если у нас много страниц, то внизу появится блок пагинации. Если попытаться перейти на следующую страницу, то мы получим 404-ошибку. Почему так происходит? Очень просто: для формирования списка страниц мы ориентируемся на второй сегмент. Но в случае пагинации, этот сегмент уже занят и равен «next». Таким образом в нашем случае мы фактически пытаемся получить страницу «next» и, не находя её, получаем 404-страницу.

Таким образом нам нужно просто исключить из условия анализа второго сегмента признак пагинации.

if (mso_segment(2) and mso_segment(2) != 'next') ...

Теперь наша пагинация работает как положено.

Ссылка в заголовке

На одиночной странице нам больше не нужна ссылка на заголовке. Можно, конечно оставить как есть, всё-равно эту страницу будет видеть только её автор, но, как-то это нехорошо. Тем более, что добавить одну строчку условия не составит для нас большого труда. Меняем:

if (mso_segment(2) and mso_segment(2) != 'next') 
	mso_page_title($page_slug, $page_title, '<h1>', '</h1>', false);
else
	mso_page_title($page_slug, $page_title, '<h1>', '</h1>', true, true, 'private');

То есть смотрим есть ли второй сегмент и если есть, то это одиночная страница и ссылку не выводим.

Заключение

Как видите, создание своих type-файлов довольно простая вещь. Вся пляска происходит вокруг mso_get_pages() с тем чтобы задать правильные условия для вывода.

Я намеренно не предлагаю скачать готовый файл private.php, чтобы вы самостоятельно проделали все операции и разобрались в них.