Desentrañando el shortcode [display-posts] en WordPress

Al revisar el código que aparece en la página para mostrar las últimas 26 entradas del blog, surgió una duda técnica fundamental. El fragmento [display-posts] con sus atributos parece parte nativa del sistema o bien proviene de un plugin externo.

Código HTML del shortcode display-posts
Snippet del shortcode en el editor

¿Qué es realmente este código?

La respuesta es clara: se trata de un shortcode de WordPress proporcionado por un plugin, no una función nativa. El comando pertenece al plugin Display Posts Shortcode, diseñado específicamente para listar entradas.

Tu código tiene dos partes principales:

<div class="destacados">
[display-posts
    posts_per_page="26"
    image_size="medium"
    content_class="dps-listing-content destacados"
    include_excerpt="true"
    wrapper="div"]
</div>

En este caso, display-posts es el shortcode que ejecuta el plugin y genera el listado. Los atributos como posts_per_page="26" controlan cuántas entradas se muestran, mientras que include_excerpt="true" indica que debe incluir un resumen de cada entrada.

Diferencia con funciones nativas

WordPress tiene funciones PHP como WP_Query() para consultar entradas internamente, pero los shortcodes son etiquetas procesadas dentro del contenido. Un plugin puede registrar uno mediante add_shortcode(). Si desactivas el plugin que registra display-posts, lo normal es que WordPress deje de generar el listado y muestre el shortcode como texto plano.

Un detalle útil para tu blog: si quieres modificar cómo se presentan esas 26 entradas, puedes hacerlo mediante CSS o mediante las plantillas del tema, sin necesidad de cambiar el shortcode. Si deseas alterar la lógica de selección o el orden, ya conviene revisar el plugin.

Parámetros de filtrado y contenido

Sí, y tiene bastantes más posibilidades de las que aparenta ese pequeño código. El plugin permite controlar qué entradas aparecen, cómo se ordenan y qué información se muestra. Para tu blog, lo interesante es que puedes hacer todo esto sin escribir PHP: basta con modificar los atributos entre corchetes.

Seleccionar qué entradas mostrar

Aquí tienes las opciones principales para filtrar:

  • posts_per_page=»26″: Número de entradas.
  • category=»noticias»: Solo entradas de esa categoría, usando su slug.
  • tag=»destacados»: Solo entradas con esa etiqueta.
  • id=»123,456″: Mostrar entradas concretas por su ID.
  • exclude=»123,456″: Excluir determinadas entradas.
  • offset=»26″: Saltarse las primeras 26 entradas.
  • post_type=»page»: Mostrar páginas en lugar de entradas normales.
  • author=»nombre»: Filtrar por autor.
  • s=»búsqueda»: Buscar entradas que coincidan con un término.

Estos filtros se pueden combinar. Por ejemplo, puedes mostrar las 26 entradas más recientes de una categoría concreta.

Ordenar las entradas

Aquí tienes algunas opciones especialmente útiles:

  • orderby=»date»: Orden por fecha de publicación.
  • orderby=»modified»: Orden por última modificación.
  • orderby=»title»: Orden alfabético por título.
  • orderby=»comment_count»: Más comentadas primero.
  • orderby=»rand»: Orden aleatorio.
  • order=»ASC»: Orden ascendente.
  • order=»DESC»: Orden descendente.

Por ejemplo, para mostrar las 26 entradas más recientes ordenadas alfabéticamente:

[display-posts posts_per_page="26" orderby="title" order="ASC"]

Controlar el contenido que aparece

Puedes ajustar qué elementos se renderizan en cada entrada:

  • include_title=»false»: Oculta los títulos.
  • include_date=»true»: Muestra la fecha de publicación.
  • include_excerpt=»true»: Muestra un extracto.
  • excerpt_length=»30″: Limita el extracto a 30 palabras.
  • image_size=»thumbnail»: Usa miniaturas pequeñas.
  • include_content=»true»: Muestra el contenido completo.
  • title=»Últimas entradas»: Añade un título al listado.

Un detalle: image_size utiliza los tamaños de imagen disponibles en WordPress; también admite tamaños personalizados registrados por el tema o por otros plugins.

Vista previa de entradas en cuadrícula
Ejemplo de cuadrícula generada por el plugin

Personalizar HTML y diseño

Esta parte es particularmente interesante para ti, porque ya estás trabajando con clases CSS en tu blog.

wrapper="div"
wrapper_class="destacados-grid"
content_class="dps-listing-content"
  • wrapper: define si el listado utiliza ul, ol o div.
  • wrapper_class: asigna una clase al contenedor general del listado.
  • content_class: asigna clases al contenedor del contenido de cada entrada.

Por ejemplo:

<div class="destacados">
[display-posts posts_per_page="26"
    image_size="medium"
    include_excerpt="true"
    excerpt_length="25"
    wrapper="div"
    wrapper_class="destacados-grid"
    content_class="dps-listing-content"]
</div>

Después puedes diseñar la presentación con CSS, por ejemplo, para distribuir las entradas en tres columnas:

.destacados-grid {
    display: grid;
    grid-template-columns: repeat(3, minmax(0, 1fr));
    gap: 20px;
}

Eso sí: el CSS definitivo dependerá de la estructura HTML que genere tu versión del plugin y de cómo quieras mostrar las imágenes y los extractos.

¿Y si quieres hacer algo más avanzado?

El plugin también permite consultar taxonomías personalizadas y combinar varios filtros. Además, dispone de filtros PHP para modificar las consultas o personalizar la salida; eso ya requiere código adicional.

Te dejo la documentación oficial para tenerla a mano:

Recomendación para tu blog: antes de añadir más plugins, aprovecha este. Puedes crear listados de entradas por categoría, páginas de destacados, selecciones aleatorias o cuadrículas visuales utilizando el mismo shortcode.

Y hay una posibilidad especialmente interesante: si quieres que tu página de inicio muestre una selección de artículos destacados y no simplemente los últimos publicados, puedes hacerlo filtrando por una categoría o etiqueta específica, sin tener que seleccionar manualmente cada entrada.