Как эффективно использовать functions.php в разработке тем

Расширенные примеры и нестандартные сценарии

Ниже приведены более сложные примеры использования functions.php, включающие работу с REST API, кешированием и объектно-ориентированным подходом.

Создание шорткода с атрибутами и кешированием

// Шорткод [latest_posts count="5" category="news"]
function latest_posts_shortcode( $atts ) {
    $atts = shortcode_atts( array(
        'count' => 3,
        'category' => ''
    ), $atts );
    
    $cache_key = 'latest_posts_' . md5( serialize( $atts ) );
    $output = get_transient( $cache_key );
    if ( false === $output ) {
        $args = array(
            'posts_per_page' => intval( $atts['count'] ),
            'category_name' => sanitize_title( $atts['category'] )
        );
        $query = new WP_Query( $args );
        $output = '<ul>';
        while ( $query->have_posts() ) {
            $query->the_post();
            $output .= '<li><a href="' . get_permalink() . '">' . get_the_title() . '</a></li>';
        }
        $output .= '</ul>';
        wp_reset_postdata();
        set_transient( $cache_key, $output, HOUR_IN_SECONDS );
    }
    return $output;
}
add_shortcode( 'latest_posts', 'latest_posts_shortcode' );

Результат: выводит список последних записей из указанной категории (или всех) в виде ненумерованного списка. При повторном вызове в течение часа данные берутся из Transients API, что снижает нагрузку на базу данных.

Добавление кастомной конечной точки REST API

function custom_rest_endpoint() {
    register_rest_route( 'myplugin/v1', '/data/', array(
        'methods' => 'GET',
        'callback' => 'handle_custom_data',
        'permission_callback' => function() { return current_user_can( 'manage_options' ); }
    ) );
}
add_action( 'rest_api_init', 'custom_rest_endpoint' );

function handle_custom_data( $request ) {
    $param = $request->get_param( 'id' );
    // логика получения данных
    return array( 'status' => 'ok', 'id' => $param );
}

Результат: по URL /wp-json/myplugin/v1/data?id=5 авторизованный пользователь получает JSON-ответ с переданным id.

Использование классов для организации кода

class ThemeCustomizer {
    public function __construct() {
        add_action( 'customize_register', array( $this, 'register_settings' ) );
        add_action( 'wp_head', array( $this, 'output_custom_css' ) );
    }
    
    public function register_settings( $wp_customize ) {
        $wp_customize->add_section( 'theme_colors', array(
            'title' => 'Цветовые настройки'
        ) );
        $wp_customize->add_setting( 'primary_color', array(
            'default' => '#0073aa',
            'sanitize_callback' => 'sanitize_hex_color'
        ) );
        $wp_customize->add_control( new WP_Customize_Color_Control( $wp_customize, 'primary_color', array(
            'label' => 'Основной цвет',
            'section' => 'theme_colors'
        ) ) );
    }
    
    public function output_custom_css() {
        $color = get_theme_mod( 'primary_color', '#0073aa' );
        echo '<style>.primary-btn { background-color: ' . esc_attr( $color ) . '; }</style>';
    }
}
new ThemeCustomizer();

Результат: в разделе «Настройки темы» появляется секция для выбора основного цвета, а во фронтенде кнопки с классом primary-btn получают заданный цвет фона.

Условное подключение скриптов только на определённых страницах

function conditional_scripts() {
    if ( is_page( 'contact' ) ) {
        wp_enqueue_script( 'contact-form-js', get_template_directory_uri() . '/js/contact.js', array(), '1.0', true );
    }
    if ( is_single() && has_category( 'video' ) ) {
        wp_enqueue_style( 'video-style', get_template_directory_uri() . '/css/video.css' );
    }
}
add_action( 'wp_enqueue_scripts', 'conditional_scripts' );

Результат: скрипт contact.js загружается только на странице «Контакты», а стили video.css - только на страницах отдельных записей из категории «video».