Bienvenido a "Guía de ganchos, acciones y filtros de WordPress". En el vasto reino del desarrollo de WordPress, entender los ganchos, acciones y filtros es esencial para liberar todo el potencial de esta poderosa plataforma.
Los ganchos son la columna vertebral de la personalización de WordPress, ya que permiten modificar y ampliar su funcionalidad sin problemas. Las acciones permiten realizar tareas específicas en momentos clave durante el tiempo de ejecución, mientras que los filtros permiten manipular datos y devolver resultados modificados. Tanto si es un principiante como un desarrollador experimentado, esta completa guía le proporcionará información valiosa y ejemplos prácticos para aprovechar la verdadera flexibilidad y las capacidades de personalización que ofrecen los hooks, las acciones y los filtros de WordPress. Vamos a sumergirnos y desbloquear las posibilidades ilimitadas de desarrollo de WordPress.
Ganchos
Los hooks son la base del desarrollo de plugins y temas para WordPress. Son lugares donde los desarrolladores pueden "enganchar" su código personalizado a WordPress en lugares específicos y cambiar el funcionamiento de WordPress sin editar los archivos principales.
Los Hooks de WordPress consisten en dos tipos fundamentales conocidos como Acciones y Filtros. Las Acciones permiten ejecutar tareas específicas en puntos predefinidos durante el tiempo de ejecución de WordPress, mientras que los Filtros permiten modificar y devolver cualquier dato procesado por WordPress.
Acciones:
Empleando una acción, puede personalizar el comportamiento por defecto de una función concreta extrayendo información de WordPress y realizando operaciones sobre ella. Una vez ejecutada una acción, no es necesario devolver ningún dato a WordPress.
Para añadir acciones, se utiliza la función add_action(). WordPress ofrece varias funciones que facilitan la utilización de acciones, siendo las siguientes las más comúnmente empleadas:
Las acciones se definen en el código de WordPress como
do_action( 'action_name', [optional_arguments] );
Enganchándose a la acción do_action('wp_head'), puede ejecutar código personalizado cada vez que WordPress procese la cabecera del sitio. Esta acción no requiere argumentos adicionales.
Ejemplo completo:
add_action( string $hook_name, callable $callback, int $priority = 10, int $accepted_args = 1 ): true
Referencias de todas las acciones:
https://codex.wordpress.org/Plugin_API/Action_Reference
https://developer.wordpress.org/reference/functions/add_action/
Un filtro modificará el comportamiento por defecto de una función específica. Lo hace manipulando los datos que recibe y devolviéndolos a WordPress antes de mostrarlos en el navegador.
Ejemplos:
Los filtros se definen en el código de WordPress como
apply_filters( 'filter_name', 'value_to_be_filtered', [optional_arguments] );
La cadena filter_name es el nombre del filtro, la variable value_to_be_filtered es el valor que necesita ser filtrado y devuelto, y la variable [optional_arguments] puede pasar argumentos adicionales, igual que con las acciones.
Ejemplo: El filtro apply_filters( 'admin_footer_text' , string $text ) se puede enganchar para modificar el texto que se muestra en el pie de página del admin. A partir de WordPress 5.4, su valor por defecto mostrará la frase. Gracias por crear con WordPress. en el pie de página del área de administración.
|
Ganchos de WordPress |
|
| Acciones | Filtros |
| Las acciones se utilizan para ejecutar funciones personalizadas en un punto específico durante la ejecución del núcleo de WordPress. | Los filtros sirven para modificar o personalizar los datos utilizados por otras funciones. |
| Las acciones se definen/crean mediante la función do_action( 'nombre_accion' ) en el código de WordPress. | Los filtros se definen/crean mediante la función apply_filters( 'nombre_filtro', 'valor_a_filtrar' ) en el código de WordPress. |
| Las acciones también se denominan ganchos de acción. | Los filtros también se denominan ganchos de filtro. |
| Las acciones sólo pueden engancharse con funciones de acción. Por ejemplo, add_action(), remove_action(). | Los filtros sólo pueden engancharse con funciones de filtro. Por ejemplo, add_filter(), remove_filter(). |
| Las funciones de acción no necesitan pasar ningún argumento a sus funciones de llamada de retorno. | Las funciones de filtro deben pasar al menos un argumento a sus funciones de devolución de llamada. |
| Las funciones de acción pueden realizar cualquier tipo de tarea, incluyendo cambiar el comportamiento del funcionamiento de WordPress. | Las funciones de filtro sólo existen para modificar los datos que les pasan los filtros. Las funciones de acción no deben devolver nada. Sin embargo, pueden hacerse eco de la salida o interactuar con la base de datos. |
| Las funciones de acción no deben devolver nada. Sin embargo, pueden hacerse eco de la salida o interactuar con la base de datos. | Las funciones de filtro deben devolver sus cambios como salida. Incluso si una función de filtro no cambia nada, debe devolver la entrada sin modificar. |
| Las acciones pueden ejecutar casi cualquier cosa siempre que el código sea válido. | Los filtros deben funcionar de forma aislada para que no tengan efectos secundarios no deseados. |
En conclusión, dominar el arte de los hooks, acciones y filtros de WordPress abre un mundo de infinitas posibilidades para personalizar y mejorar tu sitio web WordPress. Entendiendo cómo funcionan los hooks, aprovechando el poder de las acciones y aprovechando la flexibilidad de los filtros, puede dar forma a la funcionalidad y apariencia de su sitio web para satisfacer sus necesidades únicas. Con los conocimientos adquiridos en esta guía, estará equipado para tomar el control total de su viaje de desarrollo en WordPress. Así que adelante, experimente y cree experiencias extraordinarias para sus usuarios. Aproveche la versatilidad de los hooks, acciones y filtros de WordPress y libere el verdadero potencial de su sitio web. ¡Feliz programación!
¿Te interesa el futuro de WordPress? ¡Echa un vistazo a este post!
