Drupal → Темизация форм

Drupal 8+

Пример темизации формы с идентификатором example_form:

1. Реализуем хук hook_theme(), в котором в качестве имени шаблона указываем идентификатор формы.

/**
 * Implements hook_theme().
 */
function THEMENAME_theme(): array {
  return [
    'example_form' => [
      'render element' => 'form',
    ],
  ];
}

2. Создаём файл example-form.html.twig, в котором выводим всё что нужно:

<header>
  {{ form.element1 }}
  {{ form.element2 }}
</header>
{{ form|without('element1', 'element2') }}

3. Сбрасываем кэш.

Как это работает? Если у формы не задано свойство #theme, а оно по умолчанию не задано, то в \Drupal\Core\Form\FormBuilder::prepareForm() вызывается:

$form['#theme'] = [$form_id];
if (isset($build_info['base_form_id'])) {
  $form['#theme'][] = $build_info['base_form_id'];
}

Остаётся только объявить соответствующий шаблон и создать twig файл.

Подробнее.

Drupal 7

Пример темизации формы commerce_checkout_form_checkout:

1. Реализуем хук hook_theme():

function THEMENAME_theme() {
  return array(
    'commerce_checkout_form_checkout' => array(
      'render element' => 'form',
      'template' => 'commerce-checkout-form-checkout',
    ),
  );
}

2. В корне модуля/темы создаём файл commerce-checkout-form-checkout.tpl.php:

<div class="row">
  <div class="col">
    <?php echo render($form['field_name1']); ?>
    <?php echo render($form['field_name2']); ?>
  </div>
  <div class="col">
    <?php echo render($form['field_name3']); ?>
  </div>
</div>
<?php echo drupal_render_children($form); ?>

3. Очищаем кэш.