Añadir un filtro a un shortcode de WordPress

Aprende en este tutorial cómo añadir un filtro a un shortcode de WordPress para poder modificar el resultado que muestra.

En un tutorial anterior aprendiste cómo crear un shortcode con parámetros personalizados, para poder elegir el tipo de Custom Post Type, por ejemplo.

Otra opción interesante y muy versátil es añadir un filtro, usando la función apply_filters, para poder modificar algunos parámetros de forma sencilla con la función add_filter.

Vamos a ver cómo puedes conseguirlo.

Pasos para añadir un filtro y modificar el resultado de un shortcode

En este caso vamos a basarnos en el shortcode que permite mostrar las entradas de Custom Post Types en una rejilla con overlay.

1. Añade el filtro al shortcode

Si ya estás usando el código del tutorial mencionado, sustitúyelo por este. Si aún no lo tienes, añade este snippet al final del fichero functions.php o a tu plugin de funcionalidades:

Si te fijas lo único que has cambiado con respecto al shortcode del tutorial original es que has añadido un apply_filters antes de los argumentos de la query.

Gracias a este sutil cambio ya puedes modificar los argumentos de la query que se mostrará.

2. Utiliza el filtro para modificar el resultado del shortcode

Añade este snippet al final del fichero functions.php o a tu plugin de funcionalidades:

Con este fragmento estás modificando los siguientes parámetros:

• El tipo de Custom Post Type (en este caso indicas que sea ‘portfolio, en lugar de ‘course’)
• El criterio para ordenar (en este caso por fecha, en lugar de título)
• Orden descendente (en este caso DESC, en lugar de ASC)
• Número de entradas que se muestran (en este caso 3, en lugar de 6).

Además, esto lo puedes combinar con las etiquetas condicionales de WordPress para tener control absoluto de cuándo aplicas los cambios.

Por ejemplo, si quisieras modificarlo solo en la página principal tendrías que usar este código:

Y esto solo es un ejemplo.

Puedes añadir un filtro a cualquier shortcode y combinarlo con la etiqueta condicional de WordPress que tú quieras.

3. Introduce el shortcode donde desees

Por último, el shortcode lo puedes usar exactamente igual que como haces normalmente.

Solo tendrás que escribir «[tu_shortcode]» donde quieras que se visualice.

En este caso, como tienes que indicar el parámetro del CPT del cual quieres que se muestren las entradas, el shortcode sería algo así: [overlay_cpt_loop'].

Importante:

• Si estás utilizando el editor clásico, utiliza la pestaña de HTML para introducir el shortcode.
• En caso de que ya estés usando el nuevo editor de bloques (Gutenberg) puedes añadirlo al bloque normal de párrafo, el de HTML o el de shortcode. Todos ellos renderizarán de forma correcta el contenido.

Conclusiones

Si quieres añadir un filtro a un shortcode para que cualquiera pueda modificar el resultado que renderiza, ahora ya sabes cómo hacerlo.

¿Alguna duda? Te leo en los comentarios.

Y si quieres darme una sugerencia para próximos tutoriales, déjamela en el formulario de contacto. Ventajas de ser suscriptor. 😉

Tutoriales relacionados

• https://codigogenesis.com/crear-shortcode-personalizable-por-tipo-entrada-wordpress/
• https://codigogenesis.com/mostrar-entradas-cpt-formato-rejilla-titulo-sobre-imagen-destacada-wordpress/
• https://codigogenesis.com/crear-plugin-funcionalidades-wordpress/
• https://codigogenesis.com/mostrar-entradas-cpt-formato-rejilla-titulo-sobre-imagen-destacada-wordpress/
• https://codigogenesis.com/crear-plugin-funcionalidades-wordpress/