Actions Hooks
Actions let your code run when something happens in FluentEvent: an event is created, a guest registers, a reminder batch goes out. FluentEvent has 27 action hooks. 4 of them are run by Action Scheduler rather than by a do_action() call.
Every hook name starts with fluent_event/. Nouns and verbs are separated by /: fluent_event/<noun>/<verb> for lifecycle actions, fluent_event/<noun>_api_response for response filters.
Pages
| Page | Hooks |
|---|---|
| Events | 5 |
| Guests | 6 |
| Calendars | 4 |
| Emails & Reminders | 7 |
| Settings | 3 |
| System | 2 |
All Actions
| Hook | Page | Description |
|---|---|---|
fluent_event/calendar/before_deleted | Calendars | Before a calendar is deleted, while its events still exist. |
fluent_event/calendar/created | Calendars | After a new calendar is saved. |
fluent_event/calendar/deleted | Calendars | After a calendar and all of its events are deleted. |
fluent_event/calendar/updated | Calendars | After a calendar is saved with new values. |
fluent_event/event/before_deleted | Events | Before an event is deleted, while its post, guests and meta still exist. |
fluent_event/event/calendar_changed | Events | After an update moves an event to another calendar. |
fluent_event/event/created | Events | After a new event and its post are saved. |
fluent_event/event/deleted | Events | After an event, its post, its guests and its meta are deleted. |
fluent_event/event/updated | Events | After an event is saved with new values. |
fluent_event/guest_reminders_sent | Emails & Reminders | After one reminder send for an event has gone through every guest. |
fluent_event/guest/before_bulk_deleted | Guests | Before every guest of an event is deleted, as part of deleting the event. |
fluent_event/guest/before_deleted | Guests | Before an admin deletes one guest. |
fluent_event/guest/bulk_deleted | Guests | After every guest of an event is deleted, as part of deleting the event. |
fluent_event/guest/cancellation_sent | Emails & Reminders | After the registration cancellation email is handed to wp_mail(). |
fluent_event/guest/confirmation_sent | Emails & Reminders | After the registration confirmation email is handed to wp_mail(). |
fluent_event/guest/created | Guests | After a new guest row is saved. |
fluent_event/guest/deleted | Guests | After an admin deletes one guest. |
fluent_event/guest/updated | Guests | After a guest row changes, including a member's RSVP change. |
fluent_event/loaded | System | On plugins_loaded, once the FluentEvent application has booted. |
fluent_event/reschedule_event_reminders | Emails & Reminders | Action Scheduler job that requeues the reminders of every upcoming event, 50 events per job. |
fluent_event/send_event_reminders_to_guests | Emails & Reminders | Action Scheduler job that sends one reminder email to every seated guest of an event. |
fluent_event/send_registration_cancellation | Emails & Reminders | Action Scheduler job that sends the registration cancellation email to one guest. |
fluent_event/send_registration_confirmation | Emails & Reminders | Action Scheduler job that sends the registration confirmation email to one guest. |
fluent_event/settings/email_notifications_updated | Settings | After the email notification settings are saved. |
fluent_event/settings/email_updated | Settings | After the email sender settings are saved. |
fluent_event/settings/general_updated | Settings | After the general settings are saved, or the All Events page is created. |
fluent_event/update_verification_failed | System | When a downloaded plugin update fails its checksum check and is not installed. |
Before You Hook In
- Controllers fire the hooks. A service never fires a request hook, so one REST call fires each hook once. The exceptions are paths with no controller: the cleanup handler, the FluentCommunity bridge and the Action Scheduler jobs.
- Deletes fire twice.
before_deletedruns while the row still exists;deletedruns after it is gone. Read related data in the first one. - Background work goes through Action Scheduler, group
fluent-event. Queue your own slow work there too, withas_enqueue_async_action(), rather than doing it inside a request hook.