template.php

Если вы хотите переопределить функции, которые не входят в основной список (block, box, comment, node и page), то вам нужно заявить об этом PHPTemplate. Чтобы сделать это, создайте в папке темы файл template.php. Этот файл должен начинаться с открывающего тега PHP, — <?php — а закрывающий тег — ?> — использовать не следует.

В качестве примера, будет использована функция theme_item_list() (список всех функций тем можно найти на сайте api.drupal.org. Функция выглядит следующим образом:

<?php
 function theme_item_list($items = array(), $title = NULL) {
  $output = '<div class="item-list">';
  if (isset($title)) {
    $output .= '<h3>'. $title .'</h3>';
  }
?>

Теперь, давайте сделаем ответвление (в котором переопределим функцию).

<?php
/**
* Catch the theme_item_list function, and redirect through the template api
*/
function phptemplate_item_list($items = array(), $title = NULL) {
  // Pass to phptemplate, including translating the parameters to an associative array.
  // The element names are the names that the variables
  // will be assigned within your template.
  return _phptemplate_callback('item_list', array('items' => $items, 'title' => $title));
}
?>

Мы переписали слово theme в названии функции на слово phptemplate и использовали вызов _phptemplate_callback(), чтобы обработать параметры через PHPTemplate. Теперь нам нужно создать в папке темы файл item_list.tpl.php, который будет использоваться для оформления списков пунктов. Начнём с копирования исходного кода функции theme_item_list(). Отметьте: не обёртывайте этот код в функцию.

<?php
  $output = '<div class="item-list">';
  if (isset($title)) {
    $output .= '<h3>'. $title .'</h3>';
  }
?>

Пример template.php