Введение

По умолчанию, система шаблонов дает возможность работать с шаблонами page (общий шаблон сайта), node (шаблон документа), comment (шаблон комментария), block (шаблон блока) и box (шаблон общего контейнера). Эти шаблоны находятся в файлах page.tpl.php, node.tpl.php, comment.tpl.php, block.tpl.php и box.tpl.php, соответственно.

Суть в том, что система шаблонов уже сформировала для этих шаблонов все необходимые переменные, и нам остается только разместить с помощью операторов php значения этих переменных в нужных нам местах (внутри тегов html).

Пример: Кусок кода из page.tpl.php

Но часто требуется определить свою структуру отображения с помощью html не только для вышеприведенных структур, но и для более мелких блоков информации. К примеру, мы хотим переопределить отображение “хлебных крошек” (breadcrumbs) на что-то более подходящее нам по дизайну html-кода. Или переопределить вывод массива $links на более подходящий нам по структуре html-тегов. В итоге, нужно получить файл .tpl.php, в котором мы можем определить нужные нам html-теги, и заполнить их информацией из переменных php (аналогично page.tpl.php, node.tpl.php и т.д.). То есть, нам нужно отделить html-код от логики работы приложения (для тех структур данных, которым не предусмотрен “свой” файл .tpl.php).

Перекрытие функции

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

Теперь определимся с функцией, что формирует тот “кусок” html-кода, который мы хотим переопределить на свой. Возьмем, к примеру, функцию theme_breadcrumb(). Вот ее код (находится в файле /includes/theme.inc):

Можно, конечно, поправить код вывода прямо здесь, в файле theme.inc - но это будет, во-первых, вмешательством в код “ядра” Друпала - что повлечет за собой проблемы при последующих обновлениях (придется следить за каждым файлом ядра, в который вы внесли свои изменения). Во-вторых, это противоречит нашей задаче - получить конкретный файл .tpl.php в пределах нашей темы, который можно будет менять, как нам будет необходимо.

Здесь нам поможет система “ловушек” Друпала, суть которой в том, что она использует определенным образом имена функций в логике своей работы. Поясним сразу на примере. Если наша тема называется, к примеру, bluebox, то вышеприведенную функцию theme_breadcrumb() достаточно “перекрыть по имени” - назвать ее bluebox_breadcrumb().

Система шаблонов построена таким образом, что взаимодействует с системой ловушек, и перед окончательным формированием шаблона ищет функции, которые могут быть перекрыты создателем этой темы. “Сигналом” того, что данная функция перекрыта, и нужно использовать ее (функцию темы), а не функцию ядра (из theme.inc), служит как раз имя этой функции. Последняя часть имени должна соответствовать какому-либо из имен функций ядра, которые можно переопределять. Первая часть имени при перекрытии должна заменять слово theme и должна быть равна названию темы (к примеру, bluebox). В итоге, назвав нашу функцию bluebox_breadcrumb(), мы добьемся того, что система шаблонов будет использовать именно ее при построении html-кода окончательного вывода страницы.

Перекрытую функцию нужно внести в файл template.php. К примеру, наша функция bluebox_breadcrumb() будет выглядеть так:

Переменная $breadcrumb - это массив, в котором содержатся все ссылки, формирующие список “хлебных крошек”. Этот массив формируется ядром Друпала, и как именно происходит это формирование - тема для более глубокого исследования. Сейчас же просто используем этот массив для оформления его html-тегами.

В вышеприведенном коде мы поместили “хлебные крошки” в контейнер div, и заменили знак разделения ссылок на свой - “/”. В принципе, можно ограничиться и этим решением, но мы пойдем дальше. Ведь в итоге нам нужно получить файл .tpl.php, который будет не программой php, которая выдает html-код, а именно html-шаблоном, в котором будут “вкрапления” php. Все, что нужно будет нам в этом файле - переменная (набор переменных), содержимое которых мы используем для работы шаблона.

Шаблон .tpl.php

Первый шаг - изменение кода нашей перекрытой функции. Вместо генерации всего нужного html-кода с помощью php, мы просто “отдадим” информацию нашему html-шаблону - обеспечив четкое отделение php-кода от тегов html.

Суть метода - использование функции _phptemplate_callback(). Первый аргумент этой функции - строка, которая задает имя шаблона .tpl.php. Этому шаблону будет доступна вся информация, которая содержится в массиве переменных, заданных во втором аргументе. Вот как будет выглядеть вызов функции в нашем случае:

Второй шаг - создание и заполнение файла .tpl.php. Его имя должно быть равно содержимому первого аргумента функции _phptemplate_callback(). В нашем случае, это будет файл breadcrumb.tpl.php. А код его будет таким:

Как видим, код просто перенесен из функции в шаблон. Но сейчас нам гораздо удобнее работать с html-кодом (так как нам нужен именно он). Раньше, в функции, нам приходилось следить за синтаксисом php, обходиться без подсветки html-кода - так как вывод html формировался в строках типа
$bla_bla = ‘