Ce guide est destinée aux utilisateurs qui souhaitent personnaliser le comportement d'un module en insérant du code JavaScript à des points spécifiques du processus d'envoi (appelés "événements" ou "hooks").

---

Guide : Activer ou Désactiver les Événements JavaScript Avancés (Hooks)

Les événements JavaScript permettent d'exécuter du code personnalisé à des moments précis de l'interaction de l'utilisateur avec le formulaire (par exemple, avant l'envoi des données ou après une erreur de validation).

ATTENTION CRITIQUE :

La zone de gestion des événements JavaScript est réservée aux utilisateurs ayant des compétences en programmation.

> Avertissement Important (du système) :

> Les paramètres suivants nécessitent des notions de JavaScript pour être utilisés. En cas de dysfonctionnement du code, le fonctionnement global du site pourrait être altéré.

---

Procédure Étape par Étape

Suivez ces étapes pour activer, désactiver ou modifier le code associé à un événement JavaScript.

1. Accéder à la Section JavaScript

1. Ouvrez le module que vous souhaitez modifier.

2. Dans le panneau de modification du module, naviguez jusqu'à l'étape intitulée Javascript.

2. Gérer l'Événement Souhaité

Dans la section Javascript, vous trouverez une liste de tous les événements disponibles. Chaque événement est présenté dans un encadré séparé.

1. Localisez l'encadré de l'événement que vous voulez gérer (par exemple, form-submit-pre).

2. Pour activer l'événement :

• Cliquez sur le bouton Attiva (bleu) situé en haut à droite de l'encadré.
• L'encadré deviendra actif.

3. Pour désactiver l'événement (et ignorer le code qu'il contient) :

• Cliquez sur le bouton Disattiva (rouge).
• L'encadré redeviendra inactif.

3. Insérer le Code JavaScript

Si vous avez activé un événement, vous devez insérer le code que vous souhaitez exécuter.

1. À l'intérieur de l'encadré de l'événement activé, vous trouverez une zone de texte (éditeur de code) entre deux blocs de code gris (<code>).

• Le bloc supérieur montre la définition de la fonction (exemple : $('form').on('event-id', function($form, {data.variable}) {).
• Le bloc inférieur montre la fermeture de la fonction (});).

2. Insérez votre code JavaScript personnalisé dans la zone de texte, en veillant à ce qu'il soit correctement encadré par les accolades de la fonction.

Informations Supplémentaires sur l'Événement

Selon l'événement que vous modifiez, vous pourriez voir des avertissements utiles :

• Si vous voyez un avertissement bleu (alert-info) :

> En retournant un tableau form_data modifié, il est possible de passer le nouveau tableau avec les valeurs modifiées aux événements suivants.

(Cela signifie que vous pouvez modifier les données du formulaire avant leur traitement).

• Si vous voyez un avertissement jaune (alert-warning) :

> En mettant un return false; à la fin de la fonction, tous les événements suivants seront bloqués.

(Cela vous permet d'interrompre le processus d'envoi du formulaire).

4. Sauvegarder les Modifications

1. Après avoir activé l'événement et inséré le code, procédez à la sauvegarde du module.

2. Cliquez sur le bouton de sauvegarde (généralement situé en bas ou dans le pied-de-page de la page d'édition) pour appliquer les modifications.

> Note : En cas d'erreurs de syntaxe dans le code JavaScript, le système pourrait vous avertir lors de la sauvegarde, mais le code sera quand même enregistré. Assurez-vous toujours que le code inséré est valide afin d'éviter tout dysfonctionnement du formulaire.