Прием и обработка POST в WordPress на PHP

Расширенные примеры обработки POST в админке WordPress

Пример 1: Полная страница настроек с несколькими секциями и обработкой ошибок

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

// Регистрация страницы настроек
add_action('admin_menu', function() {
    add_options_page('Супер настройки', 'Супер настройки', 'manage_options', 'super-settings', 'render_super_settings_page');
});

// Обработчик POST через admin_post (не через Settings API, чтобы показать ручной контроль)
add_action('admin_post_save_super_settings', function() {
    if (!isset($_POST['_wpnonce']) || !wp_verify_nonce($_POST['_wpnonce'], 'super_settings_nonce')) {
        wp_die('Ошибка проверки подлинности');
    }
    if (!current_user_can('manage_options')) {
        wp_die('Недостаточно прав');
    }

    $errors = array();
    $email = sanitize_email($_POST['admin_email']);
    if (!is_email($email)) {
        $errors[] = 'Некорректный email';
    }
    $number = intval($_POST['items_per_page']);
    if ($number < 1 || $number > 100) {
        $errors[] = 'Число должно быть от 1 до 100';
    }

    if (!empty($errors)) {
        set_transient('super_settings_errors', $errors, 30);
        wp_redirect(add_query_arg('error', '1', wp_get_referer()));
        exit;
    }

    update_option('admin_email', $email);
    update_option('items_per_page', $number);

    wp_redirect(add_query_arg('message', 'saved', wp_get_referer()));
    exit;
});

function render_super_settings_page() {
    ?>
    <div class="wrap">
        <h1>Супер настройки</h1>
        <?php
        if (isset($_GET['error'])) {
            $errors = get_transient('super_settings_errors');
            if ($errors) {
                echo '<div class="error"><ul>';
                foreach ($errors as $e) {
                    echo '<li>' . esc_html($e) . '</li>';
                }
                echo '</ul></div>';
                delete_transient('super_settings_errors');
            }
        }
        if (isset($_GET['message']) && $_GET['message'] == 'saved') {
            echo '<div class="updated"><p>Настройки сохранены.</p></div>';
        }
        ?>
        <form method="post" action="<?php echo admin_url('admin-post.php'); ?>">
            <?php wp_nonce_field('super_settings_nonce'); ?>
            <input type="hidden" name="action" value="save_super_settings">
            <table class="form-table">
                <tr>
                    <th><label for="admin_email">Email админа</label></th>
                    <td><input type="email" name="admin_email" id="admin_email" value="<?php echo esc_attr(get_option('admin_email')); ?>" class="regular-text"></td>
                </tr>
                <tr>
                    <th><label for="items_per_page">Элементов на странице</label></th>
                    <td><input type="number" name="items_per_page" id="items_per_page" value="<?php echo esc_attr(get_option('items_per_page', 10)); ?>" min="1" max="100"></td>
                </tr>
            </table>
            <?php submit_button('Сохранить настройки'); ?>
        </form>
    </div>
    <?php
}

Результат: страница настроек с валидацией, выводом ошибок и сообщением об успешном сохранении.

Пример 2: AJAX загрузка файла через POST с проверкой

Загрузка файла в админке без перезагрузки страницы. Используется wp_ajax и встроенная функция wp_handle_upload.

// Обработчик AJAX
add_action('wp_ajax_upload_custom_file', function() {
    check_ajax_referer('upload_file_nonce', 'nonce');
    if (!current_user_can('upload_files')) {
        wp_send_json_error('Нет прав на загрузку файлов');
    }

    if (empty($_FILES['custom_file'])) {
        wp_send_json_error('Файл не передан');
    }

    $uploaded = wp_handle_upload($_FILES['custom_file'], array('test_form' => false));
    if (isset($uploaded['error'])) {
        wp_send_json_error($uploaded['error']);
    }

    // Сохраняем URL в опцию
    update_option('custom_uploaded_file', $uploaded['url']);
    wp_send_json_success(array('url' => $uploaded['url'], 'file' => $uploaded['file']));
});

// JavaScript на странице админки
jQuery(document).ready(function($) {
    $('#upload-button').on('click', function(e) {
        e.preventDefault();
        var fileData = new FormData();
        fileData.append('action', 'upload_custom_file');
        fileData.append('nonce', '<?php echo wp_create_nonce('upload_file_nonce'); ?>');
        fileData.append('custom_file', $('#file-input')[0].files[0]);

        $.ajax({
            url: ajaxurl,
            type: 'POST',
            data: fileData,
            contentType: false,
            processData: false,
            success: function(response) {
                if (response.success) {
                    $('#preview').html('<img src="' + response.data.url + '" style="max-width:200px">');
                } else {
                    alert('Ошибка: ' + response.data);
                }
            }
        });
    });
});

Результат: при нажатии на кнопку файл загружается на сервер, а в div #preview появляется превью.

Пример 3: REST маршрут с кастомной валидацией и отложенной обработкой

Создается маршрут, который принимает POST и ставит задачу в очередь (wp_schedule_single_event).

add_action('rest_api_init', function() {
    register_rest_route('myapp/v1', '/queue-task', array(
        'methods' => 'POST',
        'callback' => 'handle_queue_task',
        'permission_callback' => function() {
            return current_user_can('manage_options');
        },
        'args' => array(
            'task_type' => array(
                'required' => true,
                'validate_callback' => function($param) {
                    return in_array($param, array('email', 'report'));
                }
            ),
            'recipient' => array(
                'required' => false,
                'sanitize_callback' => 'sanitize_email'
            )
        )
    ));
});

function handle_queue_task($request) {
    $type = $request->get_param('task_type');
    $recipient = $request->get_param('recipient');
    // Планируем задачу на выполнение через 5 минут
    wp_schedule_single_event(time() + 300, 'my_custom_task_event', array($type, $recipient));
    return new WP_REST_Response(array('scheduled' => true, 'eta' => 300), 200);
}

Результат ответа:

{
  "scheduled": true,
  "eta": 300
}

Данный подход снижает нагрузку на обработку тяжелых задач.

Пример 4: Экспорт данных через admin_post с потоковой передачей

Пользователь нажимает кнопку, инициируется загрузка CSV файла без лишних буферизаций.

add_action('admin_post_export_csv', function() {
    if (!current_user_can('export')) {
        wp_die('Нет прав');
    }
    if (!wp_verify_nonce($_GET['_wpnonce'], 'export_csv_nonce')) {
        wp_die('Nonce error');
    }

    header('Content-Type: text/csv; charset=utf-8');
    header('Content-Disposition: attachment; filename="export.csv"');
    $out = fopen('php://output', 'w');
    fputcsv($out, array('ID', 'Имя', 'Email'));
    $users = get_users();
    foreach ($users as $user) {
        fputcsv($out, array($user->ID, $user->display_name, $user->user_email));
    }
    fclose($out);
    exit;
});

Форма-ссылка:

<a href="<?php echo wp_nonce_url(admin_url('admin-post.php?action=export_csv'), 'export_csv_nonce'); ?>" class="button">Скачать CSV</a>

При клике сразу начинается загрузка файла.