Пошаговая инструкция по созданию дочерней темы WordPress: структура файлов, подключение стилей родительской темы, настройка functions.php и переопределение шаблонов. С примерами кода и чек-листом.
Дочерняя тема (child theme) - это отдельная тема WordPress, которая наследует стили, шаблоны и функции родительской темы, позволяя безопасно вносить изменения без потери правок при обновлении. В этой инструкции разберём создание дочерней темы с нуля: от структуры файлов до подключения functions.php, переопределения шаблонов и типичных ошибок, из-за которых сайт ломается.
Когда вы меняете файлы активной темы напрямую - правки в style.css, functions.php, шаблонах - первое же обновление перезапишет их. Дочерняя тема WordPress решает эту проблему: она лежит в отдельной папке, ссылается на родительскую и перехватывает нужные файлы, не затрагивая оригинал.
Принцип работы строится на приоритете загрузки:
get_stylesheet_directory()).get_template_directory()).wp_enqueue_style(), поэтому порядок загрузки контролируется.Ниже - таблица, которая показывает, чем отличается работа с родительской темой напрямую от использования дочерней. Это ключевой аргумент, когда вы решаете, стоит ли тратить 10 минут на настройку.
| Критерий | Правки в родительской теме | Дочерняя тема (child theme) |
|---|---|---|
| Обновление темы | Все изменения удаляются | Изменения сохраняются |
| Скорость правки | Быстро, но рискованно | Быстро и безопасно |
| Откат изменений | Только из бэкапа | Достаточно удалить файл из дочерней |
| Перенос на другой сайт | Нужно патчить родительскую | Копируете одну папку |
| Совместимость с плагинами | Конфликты при обновлении | Конфликты минимальны |
| SEO и скорость | Одинаково | Одинаково (нет оверхеда) |
Подключитесь к серверу по FTP или откройте файловый менеджер хостинга. Перейдите в каталог:
Создайте папку с понятным именем. Рекомендуемый формат: имяродительской-темы-child. Примеры:
twentytwentyfive-childflavor-childmyproject-childВнутри папки создайте файл style.css и вставьте заголовок. Это единственный обязательный файл дочерней темы.
Разбор обязательных полей:
| Поле | Назначение | Обязательное |
|---|---|---|
Theme Name |
Отображаемое название в админке | Да |
Template |
Имя папки родительской темы (точно как на сервере) | Да |
Version |
Версия для кэширования и обновлений | Рекомендуется |
Description |
Краткое описание, видно в «Внешний вид → Темы» | Нет |
Author |
Автор темы | Нет |
Text Domain |
Домен локализации для перевода строк | Рекомендуется |
Template должно совпадать с именем папки родительской темы побуквенно. Если родитель называется flavor-developer, а вы напишете flavor, WordPress не найдёт родителя и выдаст ошибку «parent theme missing».В той же папке создайте functions.php. Через него подключаются стили родителя и добавляется собственная логика.
Что здесь происходит:
get_template_directory_uri() - URL папки родительской темы.get_stylesheet_directory_uri() - URL папки дочерней темы.array( 'parent-style' ) гарантирует, что дочерний style.css загрузится после родительского и переопределит нужные правила.Перейдите в админку WordPress: Внешний вид → Темы. Найдите карточку с названием дочерней темы и нажмите «Активировать».
style.css и functions.php дочерней папки применяются к сайту, а родительская тема остаётся нетронутой.В зависимости от темы и ваших задач используйте один из вариантов.
wp_enqueue_style() (рекомендуемый)Описан в шаге 3. Контролирует порядок загрузки, версии и зависимости. Подходит для 95 % случаев.
@import в CSSБыстрый вариант для простых тем. В начало style.css дочерней темы добавляется строка:
Минус: лишний HTTP-запрос и невозможность управлять порядком через зависимости.
after_setup_themeИспользуется, когда нужно дождаться инициализации темы и добавить стили условно (например, только на определённых страницах).
theme.json. Чтобы переопределить переменные, создайте theme.json в дочерней папке и укажите только изменённые значения. Полное копирование родительского файла не требуется.Главное правило: functions.php дочерней темы не заменяет родительский, а дополняет его. WordPress подключает оба файла. Это значит:
remove_action() / remove_filter() или через механизм pluggable functions (если родитель это предусматривает).Пример удаления родительского действия и добавления своего:
function_exists() вызывает Fatal error: Cannot redeclare function. Всегда оборачивайте в условие или используйте уникальные префиксы.WordPress использует иерархию шаблонов. Если в дочерней теме есть файл с тем же именем, он загружается вместо родительского. Примеры файлов, которые можно переопределить:
| Файл | Что контролирует | Когда переопределять |
|---|---|---|
header.php |
Шапку сайта | Нужно изменить логотип, меню, мета-теги |
footer.php |
Подвал сайта | Добавить счётчики, изменить копирайт |
single.php |
Одиночную запись | Изменить структуру статьи |
page.php |
Статическую страницу | Добавить кастомные блоки |
archive.php |
Страницу архива | Изменить вывод списка записей |
woocommerce.php |
Обёртку WooCommerce | Изменить сетку магазина |
Чтобы переопределить шаблон:
header.php, ваша копия не получит исправление.Template. Опечатка в имени папки родителя → тема не активируется, ошибка «parent theme missing».style.css дочерней темы.functions.php родителя целиком. Приводит к дублированию функций и фатальной ошибке. В дочерний файл добавляйте только свой код.@import вместе с wp_enqueue_style(). Стили загружаются дважды, растёт время отрисовки страницы.theme.json без понимания структуры. В блочных темах некорректный JSON может отключить все стили. Валидируйте файл перед загрузкой./wp-content/themes/style.css содержит поля Theme Name и TemplateTemplate точно совпадает с именем папки родителяfunctions.php начинается с <?php без пробелов до негоwp_enqueue_style()style.css загружается после родительского (зависимость указана)Да, технически достаточно одного style.css с заголовком. Но без functions.php стили родительской темы не подключатся автоматически. Вам придётся использовать @import в CSS, что менее надёжно и добавляет лишний запрос. Рекомендуем создавать оба файла.
В 90 % случаев причина - стили родителя не подключены. Проверьте, что в functions.php вызывается wp_enqueue_style() с путём к родительскому style.css. Также очистите кэш браузера и плагинов кэширования. Если тема блочная (FSE), убедитесь, что theme.json не содержит синтаксических ошибок.
Обновляйте родительскую тему как обычно - через «Внешний вид → Обновления» или автоматически. Дочерняя тема не затрагивается. Единственный риск: если разработчик родителя изменил структуру шаблона, который вы переопределили, проверьте этот файл вручную после обновления.
Да, нужна. Начиная с WordPress 6.1, блочные темы хранят стили в theme.json. Если вы редактируете стили через «Редактор сайта», изменения могут сброситься при обновлении. Дочерняя тема с собственным theme.json позволяет переопределять переменные и блоки безопасно.
Скопируйте папку дочерней темы в /wp-content/themes/ на целевом сайте. Убедитесь, что родительская тема той же версии установлена и активна (или хотя бы присутствует в папке). Активируйте дочернюю тему в админке.
Нет. Дочерняя тема добавляет один дополнительный CSS-файл (иногда functions.php), что увеличивает объём на 1–3 КБ. Это незаметно на фоне общего веса страницы. Если вы используете @import вместо wp_enqueue_style(), появляется лишний HTTP-запрос - поэтому рекомендуется именно wp_enqueue_style().
Частично. Плагины вроде Code Snippets или WPCode позволяют добавлять PHP-код без functions.php. Но переопределение шаблонов и стилей через плагины неудобно и не является стандартной практикой. Для кастомизации темы дочерняя тема остаётся правильным решением.
Дочерняя тема WordPress - это два файла и десять минут работы, которые защищают ваши правки при любом обновлении. Создайте папку, добавьте style.css с заголовком и functions.php с подключением стилей, активируйте тему - и вносите изменения безопасно. Если вы работаете с клиентскими сайтами или поддерживаете собственный проект, дочерняя тема должна быть первым шагом перед любой кастомизацией.
Админка WordPress открывалась до 21 секунды, менеджеры испытывали проблемы с редактированием записей. Нашёл избыточную нагрузку WPML и Toolset, устранил ошибки совместимости PHP и исправил шаблон туров. Подробный разбор диагностики и решения.
Переработана структура каталога интернет-магазина на OcStore 1.5.6.4: карточки товаров получили постоянные URL и стабильные хлебные крошки, старые адреса перенаправляются через 301 Redirect, а отдельные товары теперь можно выводить в плитках категорий вместе с подкатегориями.
Пришлите ссылку на сайт и кратко опишите задачу — я посмотрю и предложу следующий шаг.