Cómo utilizar get_posts de WordPress para mostrar contenido en cualquier parte de tu sitio web

Puntos clave

• get_posts() es una función flexible de WordPress que te permite obtener y mostrar entradas dinámicamente utilizando categorías, tipos de entrada personalizados, etiquetas u otros parámetros.
• Gestiona siempre el bucle correctamente utilizando setup_postdata() y wp_reset_postdata() para evitar conflictos con otros contenidos de la página.
• Crear una sección personalizada de entradas relacionadas mejora la participación del usuario sin depender de plugins, manteniendo el código de tu tema limpio y ligero.

WordPress gestiona millones de sitios web. ¿Por qué es tan flexible? Una gran razón son las herramientas PHP incorporadas que te permiten trabajar con tu contenido de forma dinámica. Por ejemplo, get_posts. Esta función te permite obtener contenido directamente de la base de datos de WordPress. Luego puedes poner ese contenido donde quieras en tu sitio.

• ¿Necesitas hacer una lista de cosas recientes?
• ¿Quieres mostrar artículos relacionados?
• ¿Construir un área totalmente personalizada en tu tema?

La función get_posts te da un control total sobre qué entradas aparecen y cómo se ven cuando se muestran.

En esta guía, veremos cómo funciona get_posts. Construiremos un pequeño proyecto, algo así como un área de entradas relacionadas. También hablaremos de los principales ajustes, o «parámetros», de get_posts.

Por último, te mostraré cómo un buen alojamiento, como Cloudways, puede acelerar estas peticiones a la base de datos para que tu sitio funcione mejor.

¿Qué es la función get_posts de WordPress?

La función get_posts de WordPress es una utilidad básica de PHP. Te permite extraer una lista específica de entradas de tu base de datos. El bucle predeterminado de WordPress sólo muestra las entradas de las páginas principales del blog. Pero get_posts te permite consultar el contenido en cualquier otro lugar y controlar completamente los mensajes que recibes.

Por defecto, get_posts devuelve una matriz de cosas llamadas objetos WP_Post. Cada objeto contiene todos los detalles de una entrada: el título, el contenido, las categorías, las etiquetas, los campos personalizados… todo.

Esto facilita hacer cosas personalizadas. Mostrar entradas en diseños únicos. Crea áreas de «entradas relacionadas». Crea widgets especializados. Todo ello sin tocar el feed principal de tu blog.

Puedes utilizar get_posts para montones de cosas:

• Mostrar nuevas entradas directamente en el diseño de tu página de inicio.
• Extraer lecturas relacionadas en tus páginas de entradas individuales.
• Hacer listas personalizadas para determinadas etiquetas o categorías.
• Obtención de contenidos por autores específicos o tipos personalizados que hayas creado.

Este control es exactamente la razón por la que los desarrolladores utilizan get_posts constantemente cuando necesitan un control personalizado sobre su contenido.

Entender get_post vs get_posts en WordPress

Los nombres parecen casi idénticos, pero get_post y get_posts realizan tareas muy distintas.

• get_post es para coger sólo una cosa. Normalmente ya conoces su ID (quizás un post destacado). Devuelve un único objeto WP_Post.
• get_posts sirve para obtener una lista de varias cosas. Piensa en listas de entradas recientes, o entradas de una categoría. Devuelve una matriz de objetos WP_Post, para que puedas recorrerlos todos fácilmente.

Mira este ejemplo rápido de código:

$args = [

'númeroposts' =>  5, // Dame 5 puestos

'categoría' =>  12, // Sólo de la categoría ID 12

'orderby' =>  'fecha', // Ordenarlos por fecha

'orden' =>  'DESC', // Los más nuevos primero

'post_type' =>  'post', // Sólo posts estándar (no páginas)

];




$posts_recientes = get_posts($args);




foreach ($posts_recientes como $posts) {

setup_postdata($post);

echo obtener_el_título($post->ID) . '<br>';

}




wp_reset_postdata();

En este código, utilicé la matriz $args para definir exactamente qué publicaciones quería. Luego ejecuté get_posts y utilicé un bucle foreach para mostrar sus títulos. Debo utilizar setup_postdata() para que las funciones básicas de WordPress funcionen, y siempre restablecer los datos después (wp_reset_postdata()) para evitar que las cosas se rompan en otro sitio.

Un resumen rápido:

• ¿Sólo necesitas un elemento? Utiliza get_post.
• ¿Necesitas una lista? Utiliza get_posts. Se encarga de filtrar todas las listas.
• Ambos devuelven el mismo tipo de objeto, por lo que acceder al título o al contenido se hace de la misma forma.

Parámetros clave de las consultas get_posts y get_post_type

get_posts es potente porque es muy flexible. Puedes controlar casi todos los aspectos de las entradas que extrae utilizando sus «parámetros» o ajustes. Conocerlos te permite crear las consultas exactas que necesitas sin escribir código de base de datos personalizado (SQL).

Éstos son los ajustes que más utilizo:

• númeroposts – Cuántos posts se retirarán. Por defecto es 5.
• categoría – Obtén entradas sólo de un ID de categoría determinado.
• orderby y order – Controlan la ordenación. Puedes ordenar por fecha, título o datos personalizados.
• post_type – Coge los tipos personalizados que hayas creado, no sólo las entradas estándar del blog.
• meta_key y meta_value – Utilízalos para filtrar por campos personalizados. Ejemplo: mostrar entradas que tengan un valor personalizado específico.
• post_status – Por defecto, sólo recupera las entradas publicadas. Cámbialo si necesitas borradores o entradas privadas.

Aquí tienes un ejemplo rápido que combina algunos de estos parámetros:

$args = [

'númeroposts' =>  5,

'categoría' =>  12,

'orderby' =>  'fecha',

'orden' =>  DESC

'post_type' =>  'puesto',

];




$posts_recientes = get_posts($args);

foreach ($posts_recientes como $posts) {

setup_postdata($post);

echo obtener_el_título($post->ID) . '<br>';

}

wp_reset_postdata();

Dos reglas finales por las que vivo:

• No tires demasiados posts a la vez. Incluso con caché, esas enormes consultas ralentizan todo.
• get_posts no gestiona la paginación. Si necesitas números de página (Página 1 de 5), utiliza WP_Query en su lugar.

Una vez que te sientas cómodo con estos parámetros, podrás construir consultas que obtengan entradas basándose en casi cualquier condición que puedas imaginar. Más adelante, pondremos esto en práctica en el miniproyecto.

Construir consultas simples y avanzadas con get_posts

Escribir consultas get_posts resulta sencillo una vez que conoces los parámetros básicos. La mayoría de los usos en el mundo real empiezan siendo sencillos. Sólo se vuelven complejas cuando una regla de diseño o filtrado lo exige.

¿El ejemplo más básico? Sólo tienes que coger los mensajes más recientes:

$posts = get_posts([

'númeroposts' =>  5

]);

Este código extrae las cinco últimas entradas publicadas. Es bueno para barras laterales, pies de página o cualquier bloque de contenido básico que necesites.

¿Quieres un conjunto más específico? Lo siguiente suele ser filtrar por categoría.

$posts = get_posts([

'númeroposts' =>  5,

'categoría' =>  8

]);

Ahora WordPress sólo devuelve entradas de ese ID de categoría. Esto es muy común para secciones «destacadas» o listas de temas específicos.

Los tipos de entrada personalizados funcionan exactamente igual. Si tu sitio utiliza algo como proyectos o estudios_de_caso, dile a get_posts qué tipo debe buscar:

$posts = get_posts([

'post_type' =>  proyectos

'númeroposts' =>  6

]);

La ordenación es un pequeño detalle, pero cambia mucho los resultados. Las entradas se ordenan por fecha por defecto, pero puede que necesites otra cosa:

$posts = get_posts([

'númeroposts' =>  5,

'orderby' =>  'título',

'orden' =>  ASC

]);

Esta configuración funciona muy bien para listas alfabéticas en las que el orden importa, como páginas de recursos o directorios.

Para necesidades más complejas, entran en escena los campos personalizados. ¿Digamos que marcas determinadas entradas como destacadas? Puedes filtrar específicamente en función de ese campo personalizado y su valor:

$posts = get_posts([

'númeroposts' =>  5,

'meta_key' =>  destacado

'meta_valor' =>  sí

]);

Sigues utilizando la misma función. Sólo estás siendo mucho más específico sobre el contenido exacto que quieres recuperar.

La clave es ser siempre intencionado. Recoge sólo lo que necesites absolutamente. No apiles condiciones innecesarias. Como estas consultas personalizadas aparecen en muchas páginas, el rendimiento se convierte en una gran preocupación, especialmente en sitios con mucho tráfico.

A continuación, veremos cómo mostrar correctamente los datos que devuelve get_posts. También veremos cómo evitar errores comunes al trabajar con estos bucles personalizados.

Mostrar resultados de get_posts en WordPress

Coger entradas con get_posts es el primer paso. Mostrarlas correctamente en tu sitio es el segundo paso. Como get_posts devuelve una matriz de objetos WP_Post, debes ejecutar un bucle y utilizar setup_postdata() para que las funciones de plantilla estándar de WordPress extraigan los datos correctos.

Mira este ejemplo:

$posts = get_posts([

'númeroposts' =>  5,

]);




foreach ($posts as $post) {

setup_postdata($post);

echo '<h2>' . get_the_title($post- >ID) . '</h2>';

echo '<p>' . get_the_excerpt($post- >ID) . '</p>';

}




wp_reset_postdata();

Aquí, el bucle recorre cada entrada. Imprime el título y el extracto. El uso de setup_postdata($post) garantiza que funciones como get_the_title() y get_the_excerpt() funcionen correctamente. Y wp_reset_postdata() restaura las variables globales. Esto es esencial para que no se rompan otros bucles de la página.

Este método funciona para listas sencillas, barras laterales o secciones de ancho completo. Puedes añadir fácilmente enlaces, imágenes destacadas o metainformación dentro del bucle para crear diseños más ricos. ¿La regla más importante? Restablece siempre los datos de la entrada al final.

Ahora puedes utilizar los parámetros de los que hemos hablado antes para controlar exactamente qué entradas se devuelven y cuántas. Combina esas consultas con este bucle para mostrar el contenido que quieras, en cualquier parte de tu sitio.

Crear una sección personalizada de entradas relacionadas con la función get_posts de WordPress

Ahora que hemos visto get_posts, sus parámetros y cómo mostrar las entradas, es hora de ponerlo en práctica. Vamos a crear una sencilla sección de entradas relacionadas que muestre otras entradas de la misma categoría al final de una entrada.

Éste es el planteamiento:

• Obtener la categoría de la entrada actual: Utilizaremos las funciones de WordPress para obtener el ID de la categoría de la entrada que está leyendo el usuario.
• Crea una consulta get_posts: Utilizando el ID de la categoría, crearemos una matriz $args con parámetros como numberposts (cuántos posts mostrar) y exclude (para omitir el post actual).
• Recorre los resultados: Recorreremos las entradas devueltas, mostrando el título y un breve extracto de cada una. Utilizar setup_postdata() garantiza que todas las funciones de WordPress, como get_the_title(), funcionen correctamente.
• Restablecer los datos de la entrada: Después del bucle, llamaremos a wp_reset_postdata() para evitar conflictos con otros bucles de la página.

Para este mini proyecto, estoy utilizando un sitio WordPress alojado en Cloudways, pero los pasos funcionan igual en cualquier alojamiento. Construiremos una sencilla sección de entradas relacionadas que muestre entradas de la misma categoría en la parte inferior de una única entrada.

En este proyecto lo uniremos todo. Practicaremos la consulta de entradas con parámetros, el bucle a través de los resultados y la visualización dinámica del contenido.

Paso 0: Comprueba las categorías de tu sitio web

Antes de escribir ningún código, asegurémonos de que tus entradas tienen realmente categorías:

• Ve a tu panel de control de WordPress.

• Haz clic en Entradas → Categorías en la barra lateral.

• Deberías ver una lista de categorías. Si no es así, crea una introduciendo un nombre como «Noticias» o «Tutoriales» y haciendo clic en Añadir nueva categoría.

• Ve a Entradas → Todas las entradas, abre una de tus entradas y asegúrate de que tiene asignada una categoría. Puedes marcar la casilla Categorías en el editor de entradas.

Si tus entradas no tienen categorías, este proyecto no funcionará correctamente. Asigna al menos una categoría a algunas entradas.

Paso 1: Decide dónde colocar el código

Para este miniproyecto, queremos que las entradas relacionadas aparezcan en la parte inferior de las páginas de una sola entrada. Eso significa que añadiremos el código al archivo single.php de tu tema.

La mayoría de los temas tienen un archivo de plantilla llamado single.php que controla cómo se muestran las entradas individuales.

Pasos para acceder al archivo:

• Ve a Apariencia → Editor de archivos de temas.

• En la barra lateral derecha, busca single.php.

• Haz primero una copia de seguridad de este archivo (copia todo su contenido en un archivo de texto) para poder restaurarlo si algo se rompe. Copiaré todo el código en un archivo de texto.

Pondremos el código de las entradas relacionadas justo antes de la línea get_footer() en la parte inferior de single.php, para que se muestre al final del contenido de la entrada.

Para usuarios de Astra: El contenido de la entrada principal se muestra con astra_content_loop(). No tocaremos eso. En su lugar, añadiremos nuestras entradas relacionadas después de astra_primary_content_bottom() pero antes del cierre </div ><!– #primary –>. Esto garantiza que la sección aparezca al final del post sin interferir con el bucle principal.

Para ello, añadiré una nueva Sección de Entradas Relacionadas a nuestro archivo single.php. Así

Para otros temas: Busca dónde termina el contenido de tu entrada principal (normalmente después de the_content() o del bucle de contenido de tu tema) y coloca el código de las entradas relacionadas inmediatamente después.

Paso 2: Obtener la categoría de la entrada actual

Ahora tenemos que averiguar a qué categoría pertenece la entrada actual. Esto es importante porque queremos mostrar entradas relacionadas de la misma categoría.

$categories = wp_get_post_categories(get_the_ID());

$category_id = $categories[0]; // Utiliza la primera categoría

Para qué sirve:

• get_the_ID() obtiene el ID de la entrada que se está viendo en ese momento.
• wp_get_post_categories() devuelve una matriz con todos los ID de categoría asignados a esa entrada.
• $categories[0] elige la primera categoría. Si una entrada tiene varias categorías, puedes ampliar esto más adelante para incluir más.

Dónde añadirlo:

Como estoy utilizando Astra, añadiré este código justo al principio de la Sección de Entradas Relacionadas que hemos creado antes.

Así:

<php

// Inicio de la Sección de Entradas Relacionadas

$categories = wp_get_post_categories(get_the_ID());

$category_id = $categories[0]; // Utiliza la primera categoría

// Fin de la Sección de Entradas Relacionadas

?>

Tras añadir el código, pulsa «Actualizar Archivo» en el Editor de Archivos Temáticos. En este punto, WordPress ya conoce la categoría de la entrada, y $category_id mantiene ese valor.

Para otros temas, el enfoque es el mismo: encuentra el final del contenido de tu entrada principal en single.php y comienza allí tu sección de entradas relacionadas. A continuación, coloca el código de la categoría al principio de esa nueva sección para que get_posts sepa qué categoría debe utilizar.

Paso 3: Obtener entradas relacionadas con get_posts

Ahora que tenemos la categoría de la entrada actual almacenada en $category_id, podemos obtener otras entradas de la misma categoría. Añade este código dentro del mismo bloque PHP que creamos antes:

$args = [

'númeroposts' =>  3, // Mostrar 3 mensajes

'categoría' =>  $category_id, // Misma categoría que la entrada actual

excluir" =>  get_the_ID() // No incluyas la entrada actual

];




$puestos_relacionados = get_puestos($args);

Explicación:

• El número de mensajes controla cuántos mensajes se muestran.
• categoría filtra las entradas por la categoría que obtuvimos anteriormente.
• excluir asegura que no volvamos a mostrar el post actual.

Paso 4: Recorre y muestra las entradas

Ahora que tenemos las entradas relacionadas almacenadas en $related_posts, tenemos que mostrarlas en la página. Recorreremos las entradas y mostraremos el título y el extracto de cada una de ellas. Añade esto dentro del mismo bloque PHP que has estado utilizando:

if ( $puestos_relacionados ) {

echo '<section class="post-relacionados"><h2>Entradas relacionadas</h2>';




foreach ( $puestos_relacionados as $puesto ) {

setup_postdata( $post ); // Preparar los datos de la entrada para las funciones de WordPress




echo '<div class="post-relacionado">';

echo '<h3><a href="' . get_permalink( $post->ID ) . '">' . get_the_title( $post- >ID ) . '</a></h3>';

echo '<p>' . get_the_excerpt( $post- >ID ) . '</p>';

echo '</div>';

}




wp_reset_postdata(); // Restablecer después del bucle




echo '</section>';

}

No olvides volver a pulsar «Actualizar archivo».

Para qué sirve:

• Comprueba si $posts_relacionados tiene alguna entrada. Si no, no se muestra nada.
• Recorre en bucle cada entrada y utiliza setup_postdata() para que las funciones de WordPress como get_the_title() y get_the_excerpt() funcionen correctamente.
• Muestra el título de la entrada como enlace clicable y el extracto debajo.
• Envuelve todo el bloque en una sección <> con una clase .related-posts para darle estilo.
• Llama a wp_reset_postdata() al final para asegurarte de que el resto de la página funciona normalmente.

Dónde añadirlo:

• Astra: Dentro del bloque PHP que has creado después de astra_primary_content_bottom(). Esto garantiza que aparezca después del contenido principal y antes del cierre </div ><!– #primary –>.

• Otros temas: Añade esto dentro de tu nueva sección de entradas relacionadas después de obtener $related_posts.

Paso 5: Prueba en tu sitio

Abre tu sitio web en una nueva pestaña del navegador. Ve a cualquier entrada del blog (no a una página). Desplázate hasta la parte inferior del contenido de la entrada.

Ahora deberías ver una sección de Entradas Relacionadas debajo de la entrada, con títulos y extractos extraídos de la misma categoría. Así:

Si la entrada no tiene otras entradas en esa categoría, la sección puede aparecer vacía, lo cual es normal.

¡Y ya está! Llegados a este punto, la sección de entradas relacionadas funciona perfectamente. Has visto exactamente dónde va el código, qué hace cada parte y cómo get_posts lo une todo. A partir de aquí, puedes ajustar el número de entradas, cambiar lo que se muestra dentro del bucle o refinar la consulta para que se ajuste mejor a tu contenido.

Cómo Cloudways optimiza las consultas get_posts de WordPress

Por sí mismo, get_posts ya es una forma ligera de obtener contenido. Pero una vez que tu sitio crece y empiezas a ejecutar múltiples consultas personalizadas a través de las plantillas, el rendimiento se convierte en un verdadero problema. Cada llamada a get_posts sigue afectando a la base de datos, a menos que algo esté almacenando el resultado en caché.

Aquí es donde empieza a importar la configuración de tu alojamiento.

Cómo Cloudways mejora el rendimiento de las consultas

En Cloudways, nos centramos en el rendimiento general de WordPress, asegurándonos de que tu sitio funcione de forma rápida y eficiente. Esto beneficia de forma natural a consultas como get_posts, sin necesidad de optimización manual adicional para cada función individual.

1. Capas de caché integradas

Implementamos múltiples capas de almacenamiento en caché a nivel de servidor. Eso significa que cuando se ejecuta una consulta get_posts, los resultados no siempre llegan directamente a la base de datos. Las páginas y secciones se almacenan en caché, por lo que las consultas repetidas se sirven más rápidamente, reduciendo el tiempo de carga para tus visitantes.

2. Pila de PHP y base de datos optimizada

Nuestra plataforma ejecuta versiones modernas de PHP con configuraciones de base de datos ajustadas para WordPress. Dado que get_posts depende de la ejecución de PHP y de consultas MySQL, esta optimización garantiza que tus bucles personalizados se ejecuten de forma eficiente, incluso cuando aparezcan varias consultas en la misma página.

3. Caché de objetos con Redis

Para sitios más grandes o dinámicos, Cloudways soporta el almacenamiento en caché de objetos a través de Redis. Esto permite almacenar en memoria los resultados de las consultas get_posts. Si se vuelve a ejecutar la misma consulta, WordPress obtiene los datos de la caché en lugar de volver a consultar la base de datos, lo que acelera secciones como las entradas relacionadas o las listas de categorías.

Por qué es importante para tu sitio web

Incluso el uso simple de get_posts, como nuestro miniproyecto de entradas relacionadas, se beneficia de estas optimizaciones. En los sitios del mundo real, las secciones múltiples a menudo dependen de consultas personalizadas a través de páginas y plantillas. Con Cloudways, estas consultas se mantienen rápidas sin necesidad de sobreoptimizar tu código manualmente.

Buenas prácticas y errores comunes

Utilizar get_posts en WordPress es sencillo, pero algunas cosas pueden ralentizar tu sitio si no tienes cuidado.

1. No ejecutes demasiadas consultas en plantillas

Cada llamada a get_posts afecta a la base de datos. Si lo ejecutas dentro de bucles que se ejecutan varias veces en una página, el sitio se ralentizará. Coge los posts una vez y reutilízalos si es posible.

2. Caché de consultas repetidas

Si necesitas los mismos resultados en varios sitios, almacenarlos en caché con un plugin o con la caché del servidor evita tener que recurrir cada vez a la base de datos.

3. Limita el número de mensajes que buscas

Recupera sólo las entradas que realmente necesites, como 3-5 entradas relacionadas. Obtener demasiadas puede ralentizar la página.

4. Orienta las consultas

Solicita sólo los datos que necesites, como títulos, extractos y enlaces. Evita obtener todos los metadatos o comentarios a menos que sea necesario.

Errores comunes que hay que tener en cuenta:

• Olvidar wp_reset_postdata() después de bucles que utilicen get_posts. Esto puede romper otras funciones de WordPress en la página.
• Mostrar la entrada actual en la lista de entradas relacionadas. Excluirlo siempre.
• Extraer datos innecesarios, como todos los campos personalizados o imágenes de cada entrada. Esto puede afectar al rendimiento.

Conclusión

Hemos visto cómo utilizar get_posts de wordpress para mostrar entradas relacionadas, estructurar la consulta, hacer un bucle con los resultados y mostrar el contenido dinámicamente. También has aprendido dónde colocar este código en un tema como Astra y qué debes tener en cuenta al crear consultas personalizadas.

El miniproyecto lo pone todo en práctica, permitiéndote añadir una sección de entradas relacionadas funcional sin depender de plugins. Por el camino, manejaste categorías, excluiste la entrada actual y recorriste los resultados de forma segura.

También cubrimos cómo Cloudways puede ayudar a optimizar el rendimiento de WordPress y analizamos las mejores prácticas y los errores más comunes al trabajar con consultas.

Si tienes alguna pregunta o necesitas más ayuda, no dudes en ponerte en contacto con nosotros en los comentarios que aparecen a continuación.