Skip to main content

benecaster_guest_manager_before_change_episode_guests

Action Premium guest-manager

Fires before an episode’s guests are linked, unlinked or reordered with the guest selector on the episode editor’s Guests tab (or through the benecaster-guest-manager/v1/episodes/{id}/guests routes), once the request has validated. Not fired for a refused request or one that would write nothing.

Parameters

Name Type Default Description
$episode_id int — The episode
$change string — `link`, `unlink` or `reorder`
$guest_ids array — For `link`, the guests about to be linked (already-linked ones left out); for `unlink`, the one guest; for `reorder`, the new order

Example

add_action( 'benecaster_guest_manager_before_change_episode_guests', function ( int $episode_id, string $change, array $guest_ids ): void {
    my_plugin_log( sprintf( 'Episode %d: %s %s', $episode_id, $change, implode( ',', $guest_ids ) ) );
}, 10, 3 );

Notes

Affects

  • Episode editor → Guests

Need this built rather than just documented? See our services →