Agregar validación y manejo de errores al guardar campos personalizados

Sugiero usar sesiones ya que esto no creará efectos extraños cuando dos usuarios editen al mismo tiempo. Esto es lo que hago:

WordPress no inicia sesiones por defecto. Así que necesitas iniciar una sesión en tu plugin, functions.php o incluso wp-config.php:

if (!session_id())
  session_start();

Al guardar el post, agrega errores y notificaciones a la sesión:

function my_save_post($post_id, $post) {
   if($something_went_wrong) {
     //Agregar notificación de error si algo salió mal
     $_SESSION['my_admin_notices'] .= '<div class="error"><p>Algo salió mal</p></div>';
     return false; //podría detener el procesamiento aquí
   }
   if($somthing_to_notice) {  //ej. guardado exitoso
     //Agregar notificación si algo salió mal
     $_SESSION['my_admin_notices'] .= '<div class="updated"><p>Post actualizado</p></div>';
   }

   return true;
} 
add_action('save_post','my_save_post');

Mostrar notificaciones y errores y luego limpiar los mensajes en la sesión:

function my_admin_notices(){
  if(!empty($_SESSION['my_admin_notices'])) print  $_SESSION['my_admin_notices'];
  unset ($_SESSION['my_admin_notices']);
}
add_action( 'admin_notices', 'my_admin_notices' );

Basado en la sugerencia de pospi para usar transients, se me ocurrió lo siguiente. El único problema es que no hay un hook para colocar el mensaje debajo del h2 donde van otros mensajes, así que tuve que usar un truco con jQuery para colocarlo ahí.

Primero, guarda el mensaje de error durante tu manejador save_post (o similar). Le doy una vida corta de 60 segundos, así que estará allí solo el tiempo suficiente para que ocurra la redirección.

if($has_error)
{
  set_transient( "acme_plugin_error_msg_$post_id", $error_msg, 60 );
}

Luego, simplemente recupera ese mensaje de error en la siguiente carga de página y muéstralo. También lo elimino para que no se muestre dos veces.

add_action('admin_notices', 'acme_plugin_show_messages');

function acme_plugin_show_messages()
{
  global $post;
  if ( false !== ( $msg = get_transient( "acme_plugin_error_msg_{$post->ID}" ) ) && $msg) {
    delete_transient( "acme_plugin_error_msg_{$post->ID}" );
    echo "<div id=\"acme-plugin-message\" class=\"error below-h2\"><p>$msg</p></div>";
  }
}

Dado que admin_notices se ejecuta antes de que se genere el contenido principal de la página, el aviso no aparece donde van otros mensajes de edición de entradas, así que tuve que usar este jQuery para moverlo ahí:

jQuery('h2').after(jQuery('#acme-plugin-message'));

Como el ID de la entrada es parte del nombre del transient, esto debería funcionar en la mayoría de entornos multi-usuario excepto cuando varios usuarios están editando la misma entrada concurrentemente.

Cuando se ejecuta save_post, el post ya ha sido guardado en la base de datos.

Al revisar el código núcleo de WordPress, específicamente en la función update_post() del archivo wp-includes/post.php, no existe una forma incorporada de interceptar una solicitud antes de que se guarde en la base de datos.

Sin embargo, podemos engancharnos a pre_post_update y usar header() junto con get_post_edit_link() para evitar que el post se guarde.

<?php

/**
*   Realiza validación antes de guardar/insertar un custom post type
*/
function custom_post_site_save($post_id, $post_data) {
    // Si esto es solo una revisión, no hacer nada
    if (wp_is_post_revision($post_id))
        return;

    if ($post_data['post_type'] == 'my_custom_post_type') {
        // Rechazar títulos con menos de 5 caracteres
        if (strlen($post_data['post_title'] < 5)) {
            header('Location: '.get_edit_post_link($post_id, 'redirect'));
            exit;
        }
    }
}
add_action( 'pre_post_update', 'custom_post_site_save', 10, 2);

Si deseas notificar al usuario sobre el error, revisa este gist: https://gist.github.com/Luc45/09f2f9d0c0e574c0285051b288a0f935

¿Por qué no validas tu campo con la ayuda de un poco de Javascript? Creo que este sería el mejor enfoque para esto.

Al intentar usar el script anterior, me encontré con un problema extraño. Se muestran dos mensajes en la pantalla de edición después de actualizar la publicación. Uno muestra el estado del contenido del guardado anterior y otro del actual. Por ejemplo, si guardo la publicación correctamente y luego cometo un error, el primero muestra "error" y el segundo "ok", aunque se generan al mismo tiempo. Si modifico el script y solo agrego un mensaje (por ejemplo, "error"), inicio una actualización con "error" y luego otra con "ok", el mensaje de "error" permanece (se muestra por segunda vez). Debo guardar con "ok" una vez más para eliminarlo. Realmente no sé qué está mal, lo he probado en tres servidores locales diferentes y ocurre el mismo problema en cada uno. Si alguien tiene alguna idea o sugerencia, ¡por favor ayude!

He escrito un plugin que añade un manejo de errores rápido para las pantallas de edición de entradas y evita que las entradas se publiquen hasta que se completen los campos obligatorios:

https://github.com/interconnectit/required-fields

Permite hacer obligatorios cualquier campo de entrada, pero también puedes usar la API que proporciona para hacer que cualquier campo personalizado sea obligatorio con un mensaje de error personalizable y una función de validación. Por defecto, comprueba si el campo está vacío o no.