Questa guida è pensata per utenti che desiderano personalizzare il comportamento di un modulo tramite l'inserimento di codice JavaScript in punti specifici del processo di invio (chiamati "eventi" o "hook").
Guida: Attivare o Disattivare Eventi JavaScript Avanzati (Hooks)
Gli eventi JavaScript permettono di eseguire codice personalizzato in momenti specifici dell'interazione dell'utente con il modulo (ad esempio, prima dell'invio dei dati o dopo un errore di validazione).
ATTENZIONE CRITICA:
L'area di gestione degli eventi JavaScript è destinata a utenti con competenze di programmazione.
> Avviso Importante (dal sistema):
> Le seguenti impostazioni richiedono delle nozioni di JavaScript per essere utilizzate, nel caso in cui il codice non risulti funzionante l'intero funzionamento del sito potrebbe risultare alterato.
Procedura Passo-Passo
Segui questi passaggi per attivare, disattivare o modificare il codice associato a un evento JavaScript.
1. Accedere alla Sezione JavaScript
1. Apri il modulo che desideri modificare.
2. Nel pannello di modifica del modulo, naviga al passo intitolato Javascript.
2. Gestire l'Evento Desiderato
Nella sezione Javascript troverai un elenco di tutti gli eventi disponibili. Ogni evento è presentato in un riquadro separato.
1. Individua il riquadro dell'evento che vuoi gestire (ad esempio, form-submit-pre).
2. Per attivare l'evento:
- Fai clic sul pulsante Attiva (blu) che trovi nell'angolo in alto a destra del riquadro.
- Il riquadro diventerà attivo.
3. Per disattivare l'evento (e ignorare il codice al suo interno):
- Fai clic sul pulsante Disattiva (rosso).
- Il riquadro tornerà allo stato inattivo.
3. Inserire il Codice JavaScript
Se hai attivato un evento, devi inserire il codice che desideri eseguire.
1. All'interno del riquadro dell'evento attivato, troverai un'area di testo (editor di codice) tra due blocchi di codice grigio (<code>).
- Il blocco superiore mostra la definizione della funzione (es.
$('form').on('event-id', function($form, {data.variabile}) {). - Il blocco inferiore mostra la chiusura della funzione (
});).
2. Inserisci il tuo codice JavaScript personalizzato all'interno dell'area di testo, assicurandoti che sia racchiuso correttamente tra le parentesi graffe della funzione.
Informazioni Aggiuntive sull'Evento
A seconda dell'evento che stai modificando, potresti trovare degli avvisi utili:
- Se vedi un avviso in blu (
alert-info):
> Ritornando un array form\_data modificato è possibile passare il nuovo array con i valori modificati agli eventi successivi.
(Questo significa che puoi modificare i dati del modulo prima che vengano elaborati).
- Se vedi un avviso in giallo (
alert-warning):
> Impostando un return false; alla fine della funzione verranno bloccati tutti gli eventi successivi a questo.
(Questo ti permette di interrompere il processo di invio del modulo).
4. Salvare le Modifiche
1. Dopo aver attivato l'evento e inserito il codice, procedi con il salvataggio del modulo.
2. Fai clic sul pulsante di salvataggio (solitamente situato in fondo o nel footer della pagina di modifica) per rendere effettive le modifiche.
> Nota: Se si verificano errori di sintassi nel codice JavaScript, il sistema potrebbe avvisarti durante il salvataggio, ma il codice verrà comunque salvato. Assicurati sempre che il codice inserito sia valido per evitare malfunzionamenti del modulo.
