Actions Hooks

Ejecutas una acción cuando se lanza código adicional en un determinado punto, similar a lo que sería la ejecución de código por eventos.

Los action Hooks son “hooks” que ejecutan una acción pero que no devuelven ningún valor. Básicamente es agregar funcionalidad en un punto determinado del código de WordPress.

En la siguiente imagen veremos que en el archivo del core de WordPress se define los Actions Hooks con la función do_action(), sin embargo para usar los Hooks usaremos la función add_action().

La función de WordPress add_action() entonces es la función que usaremos, le pasaremos básicamente dos parámetros, el primero es el nombre del Hook y el segundo es el nombre de nuestra función personalizada en donde irá nuestro código que se añadirá al código de WordPress.

Esto sería lo básico, sin embargo para más información puedes consular la documentación oficial de add_action

Veamos esto con un ejemplo, el siguiente código agrega un archivo javascript a nuestro sitio web:

add_action("wp_enqueue_scripts", "web_insertar_js");
	function web_insertar_js(){
		wp_register_script('miscript', get_stylesheet_directory_uri(). '/js/script.js', array('jquery'), '1', true );
		wp_enqueue_script('miscript');  }

En el código anterior hemos usado el Hook wp_enqueue_scripts para añadir un archivo javascript, como puedes ver en la función add_action se hace referencia a la función web_insertar_js en donde esta toda la lógica para añadir el archivo script.js.

Este código simplemente añade a cola el nuevo script pero no modifica ningún tipo de valor de entrada.

Filters Hooks

En programación pasar un filtro es hacer una modificación a algún dato, por ejemplo si quieres pasar un filtro a un texto, podría ser cambiar el texto por otro, cambiar el texto a mayúsculas, etc.

Los Filters Hooks, al igual que los Actions Hooks te permiten ejecutar código en un determinado punto, sin embargo en este caso la función tendrá obligatoriamente que devolver un valor modificado.

En la siguiente imagen vemos que en el archivo del core de WordPress se define los “Fiters Hooks” con la función apply_filter(), sin embargo para usar los Hooks usaremos la función add_filter().

Para usar un filtro usaremos entonces la función de WordPress add_filter() y le pasaremos básicamente dos parámetros, el nombre del Hook y el nombre de la función que hará las modificaciones.

Para más información sobre el uso de “add_filter” puedes consultar la documentación oficial de add_filter.

Veamos esto con un ejemplo para modificar el enlace de leer más en el listado de entradas:

function web_modificar_leer_mas() {
	return ' Leer más '; }
add_filter( 'the_content_more_link', 'web_modificar_leer_mas' );

En el código anterior hemos usado el Hook the_content_more_link, el cual hace referencia a la función web_modificar_leer_mas dentro de esta función podemos hacer las modificaciones HTML al enlace de leer más y devolverlo modificado.