Урок - Именование шаблонов.

Главная » Курсы » Курс Drupal 6, Темизация. » Урок - Именование шаблонов.

Обучающий онлайн курс
Drupal 6, Темизация.

Лицензия: Копирование запрещено.

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

block-[region|[module|-delta]].tpl.php

Базовый шаблон: block.tpl.php

Используется для формирования блоков определённого региона и модуля.

  • block-module-delta.tpl.php
  • block-module.tpl.php
  • block-region.tpl.php

module — название модуля.
delta — внутренний ID назначенный блоку модулем.
region — имеет эффект для обозначенного региона.

Пример: block-user-1.tpl.php.

comment-[type].tpl.php

Базовый шаблон: comment.tpl.php

Используется для формирования комментариев документов определённого типа (для документов, аналогичный шаблон будет называться node-[type].tpl.php.)

comment-wrapper-[type].tpl.php

Базовый шаблон: comment-wrapper.tpl.php

Используется для формирования обёрток комментариев документов определённого типа.

forums-[[container|topic]-forumID].tpl.php

Базовый шаблон: forums.tpl.php

Используется для формирования форумов, контейнеров и тем форумов.

Для контейнеров:

  • forums-ForumID.tpl.php
  • forums-containers.tpl.php
  • forums-containers-ForumID.tpl.php

Для тем форумов (обсуждений, дискуссий):

  • forums-ForumID.tpl.php
  • forums-topics.tpl.php
  • forums-topics-ForumID.tpl.php

maintenance-page-[offline].tpl.php

Базовый шаблон: maintenance-page.tpl.php

Используется для формирования страницы, при неудачном обращении к базе данных. Удобен для вывода страницы без сообщений об ошибках.

node-[type].tpl.php

Базовый шаблон: node.tpl.php

Используется для формирования области содержания документов определённого типа.

page-[front|internal/path].tpl.php

Базовый шаблон: page.tpl.php

Основан на внутреннем адресе страницы, не путайте с альтернативным адресом. Не забывайте, что первая страница сайта может быть определена на странице Управление → Конфигурация → Информация о сайте. Также помните, что для первой страницы всегда можно использовать шаблон page-front.tpl.php.

Если вы находитесь на странице example.com/node/1/edit, то шаблоны будут искаться в следующей последовательности:

  • page-node-edit.tpl.php
  • page-node-1.tpl.php
  • page-node.tpl.php
  • page.tpl.php

Если вы находитесь на странице example.com/tracker, то шаблоны будут искаться в следующей последовательности:

page-tracker.tpl.php
page.tpl.php

Если вы находитесь на странице example.com/user/1, то шаблоны будут искаться в следующей последовательности:

page-user-1.tpl.php
page-user.tpl.php
page.tpl.php

Если вы находитесь на странице example.com/taxonomy/term/1, то шаблоны будут искаться в следующей последовательности:

page-taxonomy-term-1.tpl.php
page-taxonomy-term.tpl.php
page-taxonomy.tpl.php
page.tpl.php

Если вы находитесь на странице example.com/, то шаблоны будут искаться в следующей последовательности:

page-front.tpl.php
page.tpl.php

poll-bar-[block].tpl.php

Базовый шаблон: poll-bar.tpl.php

poll-results-[block].tpl.php

Базовый шаблон: poll-results.tpl.php

poll-vote-[block].tpl.php

Базовый шаблон: poll-vote.tpl.php

В отличие от предыдущего, действие распространяется не на результаты опроса, а на форму голосования.

profile-wrapper-[field].tpl.php

Базовый шаблон: profile-wrapper.tpl.php

Используется для общей страницы со списком участников. Для просмотра определённых полей, например страницы drupal.org/profile/country/Russia используйте шаблон profile-wrapper-country.tpl.php.

search-results-[searchType].tpl.php

Базовый шаблон: search-results.tpl.php

Примеры:

  • Для страницы example.com/search/node/Search+Term будет использоваться шаблон search-results-node.tpl.php.
  • Для страницы example.com/search/user/Bob будет использоваться шаблон search-results-user.tpl.php.

search-result-[searchType].tpl.php

Базовый шаблон: search-result.tpl.php

В отличие от предыдущего, действие распространяется на отдельный результат поиска.