Petición de formulario $_POST con admin-post

Antes de redirigir, puedes guardar cualquier error de validación y los valores del formulario en un transitorio. Estos valores persistirán después de la redirección de la URL.

Esto es exactamente cómo lo hace el núcleo de WordPress para la API de Configuración cuando devuelve errores.

Entonces:

- Validar los datos del formulario

- Almacenar los datos del formulario en un transitorio con set_transient()

- Almacenar cualquier error en un transitorio

- Redirigir a la salida del formulario

- Verificar si hay errores en el transitorio

- Cargar los valores del formulario desde el transitorio

Podrías usar una sesión o la API de Opciones en lugar de un transitorio.

Ahora, he estado experimentando con varias formas de manejar los envíos de formularios tanto en el frontend como en el administrador. No estoy seguro de que admin_post_{action} sea tan conveniente debido a la necesidad de persistir datos y errores a través de la redirección. Usar el hook init o admin_init para verificar un envío de formulario podría ser más fácil. También podrías simplemente enviar tu formulario de vuelta a la misma página y procesar el envío antes de que se muestre el formulario.

La respuesta corta es que tienes que hacer todo el trabajo: guardar la entrada del usuario en la base de datos, verificar si hay errores o éxito, y redirigir a donde quieras cuando hayas terminado.

Si deseas redirigir al formulario nuevamente, puedes usar un campo generado por wp_nonce() incluido en el arreglo $_POST enviado por tu formulario: $_POST['_wp_http_referer']

Finalmente puedes redirigir y enviar un mensaje de éxito o error usando wp_safe_redirect(), esc_url_raw() y add_query_arg().

add_action( 'admin_post_my-action', 'my_save_form_function' );
add_action( 'admin_post_nopriv_my-action', 'my_save_form_function' );
function my_save_form_function() {
    if ( ! empty( $_POST['_wp_http_referer'] ) ) {
        $form_url = esc_url_raw( wp_unslash( $_POST['_wp_http_referer'] ) );
    } else {
        $form_url = home_url( '/' );
    }
    if ( isset( $_POST['name'] )
        && isset( $_POST['description'] )
        && isset( $_POST['my-nonce'] )
        && wp_verify_nonce(
            sanitize_text_field( wp_unslash( $_POST['my-nonce'] ) ),
            'my-action'
        )
        ) {

        // Guarda los datos de tu formulario...

        // ¿Todo funcionó correctamente?
        wp_safe_redirect(
            esc_url_raw(
                add_query_arg( 'my_status', 'success', $form_url )
            )
        );
        exit();
    } else {
        wp_safe_redirect(
            esc_url_raw(
                add_query_arg( 'my_status', 'error', $form_url )
            )
        );
        exit();
    }
}