Esta guía está pensada para usuarios que desean personalizar el comportamiento de un módulo mediante la inserción de código JavaScript en puntos específicos del proceso de envío (llamados "eventos" o "hooks").

---

Guía: Activar o Desactivar Eventos JavaScript Avanzados (Hooks)

Los eventos JavaScript permiten ejecutar código personalizado en momentos específicos de la interacción del usuario con el formulario (por ejemplo, antes del envío de datos o después de un error de validación).

ATENCIÓN CRÍTICA:

El área de gestión de eventos JavaScript está destinada a usuarios con conocimientos de programación.

> Aviso Importante (del sistema):

> Las siguientes configuraciones requieren nociones de JavaScript para ser utilizadas; en caso de que el código no funcione correctamente, el funcionamiento completo del sitio podría verse alterado.

---

Procedimiento Paso a Paso

Sigue estos pasos para activar, desactivar o modificar el código asociado a un evento JavaScript.

1. Acceder a la Sección JavaScript

1. Abre el módulo que deseas modificar.

2. En el panel de edición del módulo, navega al paso titulado Javascript.

2. Gestionar el Evento Deseado

En la sección Javascript encontrarás una lista de todos los eventos disponibles. Cada evento se presenta en un recuadro separado.

1. Localiza el recuadro del evento que quieres gestionar (por ejemplo, form-submit-pre).

2. Para activar el evento:

• Haz clic en el botón Activar (azul) que se encuentra en la esquina superior derecha del recuadro.
• El recuadro se volverá activo.

3. Para desactivar el evento (y omitir el código dentro):

• Haz clic en el botón Desactivar (rojo).
• El recuadro volverá al estado inactivo.

3. Insertar el Código JavaScript

Si has activado un evento, debes insertar el código que deseas ejecutar.

1. Dentro del recuadro del evento activado, encontrarás un área de texto (editor de código) entre dos bloques de código gris (<code>).

• El bloque superior muestra la definición de la función (ejemplo: $('form').on('event-id', function($form, {data.variable}) {).
• El bloque inferior muestra el cierre de la función (});).

2. Inserta tu código JavaScript personalizado dentro del área de texto, asegurándote que esté correctamente encerrado entre las llaves de la función.

Información Adicional sobre el Evento

Dependiendo del evento que estés modificando, podrías encontrar avisos útiles:

• Si ves un aviso azul (alert-info):

> Retornando un array form_data modificado es posible pasar este nuevo array con los valores modificados a los eventos siguientes.

(Esto significa que puedes modificar los datos del formulario antes de que sean procesados).

• Si ves un aviso amarillo (alert-warning):

> Estableciendo un return false; al final de la función se bloquearán todos los eventos posteriores a este.

(Esto te permite interrumpir el proceso de envío del formulario).

4. Guardar los Cambios

1. Después de activar el evento e insertar el código, procede a guardar el módulo.

2. Haz clic en el botón guardar (usualmente ubicado al final o en el footer de la página de edición) para hacer efectivas las modificaciones.

> Nota: Si ocurren errores de sintaxis en el código JavaScript, es posible que el sistema te avise durante la guardada, pero igualmente se guardará el código. Asegúrate siempre que el código insertado sea válido para evitar fallos en el formulario.