Иерархия шаблонов
Содержание
Редактировали какие-нибудь готовые темы для WordPress? Наверное заметили, что в каждой своя структура файлов.
Это потому, что существует порядок, следуя которому WordPress, в зависимости от текущей страницы сайта, ищет соответствующие файлы в директории темы и, если они существуют — подключает.
Этот урок должен раз и навсегда ответить на вопрос — какой из PHP-файлов темы используется для отображения той или иной страницы сайта?
Что в видеоуроке?
В этом уроке мы с вами приступим к натяжке других шаблонов вёрстки на нашу тему WordPress.
Чтобы скачать тему WordPress, которая получилась у нас в процессе этого урока, необходимо приобрести курс.
Страница поста блога:
Страница 404-й ошибки:
Страница категорий (рубрики на блоге)
«Статическая» страница блога:
Типо тоже обычная страница, но не совсем – потому что содержит форму:
Условные теги WordPress
К примеру, функция is_single() позволяет определить, находимся ли мы, просматривая сайт в данный момент, на странице поста.
Полный список условных тегов WordPress и их документацию вы найдёте здесь.
На некоторых схемах ниже, для того, чтобы обозначить, для какого типа страницы используются определенные файлы, я как раз таки задействовал условные теги.
Структура файлов (схема подключения)
Кликните по картинке, чтобы открыть в полном размере.
На графике показан порядок, по которому WordPress запрашивает файлы. Есть и альтернативные варианты этой схемы, чуть более старые или урезанные, но рабочие, вот первый, а вот второй.
$custom Название файла шаблона страниц — про них всё подробно расписано здесь.
Пример для рубрик
Сразу же приведу пример для страницы с рубрикой с >54 и ярлыком myphotos :
WordPress.org
Codex
Иерархия шаблонов
Contents
Введение
Страницы WordPress сайта собираются подобно пазлу из файлов-шаблонов. Некоторые шаблоны (например header.php и footer.php) задействованы на всех страницах, другие используются только при определенных условиях.
О чём эта статья
Эта статья отвечает на следующий вопрос:
Какие файлы шаблонов использует WordPress для отображения определённого типа страниц?
Кому это может пригодиться
Со времен появления тем оформления в WordPress версии 1.5, шаблоны становятся все более настраиваемы. Перед тем как создать свою тему, вам нужно понять механизм работы шаблонов: как WordPress отбирает файлы-шаблоны для вывода разных страниц в вашем блоге. Если вы хотите что-то изменить в готовой теме, эта статья поможет вам понять, какой шаблон нужно редактировать.
Использование тегов условий
WordPress может несколькими способами подбирать шаблоны в соответствии с типом контента. Разработчики Тем для WordPress могут также использовать теги условий (Conditional Tags) для того, чтобы определенный шаблон был использован на конкретной странице блога. Некоторые Темы могут не содержать всех файлов-шаблонов, описанных в этой статье. В некоторых Темах использованы теги условий (conditional tags) для вызова других шаблонов. Читайте подробнее здесь: теги условий (Conditional Tags) и «Query Based» in Theme Development.
Иерархия шаблонов
Общая идея
WordPress использует Строку Запроса — информацию, содержащуюся в каждой ссылке вашего сайта — для того, чтобы определить какой шаблон или набор шаблонов использовать для отображения страницы.
Сперва WordPress находит каждую Строку Запроса по типам запросов — т.е. определяет какой тип страницы (страница поиска, страница категорий, главная страница и др.) был запрошен.
После этого шаблоны выбираются и содержимое страницы генерируется в порядке, предложенном иерархией шаблонов WordPress, в зависимости от доступности шаблонов конкретной темы WordPress.
WordPress ищет файлы шаблонов со специальными именами в папке текущей темы и использует первый подходящий файл шаблона указанный в соответствующем запросе.
За исключением основного шаблона index.php, разработчики тем могут использовать или не использовать файлы шаблонов по желанию. Если WordPress не находит шаблон с указанным именем, он переходит к следущему по иерархии шаблону. Если не один из искомых шаблонов не подходит, WordPress использует index.php (шаблон главной страницы Темы).
Примеры
Если Ваш блог находится по адресу http://domain.com/wp/ и посетитель переходит на страницу рубрики http://domain.com/wp/category/your-cat/, WordPress в папке текущей Темы в первую очередь ищет шаблон, который отвечает за вывод этой рубрики. Если ID данной рубрики 4, WordPress ищет шаблон с именем category-4.php. Если такой шаблон не найден, WordPress ищет общий для всех рубрик шаблон category.php. Если и такого файла-шаблона нет, WordPress ищет шаблон для вывода архива archive.php. Если нет и этого файла, WordPress будет использовать основной шаблон Темы index.php.
Если посетитель переходит на главную страницу сайта http://domain.com/wp/, WordPress ищет шаблон home.php и использует его для генерации запрошенной страницы. Если файла home.php в папке Темы нет, WordPress использует файл index.php для вывода главной страницы блога.
Наглядный обзор
Следующая диаграмма показывает, какие файлы шаблона вызываются при создании страницы WordPress, согласно иерархии шаблонов WordPress.
Подробнее о иерархии шаблонов
Рассмотрим приоритет использования шаблонов при выводе разных типов контента в WordPress.
Отображение главной страницы
Отображение Главной страницы
Отображение одиночной записи
Отображение статической страницы
Отображение рубрики
Отображение метки
Отображение автора
Отображение даты
Отображение результатов поиска
Отображение ошибки 404 (Не найдено)
Отображение приложений
Смотрите также
Следующие ссылки имеют непосредственное отношение к теме статьи.
Создание темы WordPress – archive.php, category.php и tag.php
Сегодня речь пойдет об архивах записей, а точнее о файлах archive.php, Category.php и Tag.php, в рамках серии о создании темы WordPress с нуля. Это будет довольно короткая и простая статья, потому что эти файлы шаблонов очень незамысловаты. Как вы уже знаете, WordPress позволяет добавлять рубрики и метки для записей. Когда вы нажимаете на определенную метку или рубрику, они отображают все записи, которые находятся в этой конкретной категории или тэге.
archive.php
Нам нужно создать два файла шаблонов, которые расскажут WordPress, как вы хотите, чтобы эти отфильтрованные сообщения рубрик и сообщения меток отображались.
Более глобально за отображение рубрик и меток отвечает файл archive.php. Но если вы хотите, чтобы страница категории и страница тэгов отображались по разному, нужно для них создавать отдельный шаблон.
Давайте посмотрим, как выглядит страница меток и рубрик на сайте сейчас, когда используется файл по умолчанию archive.php.
Создадим рубрику под названием «Первая рубрика» и поместим в нее запись номер 1. И создадим еще пару записей в этой рубрике для наглядности.
Вот так будет выглядеть страница сайта, если посетитель захочет просмотреть все записи данной рубрики:
Создадим для записей несколько меток и посмотрим, что будет, если посетитель захочет посмотреть все записи с данной меткой.
Как видим, выглядят они одинаково. Если вы выберете все записи одного автора, также будет использоваться файл archive.php.
Category.php
Давайте создадим шаблон только для рубрик, чтобы при выводе записей одной категории страница выглядела иначе. Для этого нужно создать в корне темы файл по названием Category.php.
Добавим в него свой код
Как видим, теперь страница категории выглядит иначе, при этом страница меток не изменилась.
Аналогично, можно изменить внешний вид и для вывода записей по метке, создав файл tag.php, а также изменить внешний вид страницы записей автора, создав файл author.php.
На что следует обратить внимание в коде!
Первое, что вы заметите, это то, что оператор if был отделен от оператора while. Это правильная процедура для этих двух файлов шаблонов, потому что нам нужно сказать «если есть записи», а затем нам нужно использовать две новые функции, которых мы еще не коснулись. Для Category.php мы будем использовать:
single_cat_title (); — функция, которая будет запрашивать/отображать имя конкретной рубрики, которая была выбрана/нажата. По сути, мы хотим иметь заголовок в верхней части страницы, который говорит «Вот сообщения в данной категории». В приведенном выше примере я использую фразу » Все записи рубрики:».
Все это также относится и к tag.php. Но здесь мы используем функцию single_tag_title(); вместо single_cat_title();.
Для большинства пользователей WordPress — это черный ящик. Вы помещаете Read more
functions.php файл шаблона функций в WordPress действительно является двигателем вашей Read more
Сегодня мы поговорим о еще трех файлах, которые, если их Read more
Иерархия файлов темы (шаблона)
В этом посте речь пойдет о том, какие бывают названия у файлов темы WordPress и за показ какой страницы на сайте отвечает каждый из них. Это очень важные, нужные, и в тоже время очень простые, для понимания, знания. Ими должен обладать каждый, кто работает с WordPress. Ниже полностью расписана структура файлов темы WordPress и порядок их подключения (иерархия).
Об иерархии файлов темы я упоминал в статье «Условные теги в WordPress». А ниже тоже самое, только подробнее и понятнее.
Подключения файлов темы (теория)
Иерархия, в данном случае последовательная проверка, говорит о том, что для вывода одной страницы на сайте, подходят несколько названий файлов. Проверка какой файл будет использован идет поочередно. Т.е. есть список файлов, каждый из них по очереди проверяется на физическое существование, как только найден существующий файл проверка прекращается и найденный файл используется в качестве шаблона.
Полная схема для всех видов страниц и их файлов выглядит так:
Типы страниц и названия файлов
Ниже список страниц сайта и отвечающие за них php файлы темы. В этом разделе расписана картинка иерархии файлов темы, которая немного выше.
Ниже указана страница сайта и соответствующий ей список PHP файлов. Такие файлы должны находится в корневой папке темы.
Записи
Страница (запись page)
Запись (запись post)
Произвольный тип записи
Вложение
Полный список MIME типов смотрите в описании get_allowed_mime_types().
Архивы
Рубрика
Метка
Таксономия
Страница архива типа записи
Страница автора
Страница архива по дате (день, месяц, год)
404 страница
Страница поиска
Главная страница
Страница блога
Страница блога появляется, когда для главной выбрана постоянная страница
Встраивания (embeds)
Шаблоны встраивания используются когда запрашивается короткая версия статьи для добавления её на другом сайте. Обычно такие URL выглядят так: http://dom/post-url/embed Встраивания появились в версии 4.5 и позволяют встраивать ваши записи в чужие сайты. См. get_post_embed_url()
Чтобы изменить только контент встраивания, можно в теме создать файл embed-content.php и описать там HTML. Оригинальный HTML находится в файле движка /wp-includes/theme-compat/embed-content.php
Как это работает
За всю логику: какой файл подключать, отвечает файл ядра wp-includes/template-loader.php. Если разобраться, в нем все описано. Но, это занятие не особо интересное, поэтому я его распишу.
Дальше идут проверки по всем условным тегам где выясняется какой файл шаблона подходит под текущий запрос. Проверяется условный тег, затем еще один и еще. Как только один из условных тегов сработал, вызывается соответствующая функция, которая находит подходящий файл шаблона и возвращает путь до него. Все такие функции описаны в get_query_template().
Дальше, файл подключается в PHP и запускается визуальная часть генерации страницы.
Фильтры
Иерархию файлов можно изменить через динамические фильтры:
Пример использования такого фильтра смотрите в ответе на этот вопрос.
Archive php wordpress назначение
В этой рубрике Вы найдете бесплатные уроки по WordPress, которые позволят Вам усовершенствовать свой блог.
Этот урок скорее всего будет психологическим, т.к. многие люди работают с WordPress и одновременно с Joomla, но не могут решится каким CMS пользоваться.
Про шаблоны WordPress
После установки и настройки движка нам нужно поработать с дизайном нашего сайта. Это довольно долгая тема, но мы постараемся рассказать всё кратко и ясно.
Самые первые настройки после установки движка WordPress
Сегодня мы вам расскажем какие первые настройки нужно сделать после установки движка WordPress. Этот урок будет очень полезен для новичков.
10 стратегий эффективного продвижения статей в блогах на WordPress
Топ WordPress альтернатив для создания персонального сайта
Нужен персональный сайт, но вы не хотите задействовать WordPress? Тогда данная подборка для вас.
В поисках профессионального рабочего окружения для WordPress
За время работы проекта мы не раз рассказывали о настройках рабочего окружения для движка WordPress. WAMP для Windows, MAMP для Mac или XAMPP для обеих операционных систем. Сегодня мы бы хотели поговорить о минусах перечисленных инструментов, а также пролить свет на новые решения.
Работа с WordPress CLI
Данное руководство будет полезно как администраторам, так и обычным пользователям. В WordPress появился консольный инструмент, который поможет сэкономить кучу времени!