WPSource

Как создать дочернюю тему WordPress и не потерять изменения

Если вы меняете файлы темы WordPress напрямую, обновление может заменить их исходными версиями. Дочерняя тема решает эту проблему: WordPress продолжает использовать родительскую тему, но ваши стили, отдельные шаблоны и код хранятся в самостоятельной папке.

Обновление родительской темы не удалит файлы дочерней. Однако скопированный в неё шаблон не обновится автоматически вместе с оригиналом — это важно учитывать при дальнейшей поддержке сайта.

Что подготовить перед созданием дочерней темы

Сначала убедитесь, что родительская тема установлена и сайт работает на ней. Создайте резервную копию файлов и базы данных, а изменения проверяйте на тестовой копии сайта или в период низкой нагрузки. Ошибка в PHP-файле активной темы может привести к критической ошибке на сайте.

Найдите точное имя папки родительской темы в wp-content/themes/. Оно понадобится в заголовке дочерней темы. Например, если родительская тема находится в wp-content/themes/example-theme/, значение Template будет example-theme. Это имя папки, а не обязательно название темы, которое видно в админке.

Создайте папку и файл style.css

Внутри wp-content/themes/ создайте отдельную папку для дочерней темы, например example-theme-child. В ней создайте файл style.css с заголовком темы. Замените значение Template на фактическое имя папки родительской темы:

<?php /* Этот текст не является PHP-кодом и не должен начинаться с PHP-тега. */ ?>

В заголовке CSS-файла не нужны PHP-теги. Используйте такой текст:

/*
Theme Name: Example Theme Child
Template: example-theme
Version: 1.0.0
*/

Удалите первую строку с PHP-тегами, если скопировали весь предыдущий блок: она приведена лишь как пояснение и не относится к содержимому style.css. Сам файл должен начинаться с комментария /*. Обязательные поля для распознавания дочерней темы — Theme Name и Template. Значение версии можно менять при выпуске собственных обновлений темы.

В этот же файл добавляйте свои CSS-правила. Не переносите туда содержимое родительского style.css: оно должно оставаться в родительской теме и подключаться отдельно.

Подключите стили родительской и дочерней темы

Создайте в папке дочерней темы файл functions.php. В простом случае, когда родительский CSS находится в корневом style.css и не подключается самим родителем под другим способом, добавьте в него код ниже:

<?php
function example_child_enqueue_styles() {
    wp_enqueue_style(
        'example-parent-style',
        get_template_directory_uri() . '/style.css'
    );

    wp_enqueue_style(
        'example-child-style',
        get_stylesheet_uri(),
        array('example-parent-style'),
        wp_get_theme()->get('Version')
    );
}
add_action('wp_enqueue_scripts', 'example_child_enqueue_styles', 20);

get_template_directory_uri() возвращает адрес файлов родительской темы, а get_stylesheet_uri() — адрес style.css активной, то есть дочерней, темы. Зависимость указывает WordPress загрузить дочерний CSS после родительского. Указанный код рассчитан на обычную тему с таблицей стилей в корне.

У многих тем родительские стили уже подключаются через functions.php, могут состоять из нескольких файлов или использовать собственный идентификатор стиля. Проверьте файлы темы и документацию разработчика, прежде чем вставлять пример без изменений. Если родительский CSS уже подключается, повторное подключение может загрузить его дважды. В таком случае не добавляйте второй вызов для родительского файла: подключите дочерний стиль с зависимостью от фактического идентификатора стиля родителя. Если не знаете этот идентификатор, его можно найти в вызове wp_enqueue_style() родительской темы. Не угадывайте его — неверная зависимость может нарушить порядок загрузки.

Не копируйте родительский functions.php в дочернюю тему. WordPress загружает функции обеих тем, а повторное объявление функций родителя может вызвать критическую ошибку. Добавляйте собственный код отдельными функциями и, когда нужно изменить поведение родителя, используйте его хуки и фильтры.

Активируйте тему и убедитесь, что сайт работает

После создания файлов откройте в админке Внешний вид → Темы. Дочерняя тема должна появиться в списке. Активируйте её, затем проверьте главную страницу, записи, страницы и меню. Убедитесь, что стили родителя сохранились, а правило из дочернего style.css применяется. Для проверки можно временно добавить заметное CSS-правило, например изменить цвет заголовка, а после проверки удалить его.

Если тема не отображается, проверьте, что style.css лежит именно в папке дочерней темы, в нём есть корректные заголовки, а Template точно совпадает с именем папки родителя. Если тема активируется, но внешний вид меняется, проверьте подключение родительских стилей и ошибки в консоли браузера. После правок очистите кэш плагина, сервера или CDN, если они используются.

Переключение с родительской темы на дочернюю для WordPress считается сменой активной темы. Поэтому проверьте настройки, зависящие от конкретной темы: расположение меню, виджеты, настройки внешнего вида и другие параметры. При необходимости настройте их заново. Не удаляйте родительскую тему: дочерняя использует её файлы и без неё работать не сможет.

Перенесите существующие доработки правильно

CSS-правила переносите в style.css дочерней темы. Если вы меняли PHP-шаблон родителя, скопируйте только нужный файл в дочернюю тему, сохранив относительный путь. Например, для родительского файла wp-content/themes/example-theme/header.php путь в дочерней теме будет wp-content/themes/example-theme-child/header.php. WordPress будет использовать дочерний шаблон вместо одноимённого родительского.

Не копируйте шаблоны без необходимости. Пока файл находится только в родительской теме, обновления темы могут исправлять его; после копирования WordPress будет использовать вашу версию, и изменения оригинала перестанут попадать на сайт. Если проблема решается CSS, настройкой темы или доступным хуком, такой вариант обычно проще сопровождать.

Для блочной темы принцип наследования тоже применим, но структура файлов отличается. Шаблоны и их части обычно находятся в каталогах templates и parts; файл theme.json дочерней темы используют для собственных настроек редактора и стилей. Копируйте только те шаблоны и части, которые действительно нужно изменить: скопированные версии также не получат исправления родителя автоматически.

Как обновлять родительскую тему после переноса изменений

Когда выходит обновление родительской темы, устанавливайте его обычным способом: файлы дочерней темы при этом не заменяются. После обновления проверьте сайт и посмотрите, менялись ли файлы родителя, которые вы скопировали. Если менялись, сравните новую версию с копией в дочерней теме и вручную перенесите необходимые исправления. Иначе старая копия может сохранить ваши доработки, но одновременно не получить исправления ошибок или совместимости.

Перед переносом правок сделайте резервную копию и сравнивайте файлы по одному, а не заменяйте дочерние шаблоны новыми без проверки: так легко случайно потерять собственные изменения. Храните список файлов, которые переопределены, и кратко записывайте, зачем каждый из них понадобился. Это упростит проверку после следующих обновлений и поможет не поддерживать лишние копии.

×
Дай суперсилу своему сайту!

WordPress

-20% на топовые темы и плагины

Создай сайт своей мечты ⋙