Los hooks o conectores de WordPress permiten ejecutar funciones en momentos concretos del proceso de WordPress y de este modo modificar su funcionamiento y / o el resultado clásico de ese proceso. Estos conectores son la forma óptima de modificar y ampliar las funcionalidades de WP mediante plugins o el fichero functions.php.
Acciones y filtros
Los conectores se separan en 2 tipos: Acciones y filtros, las acciones se ejecutan mediante eventos de WordPress. Por ejemplo, cuando publicamos una nueva entrada se ejecuta un conector de acción. Y los conectores de filtro se usan para modificar contenido antes de mostrarlo por pantalla, guardar en la base de datos, o llamar a otra función. Por ejemplo, cuando vamos a pintar por pantalla el the_title() de una entrada antes queremos comprobar el número de caracteres del título.
add_filter( 'the_title', ' nombre_funcion' );
function nombre_funcion($var){
//tareas
return $var;
}
//Este ejemplo antes de llamar a la función the_title(), pasa por esta función
Estas funciones pueden tener hasta cuatro parámetros, siendo solo los 2 primeros obligatorios:
add_filter( ‘the_title’, ‘ nombre_funcion’ , prioridad, n_parametros);
- El nombre del filtro o acción.
- Nombre de la función que se ejecuta.
- Prioridad de la misma, imagina que hay 5 plugins llamando al mismo hook?
- Y número de argumentos que acepta la función
Además de la diferencia de funcionalidad entre los filtros y acciones, en cuanto a las funciones hay que tener en cuenta que los hooks de acción no requieren variables ni devuelve valores, pero las de filtro si (recuerda que sustituyen el comportamiento de esas variables y hay que devolverlas con los cambios realizados).
add_action('comment_post','email_nuevo_coment');
function email_nuevo_coment(){
wp_mail('imacreste@gmail.com','nuevo comentario', 'Tienes un nuevo comentario en tu blog')
}
En el ejemplo vemos que cada vez que se publica un nuevo comentario en una entrada, enviamos un mail de notificación a mi correo.
Hooks de filtro más habituales
- the_content: Se aplica al contenido de una entrada, página, o entradas personalizadas.
- the_title: Se aplica al título.
- comment_text: Al texto de los comentarios.
- wp_title: Al metadato title de la página
- the_permalink: A la Url.
- default_content: Establece un contenido por defecto.
Lo mejor es revisar las funciones en función de las necesidades en:
https://developer.wordpress.org/
Hooks de acción más habituales
- publish_post: Se ejecuta cuando se publica una nueva entrada.
- create_category: Al crear una categoría.
- admin_head: al cargar el head del admin.
- wp_head: al cargar el head del tema. Idóneo para CSS.
- wp_footer: al cargar el footer del tema. perfecto para JS.
- admin_menu: Al cargar el menú del administador de WordPress.
- init: Despúes de cargarse WP pero antes de enviar encabezados. Se suele usar para gestionar envió de información POST o GET.
- admin_init: Igual que init pero en admin.
- user_register: Al crear un usuario.
- add_meta_boxes: Al crear un metabox.
- widget_init: Se carga al iniciar los widgets.
- wp_dashboard_setup: En el momento de cargar el escritorio en el administrador.
Lo mejor es revisar las funciones en función de las necesidades en: