En la variedad de funciones que nos brinda WordPress para ejecutar acciones en el sistema hay una en particular que además de poderosa se encarga de todas las gestiones relacionadas con las actualizaciones del contenido de determinada entrada.
En el siguiente artículo revisaremos que es la función wp_update_post, qué parámetros utiliza y como podemos emplearla en casos reales.
Tabla de contenidos
¿Qué es wp_update_post?
wp_update_post es una función en WordPress que se emplea para actualizar los datos de una publicación existente en la base de datos. Es utilizada para modificar cualquier aspecto de una publicación, incluyendo campos como el título, contenido, categoría, etiquetas, estado de publicación, etc.
La función wp_update_post toma un arreglo asociativo que contiene los datos de la publicación que se desea actualizar, incluyendo el ID de la publicación. También es posible utilizar esta función para agregar nuevas publicaciones a la base de datos de WordPress, estableciendo un ID de publicación igual a cero.
Se debe tener presente que cuando se utiliza wp_update_post, es necesario proporcionar todos los campos que se desean actualizar, de lo contrario, los valores antiguos de la entrada permanecerán. Además, esta función puede ejecutar ganchos de acciones o hooks en WordPress que se han agregado al proceso de actualización de publicaciones.
Ventajas de utilizar wp_update_post en WordPress
La función wp_update_post es de uso indispensable entre las acciones en WordPress, sin embargo, podemos mencionar algunas ventajas de su uso.
Actualización rápida y sencilla: con esta función, es posible actualizar los datos de una entrada en WordPress de forma muy simple, sin necesidad de acceder al los editores de WordPress.
Flexibilidad: wp_update_post permite actualizar cualquier aspecto de una publicación, desde su título y contenido hasta su categoría, etiquetas, imagen destacada en WordPress y estado de publicación, entre otros.
Automatización: esta función es muy útil para realizar actualizaciones en lote, ya que se pueden programar scripts que actualicen los datos de múltiples publicaciones de manera automática.
Control de versiones: WordPress guarda un historial de las versiones de una publicación, lo que permite regresar a versiones anteriores en caso de ser necesario.
Seguridad en WordPress: wp_update_post es una función segura, puesto que realiza validaciones para asegurar que los datos que se están actualizando son válidos y no se están modificando datos no autorizados.
¿Cuáles son los parámetros de wp_update_post?
Como hemos definido, la función wp_update_post toma un arreglo asociativo de parámetros que define los datos de la publicación que se desea actualizar.
A continuación vamos a enlistar los parámetros más importantes que podemos utilizar:
- ID: (Obligatorio) El ID de la publicación que se desea actualizar.
- post_title: El título de la publicación.
- post_content: El contenido de la publicación.
- post_excerpt: El extracto de la publicación.
- post_status: El estado de la publicación, puede ser “publish”, “pending”, “draft”, “auto-draft”, “future”, “private”, “inherit”, “trash”.
- post_author: El ID del usuario en WordPress que creó la publicación.
- post_category: Una matriz de identificadores de las categorías a las que pertenece la publicación.
- post_tags: Una cadena con las etiquetas separadas por comas de la publicación.
- post_date: La fecha de publicación.
- post_date_gmt: La fecha de publicación en formato GMT.
- comment_status: El estado de comentarios, puede ser “open”, “closed” o “registered_only”.
- ping_status: El estado de ping, puede ser “open” o “closed”.
- post_password: La contraseña de la publicación.
- post_name: El slug de la publicación.
- post_modified: La fecha de modificación de la publicación.
- post_modified_gmt: La fecha de modificación de la publicación en formato GMT.
Tengamos en cuenta que no todos los parámetros enlistados son obligatorios, pero si que es necesario incluir el ID de la publicación que se desea actualizar.
¿Cómo usar wp_update_post en WordPress?
Para comenzar a usar la función wp_update_post en WordPress, Primero debemos encontrar el ID de la página en WordPress que deseamos actualizar.
Para ello es posible obtenerlo desde el panel de administración o mediante una consulta a la base de datos de WordPress.
Ya con el ID de la publicación en nuestro conocimiento, por medio de un arreglo asociativo de parámetros, el cual va a definir los datos que deseas actualizar.
Se llama a la función wp_update_post y pasa el arreglo asociativo como argumento.
Vamos a verlo en un caso de uso real de como usar la funcion wp_update_post:
// Obtener el ID de la publicación que deseas actualizar
$post_id = 777;
// Crear un arreglo asociativo de parámetros con los datos que deseas actualizar
$post_data = array(
'ID' => $post_id,
'post_title' => 'Nuevo título de la publicación',
'post_content' => 'Nuevo contenido de la publicación',
'post_category' => array(1, 8) // IDs de las categorías a las que pertenece la publicación
);
// Llamar a la función wp_update_post
wp_update_post($post_data);
En este caso, se está actualizando el título, el contenido y las categorías de la publicación correspondientes al ID 777. Podemos agregar tantos parámetros como queramos para actualizar cualquier aspecto de la publicación.
Es importante destacar que, dependiendo de los permisos de usuario, es posible que se requiera autenticación para poder actualizar una publicación en WordPress.
Ejemplos las funciones wp_update_post
A continuación vamos a mostrar algunos ejemplos como posibles casos reales de cómo utilizar la función wp_update_post en WordPress para actualizar publicaciones:
Actualizar el título de una publicación:
// Obtener el ID de la publicación que deseas actualizar
$post_id = 777;
// Crear un arreglo asociativo de parámetros con el nuevo título
$post_data = array(
'ID' => $post_id,
'post_title' => 'Nuevo título de la publicación'
);
// Llamar a la función wp_update_post
wp_update_post($post_data);
Actualizar el contenido de una publicación:
// Obtener el ID de la publicación que deseas actualizar
$post_id = 777;
// Crear un arreglo asociativo de parámetros con el nuevo contenido
$post_data = array(
'ID' => $post_id,
'post_content' => 'Nuevo contenido de la publicación'
);
// Llamar a la función wp_update_post
wp_update_post($post_data);
Actualizar la categoría de una publicación:
// Obtener el ID de la publicación que deseas actualizar
$post_id = 777;
// Crear un arreglo asociativo de parámetros con la nueva categoría
$post_data = array(
'ID' => $post_id,
'post_category' => array(5) // IDs de las categorías a las que pertenece la publicación
);
// Llamar a la función wp_update_post
wp_update_post($post_data);
Actualizar el estado de una publicación:
// Obtener el ID de la publicación que deseas actualizar
$post_id = 777;
// Crear un arreglo asociativo de parámetros con el nuevo estado
$post_data = array(
'ID' => $post_id,
'post_status' => 'draft'
);
// Llamar a la función wp_update_post
wp_update_post($post_data);
Conclusión
Sin duda, la función wp_update_post es una herramienta muy útil en WordPress para actualizar los datos de una publicación de manera rápida y sencilla, con la flexibilidad necesaria para ajustar cualquier aspecto de la misma. Además, su uso permite automatizar tareas y asegurar la seguridad de los datos que se están actualizando dentro de determinada publicación.
También te puede interesar:
- Función get_option en WordPress, qué es y cómo usarla
- Cómo volver a la versión anterior de WordPress
- Cómo recuperar una entrada en WordPress
- Programar entradas en WordPress
- WP_Query WordPress, qué es y cómo funciona
- Actualizar versión PHP en WordPress
¿Te ha resultado útil este artículo?
Equipo de soporte WordPress y Woocommerce en Webempresa.
