Los add_action hooks de WordPress en detalle: ejemplos y buenas prácticas

En el desarrollo de WordPress, elGanchosWordPress ofrece dos tipos principales de ganchos:Ganchos de acción y ganchos de filtro. Entre ellasañadir_acción Se utiliza para añadir ganchos de acción, que permiten ejecutar funciones personalizadas en momentos específicos del tiempo de ejecución de WordPress.

En este artículo se explica cómo utilizar la función añadir_acción y enumera algunos escenarios de aplicación comunes y ejemplos de ganchos.

¿De qué se trata? `añadir_acción` ¿Gancho?

En WordPress.ganchosson puntos predeterminados para realizar funciones específicas. Cuando WordPress realiza determinadas acciones, los desarrolladores pueden utilizar ganchos para insertar la funciónCódigo personalizado.añadir_acción es uno de los tipos de hook que se utilizan cuando se desencadenan determinados eventos cuando la aplicaciónFunciones personalizadas.

hacer uso de añadir_acción Cuando lo haga, deberá especificarlo:

Nombre del ganchoEl nombre del acontecimiento.
Función de devolución de llamadaUna función personalizada que se ejecuta cuando se activa el evento.
Prioridad(Opcional) Determina el orden en que se ejecutan los ganchos; el valor predeterminado es 10.
Argumentos (Argumentos aceptados)(Opcional) Define el número de parámetros pasados a la función callback.

uso básico

Definición de funciones callbackEn primer lugar, es necesario definir una función de devolución de llamada. Este es el código que el sistema ejecutará cuando se active un gancho. Por ejemplo

añadir_acción La sintaxis básica es la siguiente:

php
add_action( 'nombre del gancho', 'función de devolución de llamada', prioridad, número de argumentos );

Ejemplo:

php
function mi_funcion_personalizada() {
    echo '¡Hola, Mundo!
}
add_action( 'wp_footer', 'my_custom_function' ); }

En este ejemplo, cuando WordPress ejecuta el comando wp_footer Se llama a los ganchos cuando el mi_función_personalizada en la parte inferior de la página y genera el valor Hola, mundo..

común `añadir_acción` Ejemplo de gancho

1. wp_head

wp_head es un hook común en los temas de WordPress que permite al desarrollador añadir un nuevo hook al hook de la página <head> Inserta parcialmente contenido personalizado. Se utiliza generalmente para insertar CSS, JavaScript, metaetiquetas, etc.

php
function add_custom_css() {
    echo ''; }
}
add_action( 'wp_head', 'add_custom_css' );

2. wp_footer

wp_footer es otro gancho común que, cuando se activa, suele estar situado en la página

sección. Puede insertar JavaScript personalizado, código de análisis y mucho más.

php
function add_tracking_code() {
    echo ''; }
}
add_action( 'wp_footer', 'add_tracking_code' ); }

3. init

init El gancho está en uno de los primeros puntos en el tiempo después de que WordPress haya terminado de cargar. Puedes usar este hook para inicializar la configuración del plugin, registrar tipos de entradas o taxonomías personalizadas, etc.

php
function mi_plugin_init() {
    // Registrar un tipo de entrada personalizado
    register_post_type( 'mi_tipo_post_personalizado', [
        'labels' => [
            'name' => 'Mis tipos de post personalizados',
            'singular_name' => 'Custom Post Type'
        ], 'public' => true, 'post_type', 'custom_post_type'
        
    ]);
}
add_action( 'init', 'my_plugin_init' );

4. admin_menu

admin_menu Los hooks se utilizan para añadir menús personalizados al backend de administración de WordPress. Este hook se utiliza normalmente para el desarrollo de plugins para ayudar a los desarrolladores a crear páginas de administración.

php
function mi_menu_personalizado() {
    add_menu_page( 'Mi página personalizada', 'Menú personalizado', 'manage_options', 'custom-page', 'my_custom_page_function' );
}
add_action( 'admin_menu', 'my_custom_menu' ); }

function mi_pagina_personalizada() {
    echo '<h1>¡Bienvenido a Mi Página Personalizada!</h1>';
}

5. guardar_post

guardar_post es un hook muy útil que se activa al guardar una entrada. Puedes usar este hook para realizar acciones como guardar automáticamente campos personalizados o realizar otras lógicas.

php
function mi_salvar_post_action( $post_id ) {
    if ( defined('DOING_AUTOSAVE') && DOING_AUTOSAVE ) return $post_id ;
    ¡if ( get_post_type( $post_id ) ! = 'post' ) return $post_id;

    // Realizar la acción personalizada
    update_post_meta( $post_id, '_my_custom_meta_key', 'Algún valor personalizado' ); }
}
add_action( 'save_post', 'my_save_post_action' ); }

Establecimiento de prioridades y parámetros

1. prioridad

añadir_acción Los hooks permiten especificar una prioridad para cada función callback. La prioridad por defecto es 10. Ajustando la prioridad, los desarrolladores pueden controlar el orden en que se ejecutan varias funciones en el mismo hook. Las funciones callback con valores de prioridad menores se ejecutan primero.

php
function mi_primera_funcion() {
    echo '¡Primero!
}
add_action( 'wp_footer', 'my_first_function', 5 ); // prioridad 5

function mi_segunda_funcion() {
    echo '¡Segundo!
}
add_action( 'wp_footer', 'my_second_function', 15 ); // prioridad 15

En este ejemplo, elmi_primera_función se ejecutará primero porque tiene menor prioridad.

2. paramétrico

Algunos hooks pasan parámetros a la función callback. Puede pasar parámetros a la función de devolución de llamada a través de la función cargas_aceptadas para especificar el número de argumentos aceptados por la función callback. Ejemplo:

php
function mi_comentario_personalizado( $coment_id ) {
    // Realiza la acción asociada al comentario
    echo "El ID del comentario es: $comment_id"; }
}
add_action( 'comment_post', 'my_custom_comment_function', 10, 1 );

resúmenes

añadir_acción es una característica extremadamente potente de WordPress que permite a los desarrolladores insertar lógica personalizada en el ciclo de vida de WordPress. Ya sea añadiendo un menú, registrando un tipo de entrada personalizado o insertando código en una parte específica de una página, la funciónañadir_acción Todos ellos pueden ayudarle a alcanzar un alto grado de personalización.

Mediante el dominio de añadir_acción Con el uso de hooks, los desarrolladores pueden crear funciones más ricas y flexibles en WordPress. Esperamos que este artículo te ayude a entender y utilizar mejor el sistema de hooks de WordPress.

Contacte con nosotros
¿No puede leer el tutorial? Póngase en contacto con nosotros para obtener una respuesta gratuita. Ayuda gratuita para sitios personales y de pequeñas empresas	Servicio de atención al cliente WeChat
① Tel: 020-2206-9892
② QQ咨询：1025174874
(iii) Correo electrónico: info@361sale.com
④ Horario de trabajo: de lunes a viernes, de 9:30 a 18:30, días festivos libres