Skip to content

Guests Actions ​

6 action hooks on this page, across 12 call sites.

HookFiresCall Sites
fluent_event/guest/before_bulk_deletedBefore every guest of an event is deleted, as part of deleting the event.1
fluent_event/guest/before_deletedBefore an admin deletes one guest.1
fluent_event/guest/bulk_deletedAfter every guest of an event is deleted, as part of deleting the event.1
fluent_event/guest/createdAfter a new guest row is saved.4
fluent_event/guest/deletedAfter an admin deletes one guest.1
fluent_event/guest/updatedAfter a guest row changes, including a member's RSVP change.4

fluent_event/guest/before_bulk_deleted ​

  • Type: action
  • Call sites: 1
  • When it fires: Before every guest of an event is deleted, as part of deleting the event.

Fires from CleanupHandler::cleanEvent(), after the event's post is deleted and before its guest rows are. There is no per-guest hook on this path: read $event->guests() here if you need the rows.

Parameters ​

#NameTypeDescription
1$eventEventThe event whose guests are about to be deleted.

Call Sites ​

SourceContextArguments
fluent-event/app/Hooks/Handlers/CleanupHandlers/CleanupHandler.php:79CleanupHandler::cleanEvent()$event

Example ​

php
add_action('fluent_event/guest/before_bulk_deleted', function ($event) {
    foreach ($event->guests()->get() as $guest) {
        // Archive each guest before it is removed.
    }
});

fluent_event/guest/before_deleted ​

  • Type: action
  • Call sites: 1
  • When it fires: Before an admin deletes one guest.

Fires from DELETE /events/{eventId}/guests/{guestId} only. Deleting a whole event removes its guests in bulk and fires fluent_event/guest/before_bulk_deleted instead.

Parameters ​

#NameTypeDescription
1$guestGuestThe guest about to be deleted.

Call Sites ​

SourceContextArguments
fluent-event/app/Http/Controllers/GuestController.php:119GuestController::deleteGuest()$guest

Example ​

php
add_action('fluent_event/guest/before_deleted', function ($guest) {
    // Your code here.
}, 10, 1);

fluent_event/guest/bulk_deleted ​

  • Type: action
  • Call sites: 1
  • When it fires: After every guest of an event is deleted, as part of deleting the event.

Parameters ​

#NameTypeDescription
1$eventEventThe event whose guests were deleted.

Call Sites ​

SourceContextArguments
fluent-event/app/Hooks/Handlers/CleanupHandlers/CleanupHandler.php:83CleanupHandler::cleanEvent()$event

Example ​

php
add_action('fluent_event/guest/bulk_deleted', function ($event) {
    // Your code here.
}, 10, 1);

fluent_event/guest/created ​

  • Type: action
  • Call sites: 4
  • When it fires: After a new guest row is saved.

Fires on every path that adds a guest:

  • an admin adds a guest (source = manual);
  • a member or a visitor registers or RSVPs from the FluentCommunity portal (source = fluent_community, source_id = the community post ID);
  • anyone registers from the public event page (source = wordpress_pages).

A registration that brings back an existing not_going row fires fluent_event/guest/updated instead.

The confirmation email is queued separately, after this hook, so it is not sent yet. Check $guest->status: an RSVP can also create a not_going row.

Parameters ​

#NameTypeDescription
1$guestGuestThe saved guest. event_id, email, status and source are set.

Call Sites ​

SourceContextArguments
fluent-event/app/Http/Controllers/CommunityEventController.php:201CommunityEventController::register()$guest
fluent-event/app/Http/Controllers/CommunityEventController.php:281CommunityEventController::registerGuest()$guest
fluent-event/app/Http/Controllers/GuestController.php:57GuestController::createGuest()$guest
fluent-event/app/Http/Controllers/PortalEventController.php:80PortalEventController::registerGuest()$guest

Example ​

php
add_action('fluent_event/guest/created', function ($guest) {
    if ($guest->status !== 'going') {
        return;
    }

    // Add the guest to a FluentCRM list.
    if (function_exists('FluentCrmApi')) {
        FluentCrmApi('contacts')->createOrUpdate([
            'email'      => $guest->email,
            'first_name' => $guest->name,
            'lists'      => [3],
        ]);
    }
});

fluent_event/guest/deleted ​

  • Type: action
  • Call sites: 1
  • When it fires: After an admin deletes one guest.

The row is gone. When the admin asked for it and the guest held a seat, the cancellation email is sent right after this hook, synchronously, because a queued job could no longer load the row.

Parameters ​

#NameTypeDescription
1$guestGuestThe deleted guest, with its last values.

Call Sites ​

SourceContextArguments
fluent-event/app/Http/Controllers/GuestController.php:123GuestController::deleteGuest()$guest

Example ​

php
add_action('fluent_event/guest/deleted', function ($guest) {
    // Your code here.
}, 10, 1);

fluent_event/guest/updated ​

  • Type: action
  • Call sites: 4
  • When it fires: After a guest row changes, including a member's RSVP change.

Fires when:

  • an admin edits a guest;
  • a member changes their answer in the portal, or gives up an open registration;
  • a visitor form brings a not_going row back to going.

On the portal and visitor paths it fires only when the status really changed.

Compare $guest->status with $previousStatus to react to a status move, for example going → not_going.

Parameters ​

#NameTypeDescription
1$guestGuestThe saved guest.
2$previousStatusstringThe status before this change: going, not_going, checked_in or cancelled.

Call Sites ​

SourceContextArguments
fluent-event/app/Http/Controllers/CommunityEventController.php:203CommunityEventController::register()$guest, $previousStatus
fluent-event/app/Http/Controllers/CommunityEventController.php:283CommunityEventController::registerGuest()$guest, $previousStatus
fluent-event/app/Http/Controllers/GuestController.php:99GuestController::updateGuest()$guest, $previousStatus
fluent-event/app/Http/Controllers/PortalEventController.php:82PortalEventController::registerGuest()$guest, $previousStatus

Example ​

php
add_action('fluent_event/guest/updated', function ($guest, $previousStatus) {
    if ($previousStatus !== 'checked_in' && $guest->status === 'checked_in') {
        do_action('my_plugin/guest_arrived', $guest);
    }
}, 10, 2);

FluentEvent developer documentation