Внедрение PHP кода в WordPress: от базовых хуков до продвинутых техник

Подробные примеры реализации PHP-кодов для WordPress

В данном разделе представлены расширенные примеры с полным кодом и демонстрацией результата.

Пример 1. Шорткод для вывода последних записей с произвольным количеством

Создадим шорткод [recent_posts count="5"], который выводит список заголовков последних записей с указанием даты.

// functions.php или плагин
function recent_posts_shortcode($atts) {
    $atts = shortcode_atts(
        array(
            'count' => 5,
        ),
        $atts,
        'recent_posts'
    );
    
    $query = new WP_Query(array(
        'posts_per_page' => intval($atts['count']),
        'post_status' => 'publish',
    ));
    
    $output = '
';
    while ($query->have_posts()) {
        $query->the_post();
        $output .= sprintf(
            '
%s (%s)
',
            get_permalink(),
            get_the_title(),
            get_the_date('j F Y')
        );
    }
    $output .= '
';
    wp_reset_postdata();
    
    return $output;
}
add_shortcode('recent_posts', 'recent_posts_shortcode');

Результат: при вставке [recent_posts count="3"] в текст записи отобразится неупорядоченный список из трёх последних записей с заголовками-ссылками и датами в формате "1 января 2025".

  
Заголовок записи 1 (15 марта 2025)
  
Заголовок записи 2 (14 марта 2025)
  
Заголовок записи 3 (13 марта 2025)

Пояснение: Функция shortcode_atts устанавливает значение по умолчанию для атрибута count. Затем создаётся новый запрос WP_Query с указанным количеством. Цикл while проходит по результатам, формируя HTML. После цикла сбрасываются глобальные данные записи через wp_reset_postdata(), чтобы не повлиять на другие запросы на странице.

Пример 2. Фильтрация содержимого записи: добавление ссылки на источник

Добавим фильтр the_content, который после каждого абзаца вставляет ссылку на внешний источник (например, для копирайтинга).

function add_source_link($content) {
    if (is_single() && in_the_loop() && is_main_query()) {
        $source_url = get_post_meta(get_the_ID(), 'source_url', true);
        if ($source_url) {
            $content .= '
Источник: ' . esc_html($source_url) . '
';
        }
    }
    return $content;
}
add_filter('the_content', 'add_source_link');

Результат: Если у записи есть мета-поле source_url, то после основного содержимого появится абзац со ссылкой. Текст ссылки - это сам URL. Если поле не заполнено, ничего не добавляется.

Основной текст записи...
Источник: https://example.com/source

Пояснение: Условие is_single() && in_the_loop() && is_main_query() гарантирует, что фильтр применяется только в основном цикле на странице отдельной записи, чтобы избежать дублирования в других местах. Мета-поле извлекается с помощью get_post_meta, а данные экранируются через esc_url и esc_html.

Пример 3. AJAX-загрузка дополнительных записей при нажатии кнопки

Реализация "Load More" с помощью JavaScript и WordPress AJAX API. Этот пример позволяет загружать следующие записи без перезагрузки страницы.

Код в файле functions.php или плагине:

// Регистрация скрипта и локальных данных
function enqueue_loadmore_scripts() {
    wp_enqueue_script('loadmore', get_stylesheet_directory_uri() . '/js/loadmore.js', array('jquery'), '1.0', true);
    wp_localize_script('loadmore', 'loadmore_params', array(
        'ajaxurl' => admin_url('admin-ajax.php'),
        'posts_per_page' => 3,
        'initial_offset' => 0,
    ));
}
add_action('wp_enqueue_scripts', 'enqueue_loadmore_scripts');

// Обработчик AJAX
function loadmore_posts() {
    $offset = isset($_POST['offset']) ? intval($_POST['offset']) : 0;
    $posts_per_page = isset($_POST['posts_per_page']) ? intval($_POST['posts_per_page']) : 3;
    
    $query = new WP_Query(array(
        'posts_per_page' => $posts_per_page,
        'offset' => $offset,
        'post_status' => 'publish',
    ));
    
    if ($query->have_posts()) {
        while ($query->have_posts()) {
            $query->the_post();
            get_template_part('template-parts/content', get_post_format());
        }
        wp_reset_postdata();
    }
    wp_die(); // обязательно
}
add_action('wp_ajax_loadmore_posts', 'loadmore_posts');
add_action('wp_ajax_nopriv_loadmore_posts', 'loadmore_posts');

Код JavaScript (loadmore.js):

jQuery(function($) {
    var offset = loadmore_params.initial_offset;
    var postsPerPage = loadmore_params.posts_per_page;
    var container = $('#posts-container');
    var loadMoreBtn = $('#load-more-btn');

    loadMoreBtn.on('click', function() {
        loadMoreBtn.text('Загрузка...').prop('disabled', true);
        $.post(loadmore_params.ajaxurl, {
            action: 'loadmore_posts',
            offset: offset,
            posts_per_page: postsPerPage
        }, function(response) {
            if (response.trim()) {
                container.append(response);
                offset += postsPerPage;
                loadMoreBtn.text('Загрузить ещё').prop('disabled', false);
            } else {
                loadMoreBtn.text('Все записи загружены').prop('disabled', true);
            }
        });
    });
});

Результат: На странице имеется контейнер #posts-container для выводa начальных записей и кнопка "Загрузить ещё". При нажатии на кнопку в контейнер добавляются новые записи, а смещение увеличивается. Когда записи кончаются, кнопка блокируется и текст меняется.

Пояснение: Важно использовать wp_die() в конце обработчика для завершения выполнения. Также необходимо создать шаблон части (например, template-parts/content.php) для вывода каждой записи. Безопасность: nonce в данном примере опущен для краткости, на реальном сайте следует добавить проверку nonce через check_ajax_referer().

Пример 4. Добавление кастомного REST API эндпоинта

Создадим свой маршрут для API, который возвращает список записей в определённой категории. Это полезно для внешних приложений или одностраничных приложений.

function register_custom_rest_route() {
    register_rest_route('myplugin/v1', '/posts-by-category/(?P\d+)', array(
        'methods' => 'GET',
        'callback' => 'get_posts_by_category',
        'args' => array(
            'category_id' => array(
                'required' => true,
                'validate_callback' => function($param) {
                    return is_numeric($param) && (int)$param > 0;
                }
            ),
        ),
        'permission_callback' => '__return_true', // упрощённо
    ));
}
add_action('rest_api_init', 'register_custom_rest_route');

function get_posts_by_category($request) {
    $category_id = (int)$request['category_id'];
    $posts = get_posts(array(
        'category' => $category_id,
        'posts_per_page' => 10,
    ));
    
    $data = array();
    foreach ($posts as $post) {
        $data[] = array(
            'id' => $post->ID,
            'title' => $post->post_title,
            'link' => get_permalink($post->ID),
            'excerpt' => get_the_excerpt($post),
        );
    }
    
    return new WP_REST_Response($data, 200);
}

Результат: При обращении к /wp-json/myplugin/v1/posts-by-category/5 (где 5 - ID категории) возвращается JSON с массивом записей.

[
  {
    "id": 123,
    "title": "Заголовок первой записи",
    "link": "https://example.com/...",
    "excerpt": "Отрывок первой записи..."
  },
  {
    "id": 124,
    "title": "Вторая запись",
    "link": "https://example.com/...",
    "excerpt": "Отрывок второй..."
  }
]

Пояснение: Маршрут определяется с помощью register_rest_route. Параметр category_id передаётся в URL. Функция обратного вызова получает параметры и формирует ответ. Для валидации используется validate_callback. При реальном использовании стоит добавить проверку прав доступа (permission_callback), например, с помощью current_user_can().

Пример 5. Оптимизация запросов с помощью транзиентов

Транзиенты позволяют кэшировать результаты тяжёлых запросов на определённое время. Покажем пример кэширования списка популярных записей на 1 час.

function get_popular_posts_cache($count = 5) {
    $cache_key = 'popular_posts_' . $count;
    $cached = get_transient($cache_key);
    
    if (false !== $cached) {
        return $cached;
    }
    
    $popular = new WP_Query(array(
        'posts_per_page' => $count,
        'meta_key' => 'post_views_count',
        'orderby' => 'meta_value_num',
        'order' => 'DESC',
        'post_status' => 'publish',
    ));
    
    $posts_data = array();
    if ($popular->have_posts()) {
        while ($popular->have_posts()) {
            $popular->the_post();
            $posts_data[] = array(
                'title' => get_the_title(),
                'link' => get_permalink(),
            );
        }
        wp_reset_postdata();
    }
    
    set_transient($cache_key, $posts_data, HOUR_IN_SECONDS);
    return $posts_data;
}

Результат: Функция возвращает массив данных о популярных записях. При первом вызове выполняется запрос к БД, результат сохраняется в транзиент на 1 час. Последующие вызовы в течение часа берут данные из кэша, не нагружая базу данных. Пример использования в шаблоне:

$popular = get_popular_posts_cache(5);
foreach ($popular as $item) {
    echo '
' . $item['title'] . '
';
}

Пояснение: get_transient возвращает сохранённое значение или false, если кэш истёк или отсутствует. set_transient сохраняет данные с временем жизни (в секундах). Константа HOUR_IN_SECONDS равна 3600. Для сброса кэша при добавлении новой записи можно вызвать delete_transient($cache_key) в хуке wp_insert_post.