УрокНеобходимые файлы для создания шаблона. Node.tpl.php

Теперь мы поговорим о таком файле как node.tpl.php. Очень полезный файлик. Он является шаблоном для вывода всех типов материалов. Полезен для каждого сайта, так как всегда надо переписать стандартный вывод статей - иногда ссылки убрать, или, например, показывать тэги только в полной версии материала, а в сокращённой(тизере) не выводить.

Вот как строится материал по стандартному шаблону:

<div id="node-<?php print $node->nid; ?>" class="node<?php if ($sticky) { print ' sticky'; } ?><?php if (!$status) { print ' node-unpublished'; } ?> clear-block">
 
    <?php print $picture ?>
 
    <?php if (!$page): ?>
        <h2>
            <a href="<?php print $node_url ?>" title="<?php print $title ?>">
                <?php print $title ?>
            </a>
        </h2>
    <?php endif; ?>
 
    <div class="meta">
        <?php if ($submitted): ?>
          <span class="submitted">
              <?php print $submitted ?>
          </span>
        <?php endif; ?>
 
        <?php if ($terms): ?>
            <div class="terms terms-inline"><?php print $terms ?></div>
        <?php endif;?>
    </div>
 
    <div class="content">
        <?php print $content ?>
    </div>
 
    <?php print $links; ?>
 
</div>

Теперь, как всегда, остановимся на каждой из частей подробнее:

<div id="node-<?php print $node->nid; ?>" class="node<?php if ($sticky) { print ' sticky'; } ?><?php if (!$status) { print ' node-unpublished'; } ?> clear-block">

Здесь создаётся хтмл-контейнер для ноды (материала). В id записывается node- и её уникальный номер nid. В class запишется sticky, если при создании материала был отмечен галочкой поле "Закреплять вверху(sticky at top)". Также, если было отмечено поле "Не публиковать (not publish)", в класс материала будет добавлен текст node-unpublished.

Едем дальше:

<?php print $picture ?>
 
    <?php if (!$page): ?>
        <h2>
            <a href="<?php print $node_url ?>" title="<?php print $title ?>">
                <?php print $title ?>
            </a>
        </h2>
    <?php endif; ?>

Первая строка понятна всем я думаю - выводится аватарка пользователя, создавшего материал. А вот дальше происходит следущее: если мы просматриваем анонс материала, но нам выводится его заголовок со ссылкой на полную версию материала. А если мы на полной версии, то заголовок не показывается (т.к. в page.tpl.php переменной $title он уже выводится).

<div class="meta">
        <?php if ($submitted): ?>
          <span class="submitted">
              <?php print $submitted ?>
          </span>
        <?php endif; ?>

Вот тут в класс meta выводится одной строкой имя автора и дата создания материала.

<?php if ($terms): ?>
    <div class="terms terms-inline"><?php print $terms ?></div>
<?php endif;?>

Тут таким же образом, как и в предыдущем куске кода, выводятся тэги материала.

После чего следует вывод контента:

<div class="content">
    <?php print $content ?>
</div>

И, наконец, выводятся ссылки материала (читать далее, количество комментариев, ссылка на комментарии, количество просмотров и т.п.):

<?php print $links; ?>

Как всегда по традиции, в завершении материала список доступных переменных файла node.tpl.php

Стандартные переменные

• $title - заголовок материала
• $content - содержимое материала. Может быть полным или сокращённым, в зависимости от переменной $teaser (она определяет, анонс это или нет)
• $picture - аватарка пользователя, написавшего материал
• $date - дата создания материала
• $links - ссылки, такие как "Читать далее", "Добавить комментарий" и т.п.
• $name - имя пользователя, создавшего материал
• $node_url - прямой путь к текущему материалу
• $terms - список тэгов, формирующихся через таксономию (модуль taxonomy)
• $submitted - вывод автора и даты создания материала одной строкой

Другие переменные:

• $node - полный объект материала
• $type - тип материала. Например, blog, page и т.д.
• $comment_count - количество комментариев к статье
• $uid - уникальный идентификатор пользователя, написавшего статью
• $created - дата опубликования статьи. Выводится в таком виде: date('Y - G:i',$node->created), где вместо Y - G:i можно вставить любой php формат даты
• $zebra - принимает значение 'odd' или 'even' в зависимости от чётности материала
• $id - уникальный идентификатор статьи. При создании новой статьи всегда увеличивается на единицу

Статусные переменные (флаги):

• $teaser - возвращает значение ИСТИНА, если выводится анонс статьи
• $page - возвращает значение ИСТИНА, если выводится полная статья
• $promote - возвращает значение ИСТИНА, если стоит галочка напротив "Помещать на главную (promote on front page)"
• $sticky - возвращает значение ИСТИНА, если стоит галочка напротив "Закрепить статью сверху"
• $status - возвращает значение ИСТИНА, если статья опубликована
• $comment - возвращает значение ИСТИНА, если комментарии к статье разрешены
• $readmore - возвращает значение ИСТИНА, если статья непомещается полностью в её анонс
• $is_front - возвращает значение ИСТИНА, если статья находится на главной странице
• $logged_in - возвращает значение ИСТИНА, если пользователь авторизирован
• $is_admin - возвращает значение ИСТИНА, если пользователь имеет права администранора

Мы практически закончили основные файлы шаблонов. Остался последний - box.tpl.php. А потом мы наконец доберёмся до крутых фишек друпала :)