Изменения в шаблонах

В будущей MaxSite CMS 0.32 решил сделать еще большую кастомизацию шаблонов. Начальные идеи я описал на форуме, а здесь остановлюсь на основных моментах.

Итак, у нас есть некая базовая концепция организации шаблонов: html-каркас хранится отдельно, а программная часть в каталоге type дефолтного (default) шаблона. Пример: шаблон «Clouds». Этим удалось значительно снизить зататы на создание шаблонов, то есть дизайнеру нет необходимости заниматься программированием и поддержкой обновлений - все автоматом обновится вместе с системой.

Однако, такой подход имеет и ограничения. Прежде всего речь идет о том, что в type-файлах жестко задан порядок вывода информации: заголовок, дата, потом рубрики и т.д. А что делать, если по дизайну нужно вывести рубрику после текста, а дату вообще убрать? Единственный способ был - скопировать нужный type-файл в свой шаблон и там его уже править.

Само по себе это не очень сложно, но тут у нас может возникнуть проблема с обновлением. Например в будущей версии MaxSite CMS я что-то изменю в дефолтном шаблоне: скажем, добавлю новую полезную функцию. Таким образом вебмастеру придется искать все изменения и опять обновлять свои type-файлы.

Всё это не совсем удобно, поэтому я решил реализовать механизм, который позволяет использовать type-файлы «частично»: подключается type-файл дефолтный, а для организации самого цикла вывода - свой кастомный «type_foreach»-файл.

На практике это выглядит так. В type-файлах заданы идентификаторы цикла. Если вы используете свои type-файлы, то сможете придумать свои варианты, а для шаблона default они такие:

• archive
• author
• category
• comments
• home-cat-block-last-page
• home-cat-block
• home-top
• home
• page-comment-form
• page-comments
• page
• search
• tag
• users-all

Несложно догадаться какой для чего используется. Дальше так. В шаблоне default я заранее приготовил каталог «type_foreach», в нем файлы с префиксом «_». Вебмастеру достаточно скопировать этот каталог в свой шаблон и убрать из имени префикс для нужных файлов. Теперь система автоматом их подхватит и будет использовать в цикле вывода. Если вы посмотрите эти файлы, то увидите, что они очень небольшие и содержат только «дизайнерскую» часть вывода. Таким образом мы сохранили type-файлы и смогли кастомизировать сам вывод.

Специальное замечание: все старые шаблоны будут работать без изменений, как и работали и ничего в них менять не придется. У вас также осталась возможность, как и прежде использовать свои type-файлы. Файлы «type_foreach» просто еще одна возможность MaxSite CMS, облегчающая жизнь вебмастеру.

Данное изменение я решл анонсировать заранее, пока оно доступно только в latest-версии 0.326.

Но это еще не всё. :)

При разработке плагина гостевой книги, я столкнулся с небольшой проблемой подключения своей страницы для шаблона непосредственно из плагина. У нас есть type-файлы, которые подключаются в шаблонном index.php. В нем происходит анализ с помощью is_type() или mso_segment(). Это типовой подход.

Теперь мне нужно вывести свою страницу в шаблоне по какому-то произвольному slug. Короткая ссылка задается в админ-панели и проверять её в шаблоне не учень удобно: если шаблонов много, то для интеграции придется менять их все.

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

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

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

Для этого мы просто-напросто перед подключением «page_404» проверяем хук «custom_page_404». Если такого хука нет или он возвращает false, то подключаем как обычно 404-страницу. Иначе то, что задаст разработчик плагина.

Приведу полное описание здесь.

В index.php своего шаблона нужно изменить строчку:

else require($type_dir . 'page_404.php');

на

else
{
	if ( !mso_hook_present('custom_page_404') or !mso_hook('custom_page_404')) 
		require($type_dir . 'page_404.php');
}

Теперь в плагине цепляемся (в _autoload) на хук «custom_page_404»:

mso_hook_add('custom_page_404', 'myplugin_custom_page_404');

И создаем функцию myplugin_custom_page_404():

function myplugin_custom_page_404($args = false)
{
	if ( mso_segment(1)=='myslug' ) 
	{
		// подключили свой файл вывода
		require( getinfo('plugins_dir') . 'myplugin/mytype.php' ); 
		return true; // выходим с true
	}

	return $args;
}

Теперь, если у нас будет адрес http://сайт/myslug, то будет подключен файл mytype.php, который находится в каталоге плагина!

Продключить оформление шаблона в mytype.php элементарно:

<?php if (!defined('BASEPATH')) exit('No direct script access allowed'); 
 
// meta title страницы
mso_head_meta('title', t('Мой плагин', 'plugins/myplugins') ); 
 
# начальная часть шаблона
require(getinfo('template_dir') . 'main-start.php');
 
echo 'Мой плагин';
 
# конечная часть шаблона
require(getinfo('template_dir') . 'main-end.php');	
?>

Я даже сам удивлен, что столь простое решение не пришло мне в голову раньше, настолько оно очевидное. Скажем ту же контактную форму проще «прицепить» в виде плагина и не «таскать» из шаблона в шаблон. :)