benecaster_sponsor_manager_after_archive_message
Fires once a sponsor message has been archived or restored on the Sponsors screen’s Messages tab, or through POST /benecaster-sponsor-manager/v1/shows/{show_id}/messages/{id}/archive or …/restore. It fires only when the write succeeded. Sponsor Manager then clears the show’s feed cache, so the message’s copy leaves the feed (or returns to it) on podcast apps’ next fetch.
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
$message_id |
int |
— | The message |
$show_id |
int |
— | The message's show |
$archived |
bool |
— | `true` when it was archived, `false` when restored |
Example
add_action( 'benecaster_sponsor_manager_after_archive_message', function ( int $message_id, int $show_id, bool $archived ): void {
my_sales_log( $show_id, $message_id, $archived ? 'archived' : 'restored' );
}, 10, 3 );
Notes
Asking for the state the message already has writes nothing and fires nothing. Walkthrough: Read or write a show's sponsor messages from code, as the Sponsors screen's Messages tab does.
Affects
- Benecaster → Sponsors → Messages
- POST benecaster-sponsor-manager/v1/shows/{show_id}/messages/{id}/archive
- POST benecaster-sponsor-manager/v1/shows/{show_id}/messages/{id}/restore
Need this built rather than just documented? See our services →