Ієрархія файлів теми (шаблону)

У цьому пості йтиметься про те, які бувають назви у файлів теми WordPress і за показ якої сторінки на сайті відповідає кожен з них. Це дуже важливі, потрібні і водночас дуже прості, для розуміння, знання. Ними повинен мати кожен, хто працює з WordPress. Нижче повністю розписано структуру файлів теми WordPress та порядок їх підключення (ієрархія).

Про ієрархію файлів теми я згадував у статті «Умовні теги WordPress» . А нижче те саме, тільки описано по іншому (сподіваюся зрозуміліше).

Приклад того, як працює ієрархія

Наприклад, ми заходимо на сторінку рубрики “Моя рубрика” http://example.com/category/my-category. Ярлик цієї рубрики = my-category , а ID = 25 (ярлик та ID ми можемо подивитися на сторінці редагування рубрики в адмінці). Тоді за шаблон цієї сторінки WordPress відповідатиме один із файлів нижче (файли перевіряються по черзі, перший існуючий у темі файл стане шаблоном цієї сторінки):

1. category-plugins.php
2. category-25.php
3. category.php
4. archive.php
5. index.php

Ієрархія, у разі — це послідовна перевірка існування файлу шаблона. Для контенту однієї сторінки на сайті може підходити кілька файлів. Перевірка, який саме файл буде використаний йде по черзі. Тобто. у WordPress є список відповідних назв файлів, кожна з назв перевіряється по черзі на фізичне існування такого файлу, як тільки WordPress бачить, що файл існує пошук відповідного файлу припиняється і знайдений файл використовується як шаблон.

Інші файли теми

Також, у WordPress є загальноприйняті файли, що підключаються. Він не беруть участі в ієрархії, а просто підключаються вручну там, де потрібно. Наприклад, файл sidebar.php підключається у файлі шаблону теми за допомогою функції get_sidebar() .

Список таких файлів, що «підключаються»:

• functions.php – завжди підключається автоматично під час завантаження теми.
• header.php – get_header()
• sidebar.php – get_sidebar()
• footer.php – get_footer()
• searchform.php – get_search_form()

Типи сторінок та назви файлів

Тепер коли ми розуміємо, як працює ієрархія, давайте подивимося на всі варіанти назв файлів, які WordPress намагається знайти при відвідуванні тієї чи іншої сторінки сайту.

Повна схема для всіх видів сторінок і підходящих файлів виглядає так:

Тепер, я розпишу цю картинку, зроблю з неї список сторінок сайту та підходящі для них php файли теми.

Файли зі списку нижче повинні знаходитись у папці теми.

Записи

Архіви

404 сторінка

• 404.php
• index.php

Сторінка пошуку

• search.php
• index.php

Головна сторінка

• front-page.php
• Логіка постійних сторінок , коли для головної вибрано сторінку в налаштуваннях.
• home.php
• index.php

Сторінка блогу

Сторінка блогу з’являється, коли для головної вибрано постійну сторінку

• home.php
• index.php

Вбудовування (embeds)

Шаблони вбудовування використовуються, коли запитується коротка версія статті для додавання її на іншому сайті. Зазвичай такі URL виглядають так: http://dom/post-url/embedВбудовування з’явилися у версії 4.5 і дозволяють вбудовувати записи в чужі сайти. get_post_embed_url ()

• embed-{post-type}-{post_format}.php
• embed-{post-type}.php
• embed.php

Как это работает в коде ядра

За всю логику: какой файл подключать, отвечает файл ядра wp-includes/template-loader.php. Если разобраться, в нем все описано. Но, это занятие не особо интересное, поэтому я его распишу.

Прежде всего. template-loader.php подключается после того как загрузится вся среда WordPress. После того, как отработает файл wp-load.php и обработается основной запрос – функция wp(). Т.е. template-loader.php подключается в самом-самом конце PHP скрипта…

Сначала срабатывает хук template_redirect. В этом хуке можно произвести какие-то проверки и если надо перенаправить на другой URL. В нем нужно обрывать работу скрипта через die(). Т.е. если этот хук что-то меняет, то на этом работа файла template-loader.php должна закончиться и мы «улетаем» на какую-то другую страницу.

Дальше срабатывает никому не интересный хук exit_on_http_head. Он позволяет сделать так, чтобы при HTTP HEAD запросе что-либо выводилось на экран…

Дальше идут проверки get_query_template().

Дальше – путь до файла шаблона определен! Теперь путь проходит через фильтр template_include. Который позволяет нам изменить путь до файла шаблона для текущего запроса.

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

Фильтры

Иерархию файлов можно изменить через динамические фильтры:

• (type)_template_hierarchy – фильтрует массив названий файлов иерархии, по которому будет идти поиск нужного файла. С WP 4.7.
• (type)_template – фильтрует путь до уже определившегося файла шаблона.

Все варианты параметра type смотрите в одноименном параметр $type функции get_query_template(). Вот они:

• index
• 404
• archive
• post_type_archive
• author
• category
• tag
• taxonomy
• date
• home
• frontpage
• page
• paged
• search
• single
• singular
• attachment
• comments_popup

Пример использования такого фильтра смотрите в ответе на этот вопрос.

—

Источник