Skip to content

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 ​

PageHooks
Events5
Guests6
Calendars4
Emails & Reminders7
Settings3
System2

All Actions ​

HookPageDescription
fluent_event/calendar/before_deletedCalendarsBefore a calendar is deleted, while its events still exist.
fluent_event/calendar/createdCalendarsAfter a new calendar is saved.
fluent_event/calendar/deletedCalendarsAfter a calendar and all of its events are deleted.
fluent_event/calendar/updatedCalendarsAfter a calendar is saved with new values.
fluent_event/event/before_deletedEventsBefore an event is deleted, while its post, guests and meta still exist.
fluent_event/event/calendar_changedEventsAfter an update moves an event to another calendar.
fluent_event/event/createdEventsAfter a new event and its post are saved.
fluent_event/event/deletedEventsAfter an event, its post, its guests and its meta are deleted.
fluent_event/event/updatedEventsAfter an event is saved with new values.
fluent_event/guest_reminders_sentEmails & RemindersAfter one reminder send for an event has gone through every guest.
fluent_event/guest/before_bulk_deletedGuestsBefore every guest of an event is deleted, as part of deleting the event.
fluent_event/guest/before_deletedGuestsBefore an admin deletes one guest.
fluent_event/guest/bulk_deletedGuestsAfter every guest of an event is deleted, as part of deleting the event.
fluent_event/guest/cancellation_sentEmails & RemindersAfter the registration cancellation email is handed to wp_mail().
fluent_event/guest/confirmation_sentEmails & RemindersAfter the registration confirmation email is handed to wp_mail().
fluent_event/guest/createdGuestsAfter a new guest row is saved.
fluent_event/guest/deletedGuestsAfter an admin deletes one guest.
fluent_event/guest/updatedGuestsAfter a guest row changes, including a member's RSVP change.
fluent_event/loadedSystemOn plugins_loaded, once the FluentEvent application has booted.
fluent_event/reschedule_event_remindersEmails & RemindersAction Scheduler job that requeues the reminders of every upcoming event, 50 events per job.
fluent_event/send_event_reminders_to_guestsEmails & RemindersAction Scheduler job that sends one reminder email to every seated guest of an event.
fluent_event/send_registration_cancellationEmails & RemindersAction Scheduler job that sends the registration cancellation email to one guest.
fluent_event/send_registration_confirmationEmails & RemindersAction Scheduler job that sends the registration confirmation email to one guest.
fluent_event/settings/email_notifications_updatedSettingsAfter the email notification settings are saved.
fluent_event/settings/email_updatedSettingsAfter the email sender settings are saved.
fluent_event/settings/general_updatedSettingsAfter the general settings are saved, or the All Events page is created.
fluent_event/update_verification_failedSystemWhen 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_deleted runs while the row still exists; deleted runs 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, with as_enqueue_async_action(), rather than doing it inside a request hook.

FluentEvent developer documentation