Как создать собственное событие для AJAX в WordPress с примерами кода

Автор: София Соколова | Опубликовано: 16.01.2026

AJAX — это мощный инструмент, который позволяет создавать динамичные и отзывчивые интерфейсы в WordPress без перезагрузки страницы. В этой статье мы разберём, как создать собственное событие для AJAX в WordPress, чтобы обрабатывать запросы пользователя и возвращать данные асинхронно. Это полезно при разработке интерактивных плагинов, кастомных форм, фильтров и многого другого.

Что такое AJAX-событие в WordPress и зачем оно нужно

AJAX-событие — это обработчик на серверной стороне, который принимает запросы через JavaScript и возвращает ответ без перезагрузки страницы. WordPress имеет собственный механизм для работы с AJAX, подключённый через файл admin-ajax.php, который позволяет создавать свои действия для авторизованных и неавторизованных пользователей.

Основная причина использования собственных AJAX-событий — улучшение UX и возможность обновлять части страницы динамически. Например, можно реализовать фильтры товаров, отправку форм, лайки, голосования и многое другое.

Как зарегистрировать собственное AJAX-событие в WordPress

Для начала нужно зарегистрировать обработчики для двух типов пользователей: авторизованных и гостей (если нужно). Для этого используются хуки wp_ajax_ и wp_ajax_nopriv_ с добавлением суффикса — названия вашего действия.

Пример регистрации AJAX-обработчика

add_action('wp_ajax_wp_host_custom_action', 'wp_host_ajax_custom_action_handler');
add_action('wp_ajax_nopriv_wp_host_custom_action', 'wp_host_ajax_custom_action_handler');

function wp_host_ajax_custom_action_handler() {
    // Проверка nonce для безопасности
    check_ajax_referer('wp_host_nonce', 'security');

    $param = isset($_POST['param']) ? sanitize_text_field($_POST['param']) : '';

    // Логика обработки запроса
    $response = array('message' => 'Получено значение: ' . $param);

    // Возвращаем JSON
    wp_send_json_success($response);
}

Здесь мы добавили два обработчика — для авторизованных пользователей и для гостей. Функция wp_host_ajax_custom_action_handler проверяет nonce для безопасности, получает параметр из запроса, обрабатывает его и возвращает JSON с результатом.

Как отправить AJAX-запрос с фронтенда

Для вызова нашего события нужно использовать JavaScript, обычно jQuery или чистый JS с использованием fetch. Важно передать параметр action с названием события и nonce для безопасности.

Пример на jQuery

jQuery(document).ready(function($) {
    $('#my-button').on('click', function() {
        $.ajax({
            url: wp_host_ajax_object.ajax_url,
            type: 'POST',
            data: {
                action: 'wp_host_custom_action',
                security: wp_host_ajax_object.nonce,
                param: 'тестовое значение'
            },
            success: function(response) {
                if(response.success) {
                    alert(response.data.message);
                } else {
                    alert('Ошибка в ответе');
                }
            },
            error: function() {
                alert('Ошибка AJAX запроса');
            }
        });
    });
});

Обратите внимание, что wp_host_ajax_object — это объект, который мы должны передать из PHP для удобства работы с URL и nonce.

Как локализовать скрипт и передать ajax_url и nonce

function wp_host_enqueue_scripts() {
    wp_enqueue_script('wp-host-ajax-script', get_template_directory_uri() . '/js/wp-host-ajax.js', array('jquery'), '1.0', true);

    wp_localize_script('wp-host-ajax-script', 'wp_host_ajax_object', array(
        'ajax_url' => admin_url('admin-ajax.php'),
        'nonce'    => wp_create_nonce('wp_host_nonce')
    ));
}
add_action('wp_enqueue_scripts', 'wp_host_enqueue_scripts');

Так мы передаём в JS необходимые параметры для AJAX-запроса.

Пример плагина с собственным AJAX-событием

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

/*
Plugin Name: WP-Host Custom AJAX Example
Description: Пример плагина с собственным AJAX-событием.
Version: 1.0
Author: WP-Host
*/

add_action('wp_enqueue_scripts', 'wp_host_enqueue_scripts');

function wp_host_enqueue_scripts() {
    wp_enqueue_script('wp-host-ajax-script', plugin_dir_url(__FILE__) . 'wp-host-ajax.js', array('jquery'), '1.0', true);

    wp_localize_script('wp-host-ajax-script', 'wp_host_ajax_object', array(
        'ajax_url' => admin_url('admin-ajax.php'),
        'nonce'    => wp_create_nonce('wp_host_nonce')
    ));
}

add_action('wp_ajax_wp_host_custom_action', 'wp_host_ajax_custom_action_handler');
add_action('wp_ajax_nopriv_wp_host_custom_action', 'wp_host_ajax_custom_action_handler');

function wp_host_ajax_custom_action_handler() {
    check_ajax_referer('wp_host_nonce', 'security');

    $param = isset($_POST['param']) ? sanitize_text_field($_POST['param']) : '';

    wp_send_json_success(array('message' => 'Данные успешно получены: ' . $param));
}

// Короткий код для вывода кнопки
add_shortcode('wp_host_ajax_button', function() {
    return '<button id="my-button">Отправить AJAX запрос</button>';
});

JS-файл wp-host-ajax.js из предыдущего примера подключается и обрабатывает клик по кнопке.

Советы по безопасности и производительности при работе с AJAX в WordPress

1. Всегда используйте check_ajax_referer для проверки nonce — это защитит от CSRF-атак.

2. Санитизируйте и валидируйте все входящие данные — используйте функции sanitize_text_field, intval и т.п.

3. Возвращайте данные в формате JSON через функции wp_send_json_success и wp_send_json_error — это упрощает обработку на клиенте.

4. Если AJAX-событие не должно быть доступно гостям, не регистрируйте обработчик с wp_ajax_nopriv_.

5. Минимизируйте количество данных, передаваемых в AJAX, чтобы не перегружать сеть и сервер.

Альтернативные плагины для расширенной работы с AJAX в WordPress

Если вы хотите использовать готовые решения для AJAX, рассмотрите плагины:

Clearfy Pro — включает оптимизацию и улучшения для AJAX-запросов и безопасности.
WPRemark — удобный плагин для AJAX-комментариев и интерактивности.
My Popup — реализует динамические всплывающие окна с AJAX.

Использование этих плагинов может значительно упростить реализацию сложных AJAX-функций без глубокого погружения в код.

Итог

Создание собственных AJAX-событий в WordPress — доступная и мощная техника для повышения интерактивности сайта. Правильная регистрация обработчиков, защита nonce, корректная обработка данных и возврат JSON — ключевые моменты. Приведённые примеры помогут быстро начать работу и интегрировать AJAX в ваши проекты.