For developers: Forms events
The forms module exposes events that are related to the data passed by the form during the submission process. To subscribe to events, we recommend using the interfaces, even if the events that fire are concrete implementations (classes).
Following is a full list of the events supported by forms:
IFormsModuleEvent
This interface is implemented by all events fired for Forms. Use it, if you want to subscribe to all of them.
Subscribe using the following code:
When you handle a generic event, no information is passed to your event handler. You can use a more specific event.
IFormEntryCreatedEvent
This interface is implemented by all events that fire after a form entry is created. There is only one such built-in event and you must subscribe to the interface rather than the class that implements it.
Subscribe using the following:
In the event handler, you can access the following information:
- The ID of the submitted form entry.
- The ID of the user submitting the form.
- The username of the user submitting the form.
- The IP address of the client that submits the form entry.
- The date/time of the form entry submission.
- The ID of the form being submitted.
- The unique (code) name of the form being submitted.
- The title of the form being submitted.
- The ID of the list of submission notification subscribers for this form.
- A collection of the form controls, which can be used to retrieve their title, values, etc.