Deze gids is bedoeld voor gebruikers die het gedrag van een module willen aanpassen door JavaScript-code in te voegen op specifieke punten in het verzendproces (genaamd "evenementen" of "hooks").
Gids: Geavanceerde JavaScript-evenementen (Hooks) Inschakelen of Uitschakelen
JavaScript-evenementen maken het mogelijk om aangepaste code uit te voeren op specifieke momenten tijdens de interactie van de gebruiker met het formulier (bijvoorbeeld vóór het verzenden van gegevens of na een validatiefout).
KRITIEKE WAARSCHUWING:
Het beheergebied voor JavaScript-evenementen is bestemd voor gebruikers met programmeerkennis.
> Belangrijke waarschuwing (vanuit het systeem):
> De volgende instellingen vereisen kennis van JavaScript om te gebruiken; als de code niet werkt, kan de volledige werking van de site worden verstoord.
Stapsgewijze Procedure
Volg deze stappen om een JavaScript-evenement in te schakelen, uit te schakelen of de bijbehorende code aan te passen.
1. Toegang tot het JavaScript-gedeelte
1. Open het formulier dat je wilt wijzigen.
2. Navigeer in het bewerkingspaneel van het formulier naar de stap genaamd Javascript.
2. Beheer het Gewenste Evenement
In de sectie Javascript vind je een lijst met alle beschikbare evenementen. Elk evenement wordt weergegeven in een apart vak.
1. Zoek het vak van het evenement dat je wilt beheren (bijvoorbeeld form-submit-pre).
2. Om het evenement in te schakelen:
- Klik op de knop Inschakelen (blauw) rechtsboven in het vak.
- Het vak wordt actief.
3. Om het evenement uit te schakelen (en de code erin te negeren):
- Klik op de knop Uitschakelen (rood).
- Het vak wordt weer inactief.
3. JavaScript-code invoegen
Als je een evenement hebt ingeschakeld, moet je de code invoeren die je wilt uitvoeren.
1. Binnenin het vak van het ingeschakelde evenement vind je een tekstgebied (code-editor) tussen twee grijze codeblokken (<code>).
- Het bovenste blok toont de functiedefinitie (bijv.
$('form').on('event-id', function($form, {data.variable}) {). - Het onderste blok toont de sluiting van de functie (
});).
2. Voer je aangepaste JavaScript-code in binnen het tekstgebied, zorg ervoor dat deze correct tussen de accolades van de functie staat.
Extra informatie over het evenement
Afhankelijk van het evenement dat je wijzigt, kun je nuttige waarschuwingen tegenkomen:
- Als je een blauwe waarschuwing ziet (
alert-info):
> Door een gewijzigde array form_data terug te geven, kun je de nieuwe array met gewijzigde waarden doorgeven aan volgende evenementen.
(Dit betekent dat je formuliergegevens kunt aanpassen voordat ze worden verwerkt).
- Als je een gele waarschuwing ziet (
alert-warning):
> Door aan het einde van de functie return false; in te stellen, worden alle volgende evenementen geblokkeerd.
(Dit stelt je in staat om het verzendproces van het formulier stop te zetten).
4. Wijzigingen opslaan
1. Nadat je het evenement hebt ingeschakeld en code hebt ingevoerd, sla je het formulier op.
2. Klik op de opslaan-knop (meestal onderaan of in de footer van de bewerkingspagina) om de wijzigingen door te voeren.
> Opmerking: Als er syntaxfouten zijn in de JavaScript-code, kan het systeem je waarschuwen tijdens het opslaan, maar wordt de code toch opgeslagen. Zorg er altijd voor dat ingevoerde code geldig is om storingen in het formulier te voorkomen.







