Файлы шаблона

wordpress-theme-basics
Файлы шаблонов используются во всех WordPress темах, но сначала давайте узнаем о терминологии.

Терминология шаблонов

Термин «шаблон» используется по-разному при работе с WordPress темами:

  • Файлы шаблонов существуют в пределах темы и выражают то, как отображается ваш сайт.
  • Шаблоны страниц это шаблоны, которые применяются только к страницам, чтобы изменить их внешний вид и восприятие. Шаблон страницы может быть применен к одной странице, к секции страницы или к классу страниц.
  • Теги шаблона — встроенные в WordPress функции, которые вы можете использовать в файле шаблона для извлечения и отображения данных например, the_title() и the_content()
  • Иерархия шаблона это логика, которую WordPress использует, чтобы решить, какой файл(ы) шаблона темы использовать, в зависимости от запрошенного контента.

Файлы шаблонов

WordPress темы состоят из файлов шаблонов. Это PHP файлы, которые содержат смесь HTML, тегов шаблона и PHP код.

Когда создаете свою тему, вы будете использовать файлы шаблонов чтобы повлиять на макет и дизайн различных частей вашего сайта. Например, вы должны использовать header.php шаблон для создания заголовка, или comments.php шаблон, для включения комментариев.

Когда кто-то посещает страницу на вашем сайте, WordPress загружает шаблон, основанный на запросе. Иерархия Шаблонов описывает, какой файл шаблона WordPress будет загружать в зависимости от типа запроса и существует ли шаблон в теме. Затем сервер анализирует PHP в шаблоне и возвращает HTML для посетителя.

Наиболее важный файл шаблона index.php, который является перехватывающим шаблоном, если более специфический шаблон не может быть найден по иерархии шаблонов.

Хотя тема только нуждается в index.php шаблоне, как правило, тема будет включать в себя множество шаблонов для различного отображения типов контента и их контекста.

Части шаблона (блоки)

Блок шаблона это часть шаблона, которая включена в качестве части другого шаблона, как например заголовок сайта. Они могут быть встроены в нескольких шаблонах, а также упрощают создание темы разделением полномочий между собой. Блоки шаблона в темах это обычно:

  • header.php для формирования хедера
  • footer.php для формирования подвала
  • sidebar.php для формирования сайдбара

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

Распространенные файлы шаблонов WordPress

Ниже список некоторых основных шаблонов тем и файлов, распознаваемых WordPress:

  • index.php — Основной файл шаблона. Обязателен во всех темах.
  • style.css — Главная таблица стилей. Обязательный файл во всех темах и содержит информационный заголовок темы.
  • rtl.css — Право-левая таблица стилей автоматически включается, если направлением текста в языке сайта является справа-налево.
  • comments.php — Шаблон комментариев.
  • front-page.php — Шаблон главной страницы загружается, если статическая главная страница указана в  Admin > Настройки > Чтение.
  • home.php — Это шаблон главной страницы по умолчанию. Если вы не установите в WordPress использование статической главной страницы, то этот шаблон используется, чтобы показать последние записи.
  • header.php — Файл шаблона заголовка, как правило, содержит тип документа вашего сайта, мета-информацию, ссылки на стили, скрипты и других данные.
  • single.php — Используется, когда посетитель запрашивает одну запись. Для этого и всех других запрашиваемых шаблонов, используется index.php, если запрашиваемого шаблона нет.
  • single-{post-type}.php — Используется, когда посетитель запрашивает одну запись пользовательского типа записей. Например, single-book.php будет использоваться для отображения одиночных записей для пользовательского типа записи book. index.php используется, если определенного запрашиваемого шаблона для пользовательского типа записи нет.
  • archive-{post-type}.php — Используется, когда посетитель запрашивает архив записей пользовательского типа. Например, archive-books.php будет использоваться для отображения архива записей для пользовательского типа записей book. archive.php файл шаблона используется, если файла archive-{post-type}.php нет.
  • page.php — Шаблон страницы используется, когда посетители запрашивают отдельные страницы, которые встроены в шаблон.
  • page-{slug}.php — Используется, когда посетители запрашивают конкретную страницу, /about/ например,  ( page-about.php ).
  • category.php — Шаблон категорий используется, когда посетитель запросил записи по категориям.
  • tag.php — Шаблон тега используется, когда посетитель запросил записи по тегу.
  • taxonomy.php — Шаблон таксономии используется, когда посетитель запрашивает термин из пользовательской таксономии.
  • author.php — Шаблон страницы автор используется всякий раз, когда посетитель загружает страницу автора.
  • date.php — Шаблон даты / времени используется, когда записи запрошены по дате или времени. Например, страницы сгенерированные с таким slug: http://example.com/blog/2014/ http://example.com/blog/2014/05/ http://example.com/blog/2014/05/26/
  • archive.php — Используется, когда посетители запросят записи по категории, автору или дате. Примечание: этот шаблон будет отменен, если более специфические шаблоны присутствуют, такие как category.php, author.php, date.php.
  • search.php — Используется для отображения результатов пользовательского поиска.
  • attachment.php — Шаблон вложения используется при просмотре одного вложения, такого как изображение, PDF, или другого медиа-файла.
  • image.php — Шаблон вложения изображения более специфический вариант attachment.php и используется при просмотре одного вложения изображения. Если файла нет, WordPress будет использовать attachment.php вместо него.
  • 404.php — Шаблон 404 используется, когда WordPress не может найти запись, страницу или другой контент, который соответствует запросу посетителя.

Использование файлов шаблонов

В шаблонах WordPress, вы можете использовать условные теги для отображения информации динамически, включать другие файлы шаблона, или другим способом настроить свой ​​сайт.

Например, в index.php вы можете включить другие файлы в вашем окончательном варианте страницы:

  • Чтобы подключить заголовок, используйте get_header()
  • Чтобы подключить боковую панель, используйте get_sidebar()
  • Чтобы подключить подвал, используйте get_footer()
  • Чтобы подключить форму поиска, используйте get_search_form()
  • Чтобы подключить пользовательские файлы темы, используйте get_template_part()

Вот пример WordPress тегов шаблонов для  подключения специфических шаблонов к Вашей странице:

Существует целая страница по тегам шаблона, где вы можете узнать все о них. Также обратитесь к разделу «Ссылки на файлы и папки темы» для получения дополнительной информации о связывании компонентов шаблонов.

Навигация по разделам:

2 комментария

  1. Алексей

    Чёта неподробно написано! мне нужен шаблон файла attachment.php

    Ответить
    • Eugene Kopich

      В статье упоминается и этот файл. Чуть более подробно дальше в руководстве в разделе Иерархия шаблона
      Если в вашей WP теме нет файла attachment.php — можно создать его самостоятельно. Также шаблон можно создавать для каждого mime-type отдельно.

      Ответить

Оставить комментарий

Ваш e-mail не будет опубликован. Обязательные поля помечены *