20.01.2025

Acciones en WordPress

En WordPress, las Acciones forman parte de la API Hooks, que permite a los desarrolladores inyectar código personalizado en puntos específicos durante la ejecución de WordPress. Las acciones permiten realizar tareas o ejecutar funciones en determinados eventos o etapas, como cuando se publica una entrada, se carga una página o se activa un tema.

Las acciones son particularmente útiles para ampliar la funcionalidad de WordPress sin alterar los archivos principales, haciendo que su sitio sea más fácil de mantener y esté preparado para el futuro.

Cómo funcionan las acciones de WordPress

Una acción se activa cuando ocurre un evento específico en WordPress, como la carga de una entrada o la publicación de un comentario. Cuando se activa una acción, se ejecutan todas las funciones vinculadas a esa acción.

Por ejemplo:

Cuando un usuario inicia sesión, WordPress activa la acción wp_login, que le permite ejecutar código personalizado cada vez que un usuario inicia sesión.
Cuando se guarda una entrada, se activa la acción save_post, que le permite añadir funciones personalizadas, como enviar un correo electrónico cuando se publica una entrada.

Registro de acciones con add_action()

Para enganchar una función a una acción, utilice la función add_action(). Esta función le dice a WordPress que ejecute una función específica cuando se dispara una acción.

Sintaxis:

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

$hook: El nombre del hook de la acción (por ejemplo, wp_login, save_post).
$function_to_add: El nombre de la función que quieres que se ejecute cuando se dispare la acción.
$priority (opcional): Se utiliza para especificar el orden en el que se deben ejecutar las funciones. Números más bajos significan mayor prioridad. Por defecto es 10.
$args_aceptados (opcional): El número de argumentos que acepta la función. Por defecto es 1.

Ejemplo:

function mi_funcion_personalizada() { // Código personalizado aquí echo “¡El usuario ha iniciado sesión!”; } add_action( ‘wp_login’, ‘mi_funcion_personalizada’ );

En este ejemplo, cuando un usuario inicia sesión, la función my_custom_function() se ejecutará, mostrando un mensaje.

Acciones comunes de WordPress

Estas son algunas de las acciones más utilizadas en WordPress:

wp_enqueue_scripts: Se utiliza para poner en cola scripts y estilos en el front-end.
init: Se activa después de que WordPress haya terminado de cargar pero antes de que se envíe ninguna cabecera. A menudo se utiliza para registrar tipos de entradas personalizadas o taxonomías.
wp_head: Activado en la sección head del tema, útil para añadir meta tags, estilos o scripts.
save_post: Se activa cuando se guarda una entrada. Puede usarse para realizar acciones adicionales como actualizar los metadatos de la entrada.
admin_init: Se dispara cuando un usuario accede al panel de administración, útil para añadir configuraciones personalizadas o inicializar características para el área de administración.

Creación de acciones personalizadas

También puedes crear tus propias acciones personalizadas. Esto permite a otros desarrolladores (o a ti mismo) enganchar funciones en puntos específicos de tu tema o plugin personalizado.

Por ejemplo:

function mi_accion_personalizada() { // Hacer algo echo “¡Acción personalizada activada!”; } do_action( ‘mi_accion_personalizada’ );

En este caso, activas el hook my_custom_action dondequiera que se coloque do_action( ‘my_custom_action’ ); y puedes enganchar funciones a él de esta forma:

add_action( ‘mi_accion_personalizada’, ‘mi_funcion_personalizada’ );

Comprender do_action() y do_action_ref_array()

do_action(): Esta función desencadena la ejecución de funciones adjuntas a una acción en particular.

Ejemplo:

do_action( ‘wp_footer’ );

do_action_ref_array(): Esta función pasa un array de argumentos por referencia a las funciones enganchadas, útil cuando se trabaja con objetos o arrays que se quieren modificar directamente.

Ejemplo:

$my_data = array( ‘clave’ => ‘valor’ ); do_action_ref_array( ‘mi_accion_personalizada’, array( &$my_data ) );

Conclusión

Las acciones de WordPress proporcionan una poderosa manera de extender la funcionalidad de WordPress enganchando funciones personalizadas a eventos específicos. Mediante el uso de acciones, los desarrolladores pueden personalizar temas, plugins y funciones básicas sin modificar el núcleo de WordPress, lo que garantiza actualizaciones sencillas y facilidad de mantenimiento. Comprender cómo utilizar y crear acciones es esencial para cualquier desarrollador de WordPress que desee crear sitios web más dinámicos y con más funciones.