Каркас темы WordPress: минимальная классическая тема и переход на блочные
Тема WordPress может состоять всего из двух файлов: style.css с заголовком и index.php. Остальное — header, footer, functions.php и шаблоны — добавляется по мере необходимости. Рядом с классическими темами сегодня существуют блочные, управляемые файлом theme.json.
Готовых тем тысячи, но собственный каркас нужен там, где важны скорость, чистый код и полный контроль над разметкой. Начать можно с минимума и дорастить до полноценной темы. Ниже — классический путь, а в конце — современная альтернатива.
Минимум: два файла
Создайте каталог wp-content/themes/my-theme/ и положите в него style.css:
/*
Theme Name: My Theme
Theme URI: https://example.ru/
Author: Редакция
Description: Минимальная тема для сайта
Version: 1.0
Requires at least: 6.0
Requires PHP: 8.1
License: GPL-2.0-or-later
Text Domain: my-theme
*/
Обязательна только строка Theme Name, остальное — метаданные для админки. Второй файл — index.php, универсальный шаблон:
<?php get_header(); ?>
<main>
<?php if ( have_posts() ) : while ( have_posts() ) : the_post(); ?>
<article <?php post_class(); ?>>
<h2><a href="<?php the_permalink(); ?>"><?php the_title(); ?></a></h2>
<?php the_excerpt(); ?>
</article>
<?php endwhile; the_posts_pagination(); else : ?>
<p>Ничего не найдено.</p>
<?php endif; ?>
</main>
<?php get_footer(); ?>
После этого тема появится в «Внешний вид → Темы». Этот цикл have_posts() / the_post() называют циклом WordPress (The Loop): он перебирает записи текущего запроса.
Header и footer
Шапку и подвал выносят в header.php и footer.php:
<!doctype html>
<html <?php language_attributes(); ?>>
<head>
<meta charset="<?php bloginfo( 'charset' ); ?>">
<meta name="viewport" content="width=device-width, initial-scale=1">
<?php wp_head(); ?>
</head>
<body <?php body_class(); ?>>
<?php wp_body_open(); ?>
<header><a href="<?php echo esc_url( home_url( '/' ) ); ?>"><?php bloginfo( 'name' ); ?></a></header>
В footer.php перед закрывающим </body> обязательно вызывайте wp_footer(). Без wp_head() и wp_footer() не загрузятся скрипты и стили плагинов, а панель администратора не появится.
Иерархия шаблонов
WordPress выбирает файл для страницы по цепочке от более конкретного к более общему, и index.php — последний запасной вариант.
| Страница | Шаблоны по порядку |
|---|---|
| Запись | single-{тип}-{слаг}.php, single-{тип}.php, single.php, singular.php, index.php |
| Страница | page-{слаг}.php, page-{id}.php, page.php, singular.php, index.php |
| Рубрика | category-{слаг}.php, category.php, archive.php, index.php |
| Поиск | search.php, index.php |
| Ошибка 404 | 404.php, index.php |
Начните с index.php, а затем добавляйте single.php, page.php, archive.php и 404.php, когда понадобятся различия в оформлении.
functions.php и подключение стилей
В functions.php регистрируют возможности темы и подключают ресурсы:
<?php
add_action( 'after_setup_theme', function () {
add_theme_support( 'title-tag' );
add_theme_support( 'post-thumbnails' );
add_theme_support( 'html5', [ 'search-form', 'comment-form', 'gallery', 'caption' ] );
add_theme_support( 'automatic-feed-links' );
register_nav_menus( [ 'primary' => 'Главное меню' ] );
} );
add_action( 'wp_enqueue_scripts', function () {
wp_enqueue_style( 'my-theme', get_stylesheet_uri(), [], wp_get_theme()->get( 'Version' ) );
} );
title-tag избавляет от ручного <title> в шапке, wp_enqueue_style отвечает за подключение style.css. Подробнее о том, что вообще допустимо держать в этом файле, читайте в материале про functions.php.
Блочные темы
Начиная с WordPress 5.9 есть полноценные блочные темы. Вместо PHP-шаблонов используются HTML-файлы с блоками, а стили собираются в theme.json. Минимальная структура:
my-block-theme/
├── style.css
├── theme.json
├── templates/
│ └── index.html
└── parts/
├── header.html
└── footer.html
{
"$schema": "https://schemas.wp.org/trunk/theme.json",
"version": 3,
"settings": {
"color": { "palette": [ { "slug": "base", "color": "#ffffff", "name": "Основной" } ] },
"layout": { "contentSize": "720px", "wideSize": "1100px" }
}
}
В templates/index.html подключаются части через блок <!-- wp:template-part {"slug":"header"} /-->, а содержимое — через блок «Запрос» (Query Loop). Цвета, шрифты и отступы правятся прямо в редакторе сайта. Сегодня новые публичные темы для каталога создаются как блочные, а классические по-прежнему широко используются на уже работающих проектах и остаются рабочим вариантом, если вам нужен полный контроль над PHP-разметкой.
Чего стоит избегать
- Прописывать абсолютные адреса вместо
home_url()иget_template_directory_uri(). - Выводить данные без экранирования: используйте
esc_html(),esc_url(),esc_attr(). - Складывать в тему то, что должно жить в плагине (например, регистрацию типов записей): при смене темы данные пропадут из интерфейса.
Как проверить свою тему
Для проверки пригодятся плагин Theme Check и набор тестовых данных Theme Unit Test из документации WordPress: они покажут устаревшие функции и отсутствующие обязательные вызовы. Включите WP_DEBUG на локальной копии и пройдитесь по типичным страницам: главная, запись, страница, рубрика, поиск, 404. Заодно проверьте вёрстку на узком экране и клавиатурную навигацию, а про безопасность вывода данных помните при каждом echo.
Частые вопросы
Какие файлы нужны для минимальной темы WordPress?
Обязательны style.css с комментарием-заголовком (минимум Theme Name) и index.php. Для блочной темы вместо index.php нужен templates/index.html. Остальные файлы подключаются по необходимости.
Куда класть свою тему WordPress?
В каталог wp-content/themes/ЕЁ-ИМЯ/. После этого тема появится в разделе «Внешний вид → Темы» и её можно активировать.
Чем блочная тема отличается от классической?
В блочной теме шаблоны пишутся в HTML из блоков, а цвета, шрифты и отступы задаются в theme.json и редактируются в редакторе сайта. В классической — шаблоны на PHP и настройки в Customizer.
Нужно ли подключать стили через wp_enqueue_style?
Да, это правильный способ. Он учитывает зависимости, версии и позволяет другим плагинам и дочерним темам менять порядок подключения. Тег link в header.php вручную обычно не используют.