Ganchos de WordPress: acciones y filtros

WordPress permite a los desarrolladores agregar fácilmente su propio código personalizado en el núcleo, temas y complementos de WordPress a través de enlaces de WordPress. En este artículo, brindaremos información detallada sobre los ganchos de WordPress y sus tipos, es decir, acciones y filtros.

Definición

Los ganchos de WordPress se utilizan para agregar su propio código personalizado o modificar lo que hace o genera WordPress. Hay dos tipos de ganchos en WordPress.

Un acción es un gancho que se activa en un momento específico cuando WordPress se está ejecutando y le permite realizar la acción. Incluye cosas como crear un widget cuando WordPress se está inicializando.

A filtrar es un gancho que le permite obtener y modificar datos de WordPress antes de almacenarlos en la base de datos o enviarlos al navegador. Un ejemplo de filtros incluye personalizar cómo se muestran los expertos o agregar algún código personalizado al final de una publicación de blog.

A continuación se detallan algunos métodos para solucionar el error.

Agregar o quitar función personalizada

El proceso es sencillo de conectar a su función. Para actuar, necesita saber el nombre del gancho y cuándo se ejecuta. Para Filter, también necesita saber el nombre del gancho, pero quiere saber qué valor desea obtener o devolver. El último bit es una función donde tienes todo tu código.

Engancharse a una acción

add_action( $hook, $function_name, $priority, $accepted_args );

En add_action, los parámetros requeridos son $hook, que es el nombre del gancho y $function_name, que será el nombre de la función. La prioridad es el valor entero opcional, que va del 1 al 999. Una prioridad más alta significa que se ejecutará más tarde y una prioridad más baja significa que se ejecutará antes. El último parámetro se utiliza con menos frecuencia. Es por si necesita pasar o aceptar múltiples argumentos.

Enganche a un filtro

add_filter( $tag, $function_name, $priority, $accepted_args );

add_filter funciona de la misma manera que add_aciton. A veces, un gancho existe como acción y filtro, o como filtro y función. En los parámetros $function_name obtiene un valor y regresa al final de la función. La acción simplemente ejecuta el código y no devuelve nada.

Desconectar de Acciones/Filtros

Quitar un anzuelo es sencillo. Utilice remove_action o remove_filter junto con el nombre del enlace, la función y la prioridad. La prioridad es opcional y si tienes que desenganchar la función que está enganchada más de una vez y quieres eliminar una aparición específica de esa función.

remove_action( $tag, $function_to_remove, $priority );

remove_filter( $tag, $function_to_remove, $priority );

Ejemplos

Hay muchos ganchos que existen en WordPress. A continuación se muestran algunos ejemplos de ello.

Registre un menú personalizado en el administrador

function register_my_custom_menu_page() {
 add_menu_page( 'custom menu title', 'custom menu', 'manage_options', 'myplugin/myplugin-admin.php', '', 'dashicons-admin-site', 6 );
}
add_action( 'admin_menu', 'register_my_custom_menu_page' );

En el ejemplo anterior, puedes ver la función. “registrarse_mi_página_menú_personalizado” estar enganchado al gancho de acción admin_menu. Esto le permite ejecutar el código cuando se genera la vista de administrador. Este es el gancho más utilizado en WordPress.

Cambiar la longitud del extracto

function excerpt_length_example( $words ) {
 return 15;
}
add_filter( 'excerpt_length', 'excerpt_length_example' );

En el ejemplo anterior, estamos usando el filtro excerpt_length, que devuelve un número entero que determina la longitud utilizada con the_excerpt().

Este artículo es muy básico para los ganchos de WordPress. Hay varios ganchos disponibles para las páginas de WooCommerce.