Функциональный файл functions.php в теме WordPress

Расширенные примеры кода для functions.php

1. Создание произвольного типа записи (Custom Post Type) и таксономии

// Добавление типа записи 'Книга' с поддержкой категорий
function create_book_post_type() {
    register_post_type( 'book',
        array(
            'labels' => array(
                'name' => __('Книги'),
                'singular_name' => __('Книга')
            ),
            'public' => true,
            'has_archive' => true,
            'supports' => array( 'title', 'editor', 'thumbnail', 'excerpt' ),
            'menu_icon' => 'dashicons-book'
        )
    );

    // Регистрация таксономии 'Жанр'
    register_taxonomy( 'genre', 'book', array(
        'label' => __('Жанры'),
        'rewrite' => array( 'slug' => 'genre' ),
        'hierarchical' => true
    ) );
}
add_action( 'init', 'create_book_post_type' );

Результат: в админ-панели появляется новый пункт меню "Книги" с возможностью создавать записи и назначать им жанры.

// После добавления кода необходимо пересохранить постоянные ссылки (Настройки -> Постоянные ссылки -> Сохранить)

2. Автоматическое подключение стилей родительской темы в дочерней

function child_enqueue_parent_styles() {
    // Сначала подключаем style.css родительской темы
    wp_enqueue_style( 'parent-style', get_template_directory_uri() . '/style.css' );
    // Затем свой style.css (может переопределять стили)
    wp_enqueue_style( 'child-style', get_stylesheet_uri(), array( 'parent-style' ), wp_get_theme()->get('Version') );
}
add_action( 'wp_enqueue_scripts', 'child_enqueue_parent_styles' );

Результат: стили родительской темы загружаются первыми, а дочерние - вторыми, что позволяет аккуратно переопределять CSS-правила.

3. Добавление произвольного поля (метабокса) для записей

function add_custom_meta_box() {
    add_meta_box(
        'my_meta_box',
        'Дополнительная информация',
        'display_my_meta_box',
        'post',
        'side',
        'default'
    );
}
function display_my_meta_box( $post ) {
    $value = get_post_meta( $post->ID, '_my_meta_key', true );
    ?>
    <label for="my_meta_field">Введите текст:</label>
    <input type="text" id="my_meta_field" name="my_meta_field" value="<?php echo esc_attr( $value ); ?>" size="25" />
    <?php
}
function save_my_meta_box_data( $post_id ) {
    if ( defined( 'DOING_AUTOSAVE' ) && DOING_AUTOSAVE ) return;
    if ( ! current_user_can( 'edit_post', $post_id ) ) return;
    if ( isset( $_POST['my_meta_field'] ) ) {
        update_post_meta( $post_id, '_my_meta_key', sanitize_text_field( $_POST['my_meta_field'] ) );
    }
}
add_action( 'add_meta_boxes', 'add_custom_meta_box' );
add_action( 'save_post', 'save_my_meta_box_data' );

Результат: в редакторе записей появляется блок "Дополнительная информация" с текстовым полем. Введённое значение сохраняется в мета-поле _my_meta_key.

4. Использование AJAX в WordPress для неавторизованных и авторизованных пользователей

// Обработчик AJAX-запроса
function my_ajax_handler() {
    $data = sanitize_text_field( $_POST['data'] );
    // Логика обработки
    $response = 'Вы отправили: ' . $data;
    wp_send_json_success( $response );
}

// Зарегистрируем для авторизованных и неавторизованных
add_action( 'wp_ajax_my_action', 'my_ajax_handler' );
add_action( 'wp_ajax_nopriv_my_action', 'my_ajax_handler' );

// JavaScript для отправки запроса (добавить через wp_enqueue_script в functions.php)

// Пример JS-кода (должен быть в отдельном файле)
jQuery(document).ready(function($) {
    $('#my-button').on('click', function() {
        $.post(ajaxurl, {
            action: 'my_action',
            data: 'тест'
        }, function(response) {
            console.log(response.data);
        });
    });
});

Результат: нажатие кнопки отправляет AJAX-запрос, сервер возвращает JSON с полем data.

5. Добавление пользовательского лога для отладки

if ( ! function_exists( 'write_log' ) ) {
    function write_log( $log ) {
        if ( true === WP_DEBUG ) {
            if ( is_array( $log ) || is_object( $log ) ) {
                error_log( print_r( $log, true ) );
            } else {
                error_log( $log );
            }
        }
    }
}

// Пример использования
write_log( 'Пользователь залогинился: ' . $user_login );

Результат: в файл wp-content/debug.log (если включён WP_DEBUG_LOG) записывается отладочная информация.

6. Переопределение частей шаблона через фильтры (для advanced)

function custom_breadcrumb_output( $breadcrumb ) {
    // Добавляем дополнительный элемент в начало
    $home = '<a href="' . home_url() . '">Домой</a>';
    return $home . ' > ' . $breadcrumb;
}
add_filter( 'woocommerce_breadcrumb_defaults', function($defaults) {
    $defaults['delimiter'] = ' > ';
    return $defaults;
});

Результат: хлебные крошки WooCommerce начинаются с ссылки "Домой" и используют разделитель " > ".