Developer Hooks: Filters and Actions

Developers can change who uses the plugin, add countries or AI services, and run their own code when a check or a suggestion finishes. Put these in a small custom plugin or your theme’s functions.php.

Filters

FilterWhat it changes
aivbm_capabilityThe capability needed to use the plugin, its widget and its settings. Default manage_options (administrators).
aivbm_countriesThe country list for prompts, as code => name. Add or remove countries.
aivbm_providersThe AI service classes the plugin asks.
aivbm_default_settings / aivbm_sanitize_settingsDefault settings, and how saved settings are cleaned.
aivbm_admin_pagesThe plugin’s admin tabs.
aivbm_mcp_toolsThe tools offered over MCP, keyed by ability name.
aivbm_describe_suggestionA suggestion’s title, why, how and button, before it is shown.
aivbm_suggestions_generatedThe suggestions made after a run (fingerprints, run ID).

Actions

ActionWhen it fires
aivbm_loadedAfter the plugin has loaded (plugin instance).
aivbm_run_finishedWhen a check ends (run ID, final status).
aivbm_suggestion_finishedWhen a done suggestion gets its result (suggestion ID, worked or no_change).
aivbm_settings_savedAfter the settings are saved (settings array).
aivbm_results_deletedAfter all results were deleted.

Example: let editors use the plugin

add_filter( 'aivbm_capability', function () {
	return 'edit_others_posts';
} );

Example: send a Slack message when a check ends

add_action( 'aivbm_run_finished', function ( $run_id, $status ) {
	// Your code here, for example wp_remote_post() to a Slack webhook.
}, 10, 2 );