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

/wp-content/themes/
├── twentytwentyfour/        (родительская тема)
└── twentytwentyfour-child/  (создайте эту папку)

/*
Theme Name:   Двадцать Двадцать Четыре — Дочерняя
Theme URI:    https://example.com/
Description:  Дочерняя тема для Twenty Twenty-Four
Author:       Ваше Имя
Author URI:   https://example.com/
Template:     twentytwentyfour
Version:      1.0.0
License:      GNU General Public License v2 or later
License URI:  http://www.gnu.org/licenses/gpl-2.0.html
Text Domain:  twentytwentyfour-child
*/

<?php /**
 * Подключение родительских стилей и скриптов
 */
function child_theme_enqueue_styles() { // Подключаем родительский style.css wp_enqueue_style( 'parent-style', get_template_directory_uri() . '/style.css' ); // Подключаем дочерний style.css (если есть свои стили) wp_enqueue_style( 'child-style', get_stylesheet_directory_uri() . '/style.css', array('parent-style'), wp_get_theme()->get('Version') ); } add_action('wp_enqueue_scripts', 'child_theme_enqueue_styles');

Внешний вид → Темы → Найдите вашу дочернюю тему → Активировать

Плагины → Добавить новый → Child Theme Configurator → Активировать

Инструменты → Child Theme Configurator → Выбрать родительскую тему
→ Настроить параметры → Создать дочернюю тему

twentytwentyfour-child/
├── style.css           (обязательный файл с заголовком)
├── functions.php       (рекомендуется для подключения стилей)
├── screenshot.png      (опционально, скриншот темы 1200x900)
├── header.php          (переопределяет header.php родителя)
├── footer.php          (переопределяет footer.php родителя)
├── single.php          (переопределяет шаблон записи)
└── template-parts/     (папка может содержать любые файлы)

// Родительская тема: /twentytwentyfour/header.php // Копируем в: /twentytwentyfour-child/header.php // Редактируем копию — изменения сохранятся после обновления

/* Изменение цвета заголовков */ h1, h2, h3, h4, h5, h6 { color: #2c3e50; } /* Изменение ширины контента */ .site-content { max-width: 1200px; margin: 0 auto; } /* Кастомный дизайн кнопок */ .button, button, input[type="submit"] { background-color: #3498db; border-radius: 30px; padding: 12px 24px; }

// В functions.php дочерней темы function child_theme_custom_styles() { wp_enqueue_style( 'child-custom', get_stylesheet_directory_uri() . '/css/custom.css', array(), '1.0.0' ); } add_action('wp_enqueue_scripts', 'child_theme_custom_styles', 20);

// В functions.php дочерней темы function child_theme_enqueue_scripts() { wp_enqueue_script( 'child-custom-js', get_stylesheet_directory_uri() . '/js/custom.js', array('jquery'), '1.0.0', true ); // Передача данных из PHP в JS wp_localize_script('child-custom-js', 'child_theme_ajax', array( 'ajax_url' => admin_url('admin-ajax.php'), 'nonce' => wp_create_nonce('child_theme_nonce') )); } add_action('wp_enqueue_scripts', 'child_theme_enqueue_scripts');

// В functions.php дочерней темы // 1. Добавление поддержки новых функций function child_theme_setup() { // Добавление поддержки логотипа add_theme_support('custom-logo', array( 'height' => 100, 'width' => 400, 'flex-height' => true, 'flex-width' => true, )); // Добавление поддержки широких изображений add_theme_support('align-wide'); // Добавление поддержки HTML5 add_theme_support('html5', array( 'search-form', 'comment-form', 'comment-list', 'gallery', 'caption', )); } add_action('after_setup_theme', 'child_theme_setup'); // 2. Изменение длины отрывка function child_theme_excerpt_length($length) { return 30; // 30 слов вместо стандартных 55 } add_filter('excerpt_length', 'child_theme_excerpt_length'); // 3. Добавление класса к тегу body function child_theme_body_class($classes) { if (is_single()) { $classes[] = 'single-post-custom'; } if (is_front_page()) { $classes[] = 'homepage-custom'; } return $classes; } add_filter('body_class', 'child_theme_body_class'); // 4. Удаление функций родительской темы function child_theme_remove_parent_functions() { remove_action('wp_head', 'parent_theme_add_meta_tags'); remove_filter('the_content', 'parent_theme_add_share_buttons'); } add_action('init', 'child_theme_remove_parent_functions');

// Если нужно вызвать функцию родительской темы из дочерней function child_theme_custom_function() { // Сначала выполнить родительскую функцию if (function_exists('parent_theme_function')) { parent_theme_function(); } // Затем добавить свою логику echo '<div class="custom-content">Дополнительный контент</div>'; }

// Родительская тема: if (!function_exists('parent_theme_header_logo')) { function parent_theme_header_logo() { // код } } // Дочерняя тема (переопределяет): function parent_theme_header_logo() { // Ваш кастомный код echo '<div class="custom-logo">'; the_custom_logo(); echo '</div>'; }

// Добавление контента перед контентом страницы function child_theme_add_before_content() { echo '<div class="before-content">Добро пожаловать!</div>'; } add_action('parent_theme_before_content', 'child_theme_add_before_content'); // Добавление виджета в футер function child_theme_add_footer_widget() { if (is_active_sidebar('footer-custom')) { dynamic_sidebar('footer-custom'); } } add_action('parent_theme_footer', 'child_theme_add_footer_widget');

<?php /**
 * Template Name: Кастомный шаблон страницы
 * Description: Шаблон с нестандартным отображением
 */

get_header(); ?> <div class="custom-template"> <div class="custom-header"> <h1><?php the_title(); ?></h1> </div> <div class="custom-content"> <?php while (have_posts()) : the_post(); ?> <div class="entry-content"> <?php the_content(); ?> </div> <?php endwhile; ?> </div> <div class="custom-sidebar"> <?php if (is_active_sidebar('custom-template-sidebar')) : ?> <?php dynamic_sidebar('custom-template-sidebar'); ?> <?php endif; ?> </div> </div> <?php get_footer(); ?>

// В functions.php дочерней темы function child_theme_widgets_init() { register_sidebar(array( 'name' => 'Кастомная область шаблона', 'id' => 'custom-template-sidebar', 'before_widget' => '<div class="custom-widget">', 'after_widget' => '</div>', 'before_title' => '<h3 class="widget-title">', 'after_title' => '</h3>', )); } add_action('widgets_init', 'child_theme_widgets_init');

// Добавление опции в кастомайзер function child_theme_customize_register($wp_customize) { $wp_customize->add_section('child_theme_section', array( 'title' => 'Дополнительные настройки', 'priority' => 30, )); $wp_customize->add_setting('child_theme_text', array( 'default' => 'Текст по умолчанию', 'sanitize_callback' => 'sanitize_text_field', )); $wp_customize->add_control('child_theme_text', array( 'label' => 'Дополнительный текст', 'section' => 'child_theme_section', 'type' => 'text', )); } add_action('customize_register', 'child_theme_customize_register'); // Вывод опции в шаблоне function child_theme_display_text() { $text = get_theme_mod('child_theme_text', 'Текст по умолчанию'); echo '<div class="custom-text">' . esc_html($text) . '</div>'; }

define('WP_DEBUG', true); define('WP_DEBUG_LOG', true); define('WP_DEBUG_DISPLAY', false);

{ "name": "yourname/child-theme", "description": "Дочерняя тема для WordPress", "type": "wordpress-theme", "require": { "composer/installers": "^1.0" } }

// В functions.php дочерней темы function child_theme_gutenberg_support() { // Добавление кастомных цветов add_theme_support('editor-color-palette', array( array( 'name' => 'Основной', 'slug' => 'primary', 'color' => '#3498db', ), array( 'name' => 'Вторичный', 'slug' => 'secondary', 'color' => '#2ecc71', ), )); // Добавление кастомных размеров шрифтов add_theme_support('editor-font-sizes', array( array( 'name' => 'Маленький', 'size' => 12, 'slug' => 'small', ), array( 'name' => 'Нормальный', 'size' => 16, 'slug' => 'normal', ), array( 'name' => 'Большой', 'size' => 20, 'slug' => 'large', ), )); } add_action('after_setup_theme', 'child_theme_gutenberg_support');

// Регистрация кастомного блока function child_theme_register_blocks() { wp_register_script( 'child-theme-block', get_stylesheet_directory_uri() . '/blocks/custom-block.js', array('wp-blocks', 'wp-element', 'wp-editor'), '1.0.0' ); register_block_type('child-theme/custom-block', array( 'editor_script' => 'child-theme-block', )); } add_action('init', 'child_theme_register_blocks');

# Экспорт настроек кастомайзера через WP-CLI
wp option get theme_mods_twentytwentyfour-child > theme-mods.json

# Импорт
wp option set theme_mods_twentytwentyfour-child "$(cat theme-mods.json)"