15.01.2025

¿Qué son los ganchos de WordPress ?

Los hooks de WordPress son una parte esencial del marco de desarrollo de WordPress, permitiendo a los desarrolladores interactuar con la funcionalidad central de WordPress sin modificar los archivos centrales. Usando hooks, puedes añadir o modificar funcionalidades en temas y plugins. Hay dos tipos principales de hooks: Action Hooks y Filter Hooks. Aquí tienes un desglose de lo que son y cómo usarlos.

Qué son los ganchos de WordPress?

Los ganchos son puntos predefinidos en WordPress que le permiten “engancharse” a las funciones de WordPress y ejecutar código personalizado. Esto le permite modificar o ampliar la funcionalidad del núcleo de WordPress, temas y plugins sin editar directamente los archivos originales.

Hay dos tipos principales de hooks:

Ganchos de acción: Permiten añadir o ejecutar código personalizado en puntos específicos durante la ejecución de WordPress (por ejemplo, cuando se publica un post o cuando se carga una página).
Ganchos de Filtro: Le permiten modificar o manipular datos antes de que se envíen al navegador o se guarden en la base de datos (por ejemplo, modificando el contenido o cambiando la salida).

1. Ganchos de acción

Los ganchos de acción se activan en varios puntos durante el funcionamiento de WordPress. Permiten añadir funcionalidad en etapas específicas del proceso de carga de WordPress o cuando ocurren ciertos eventos (como publicar una entrada o mostrar el pie de página).

Cómo usar los Action Hooks:

Para usar un action hook, use la función add_action() en el archivo functions.php de su tema o en un plugin personalizado. Esta función vincula tu función personalizada a un hook específico.

Sintaxis:

add_action( ‘nombre_gancho’, ‘tu_funcion_personalizada’ ); function tu_funcion_personalizada() { // Tu código personalizado aquí. }

Ejemplo:

Digamos que quieres añadir contenido personalizado al final de cada post:

add_action( ‘the_content’, ‘add_custom_content’ ); function add_custom_content( $content ) { if ( is_single() ) { $content .= ‘

¡Gracias por leer!

‘; } return $content; }

En este ejemplo, the_content es el gancho que activa la función para añadir contenido personalizado al final de cada entrada.

2. Ganchos de filtro

Los ganchos de filtro permiten modificar la salida de los datos antes de que se muestren en la pantalla o se guarden en la base de datos. Los filtros reciben datos, los modifican y los devuelven.

Cómo utilizar los ganchos de filtro:

Para utilizar un gancho de filtro, se utiliza la función add_filter(), que aplica una función personalizada para modificar un contenido específico.

Sintaxis:

add_filter( ‘hook_name’, ‘your_custom_filter_function’ ); function your_custom_filter_function( $content ) { // Modificar el contenido. return $modified_content; }

Ejemplo:

Digamos que quieres cambiar el título de cada post para que esté en mayúsculas:

add_filter( ‘the_title’, ‘uppercase_post_title’ ); function uppercase_post_title( $title ) { return strtoupper( $title ); }

En este ejemplo, the_title es el hook que filtra los títulos de las entradas, y la función uppercase_post_title() convierte todos los títulos a mayúsculas.

Ganchos populares de WordPress

Estos son algunos de los hooks más utilizados en WordPress:

Action Hooks:

wp_enqueue_scripts: Utilízalo para añadir o eliminar scripts y estilos.
init: Se ejecuta después de que WordPress haya terminado de cargar pero antes de que se envíe ninguna cabecera.
wp_footer: Ejecuta código justo antes de la etiqueta de cierre en tu tema.
publish_post: Se dispara cuando se publica un post.

Ganchos de filtro:

the_content: Permite filtrar el contenido del post antes de que se muestre.
the_title: Permite modificar los títulos de las entradas.
excerpt_length: Permite modificar la longitud de los extractos de los post.
wp_nav_menu_items: Filtra la salida de los elementos del menú de navegación.

Buenas prácticas para el uso de ganchos

Evite editar los archivos principales: Utilice siempre ganchos en temas o plugins personalizados para mantener la compatibilidad con futuras actualizaciones.
Nombres de función únicos: Utilice siempre nombres únicos para sus funciones personalizadas para evitar conflictos con otros plugins o temas.
Utilice lógica condicional: Cuando uses hooks, utiliza comprobaciones condicionales como is_single() o is_admin() para asegurarte de que tu código se ejecuta sólo cuando es necesario.

Conclusión

Los hooks de WordPress (tanto los hooks de acción como los hooks de filtro) son una potente herramienta para personalizar y ampliar la funcionalidad de su sitio web. Usando hooks, puede añadir características personalizadas sin modificar los archivos principales, haciendo su sitio web más flexible y fácil de mantener. Entender cómo y cuándo usar hooks es clave para desarrollar temas y plugins de WordPress eficientes.