Коротко: шаблон WordPress — это файл PHP в папке темы, который описывает вывод страницы: index.php для списка записей, page.php для страниц, single.php для записи. Новый шаблон страницы создают с комментарием Template Name.
Иерархия шаблонов
| Файл | Что выводит |
|---|---|
index.php |
общий список записей |
single.php |
одна запись |
page.php |
обычная страница |
archive.php |
архив записей |
404.php |
страница «не найдено» |
WordPress выбирает шаблон по «иерархии»: сначала ищет самый точный файл, затем всё более общие, а в конце обращается к index.php.
Мини-тема
my-theme/
style.css // заголовок темы
index.php // обязательный файл
functions.php // подключение стилей
header.php
footer.php
page.php
single.phpОбязательны только style.css с заголовком и index.php. Остальные файлы добавляют по мере необходимости.
Вкладки: виды шаблонов
<?php
/* Template Name: Широкий шаблон */
get_header(); ?>
<div class="wide"><?php the_content(); ?></div>
<?php get_footer();Такой файл появится в списке шаблонов страницы в редакторе. Удобно для страниц без боковой панели или с особой вёрсткой.
php
<?php if ( have_posts() ) : while ( have_posts() ) : the_post(); ?>
<h2><?php the_title(); ?></h2>
<?php the_excerpt(); ?>
<?php endwhile; else : ?>
<p>Записей нет.</p>
<?php endif; ?>Цикл — сердце шаблона. Он выводит записи одну за другой. Не забудьте про ветку else на случай отсутствия записей.
php
<?php get_template_part('parts/card'); ?>Повторяющиеся блоки выносят в отдельные файлы через get_template_part. Так карточку записи правят в одном месте, а не в каждом шаблоне.
Практика: сделать шаблон
- Создайте файл шаблона в теме.
- Подключите
headerиfooter. - Напишите цикл вывода записей.
- Добавьте ветку для случая «нет записей».
- Для страницы укажите
Template Name. - Проверьте вывод на тестовых данных.
Частые ошибки: причина → решение
| Симптом | Причина | Решение |
|---|---|---|
| Тема не активируется | нет заголовка в style.css |
добавить комментарий темы |
| Белый экран | ошибка PHP | включить отладку, найти строку |
| Страница не выбирается | нет Template Name |
добавить комментарий |
| Записи не выводятся | не вызван цикл | добавить while ( have_posts() ) |
| Стили не подключены | нет wp_enqueue_style |
добавить в functions.php |
Проверьте себя
Вопросы и ответы
Правило, по которому WordPress выбирает файл шаблона: от самого конкретного к общему. Если подходящего файла нет, используется index.php.
Это «мозг» темы: здесь подключают стили и скрипты, регистрируют меню, области виджетов и добавляют свои функции. Файл загружается автоматически.
С блочными темами — да, шаблоны собирают в редакторе сайта из блоков. Классические PHP-шаблоны всё ещё нужны для нестандартного вывода.
Начните с простой собственной темы: style.css, index.php, цикл и подключение частей. Это даст понимание, на котором строятся любые темы.
Итоги
- Шаблон — PHP-файл, который описывает вывод страницы.
- Обязательны
style.cssс заголовком иindex.php. - WordPress выбирает шаблон по иерархии.
- Повторяющиеся блоки выносят в
get_template_part.
Комментарии
Пока комментариев нет — будьте первым, кто поделится мнением.