iT-Ti.ruочерки сисадмина

Сайт и хостинг WordPress

Каркас темы WordPress: минимальная классическая тема и переход на блочные

Опубликовано: Обновлено: 4 мин чтенияАвтор: Редакция iT-Ti.ru

Тема 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.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 вручную обычно не используют.