Drupal 7: Определение шаблонов для форм. Темизация форм

Как определить собственные шаблоны и использовать их в построении контента было рассмотрено в статье "Drupal 7: определение шаблонов tpl.php и функций темизации. Хуки темизации”. Распространенной задачей является кастомная темизация форм. Для этого существует замечательный механизм темизации при помощи шаблонов *.tpl.php

Шаблон для формы определяется очень просто:

/**
 * Implements hook_theme().
 */
function MYMODULE_theme() {
  return array(
    'login_form' => array( // id формы
      'render element' => 'form', // указываем что элемент для отображения - форма
      'template' => 'custom_form_template', // имя шаблона custom_form_template.tpl.php
    ),
  );
}

В качестве ключа массива указывается id формы, который можно узнать через Firebug, функции devel, либо через имя функции которая определяет форму.

Теперь в шаблоне можно выводить содержимое формы по отдельности:

<div class="wrapper">
  <div class="left">
    <?php print render($form['login']); ?>
  </div>
  <div class="right">
    <?php print render($form['password']); ?>
  </div>
  <?php print drupal_render_children($form); ?>
</div>

Для того что бы отобразить отдельный элемент нужно воспользоваться функцией render и передать массив с определенным элементом. Также обязательно в форме нужно использовать drupal_render_children($form) для отображения элементов формы которые небыли выведены отдельным рендером.