Hooks and Filters

Reference for the action and filter hooks BuddyPress Moderation Pro exposes. Signatures are taken from the plugin source; parameter order matters when you set the accepted-args count on add_action / add_filter.

Action hooks

Content flagged

Each fires when a member reports the matching content type.

Hook	Parameters
`bpmp_activity_flagged`	`$activity_id, $activity_user_id, $reporter_id, $activity_subject, $report_post_id`
`bpmp_activity_comment_flagged`	`$comment_id, $reporter_id, $comment_user_id, $report_post_id`
`bpmp_members_flagged`	`$member_id, $reporter_id, $report_post_id`
`bpmp_groups_flagged`	`$content_type, $report_post_id, $group_creator_id, $reporter_id, $group_url`
`bpmp_message_flagged`	`$message_id, $reporter_id, $message_user_id, $report_post_id`
`bpmp_topic_flagged`	`$topic_id, $topic_author, $reporter_id`
`bpmp_reply_flagged`	`$reply_id, $reply_author, $reporter_id`
`bpmp_avatar_flagged`	`$avatar_type, $report_post_id, $user_id, $item_id, $url`

For bpmp_groups_flagged, $content_type is the string 'groups'. For bpmp_avatar_flagged, $avatar_type is 'profile_avatar' or 'group_avatar', and $item_id is the user ID for profiles or the group ID for groups.

add_action( 'bpmp_activity_flagged', 'my_activity_flagged', 10, 5 );
function my_activity_flagged( $activity_id, $activity_user_id, $reporter_id, $activity_subject, $report_post_id ) {
    // React to a new activity report.
}

Member blocking

Hook	Parameters
`bmpro_user_blocked`	`$blocked_user_id, $blocking_user_id`
`bmpro_user_unblocked`	`$blocked_user_id, $blocking_user_id`

Admin and cleanup

Hook	Fires
`bmpro_add_general_settings_options`	Inside the General settings tab, to append custom fields.
`bmpro_restrictions_settings_options`	Inside the Restrictions settings tab.
`bmpro_add_group_photo_options`	Inside the group avatar settings tab.
`bmpro_create_meta_box_for_content_type`	When building the meta boxes for a reported content type.
`bmpro_spam_cleanup_filter_function`	During cleanup of a reported item.

Filter hooks

Content and buttons

Filter	Purpose
`bmpro_content_to_flag`	The settings tabs added after Welcome/General. Defaults to `restrictions`, `profile_avatar`, `reported-keyword`.
`bmpro_get_flag_unflag_text`	The flag/unflag button label.
`bmpro_get_is_enabled_flagging`	Whether flagging is enabled for the current context.
`bmpro_force_load_assets`	Force the plugin’s front-end assets to load.
`buddypress_moderation_theme_suuport`	Supported theme slugs. Defaults to `reign-theme`, `buddyx`, `buddyx-pro`. (The hook name carries the original spelling.)

Moderation behaviour

Filter	Purpose
`bmpro_auto_mod_limit_filter`	The auto-moderation report threshold.
`bmpro_auto_moderation_enable`	Whether auto-moderation is on for a component.
`bmpro_get_moderation_mode_filter`	Who can see hidden content.
`bmpro_get_post_moderation_mode_filter`	Post-level moderation mode.
`bmpro_get_activity_post_status_filter`	Resolved status for a flagged activity.
`bmpro_spam_statuses_types`	The status options used to filter the queue.
`bmpro_count_reporters_filter`	The reporter count shown for an item.
`bmpro_member_related_actions_filter`	Actions available on a reported member.
`bmpro_group_related_actions_filter`	Actions available on a reported group.
`bmpro_members_moderation_restrictions_filter`	Member restriction options.
`bmpro_groups_moderation_restrictions_filter`	Group restriction options.
`bmpro_account_lock_message_filter`	Message shown to a locked member.
`bmpro_remove_flagged_member_at_directory_page`	Whether flagged members are removed from directory listings.
`bmpro_show_activity_moderation_actions`	Whether activity moderation actions render.
`bmpro_show_group_moderation_actions`	Whether group moderation actions render.
`bmpro_show_member_moderation_actions`	Whether member moderation actions render.
`bpmp_exclude_moderated_content`	IDs excluded from front-end queries to hide moderated content.

Permissions and users

Filter	Purpose
`bmpro_user_can_report`	Whether a user may report content.
`bmpro_allow_activity_update_user_roles`	Roles allowed to moderate activity updates.
`bpmp_moderator_users`	The list of moderator user IDs.
`bpmp_get_users`	The user list used in settings selectors.
`get_blocked_users`	A user’s blocked-member list.
`bpmp_members_get_user_url`	A member’s profile URL.
`bpmp_get_edit_post_link`	The edit link for moderated content.

Notifications

Filter	Purpose
`bmpro_filter_enabled_admin_flag_email`	Whether the admin flag email is sent.
`bmpro_filter_enabled_bp_notification`	Whether the BuddyPress notification is sent.
`_bprwg_notification_text`	Notification text for moderation events.

// Raise the auto-moderation threshold.
add_filter( 'bmpro_auto_mod_limit_filter', fn( $limit ) => 10 );

// Add a supported theme.
add_filter( 'buddypress_moderation_theme_suuport', function ( $themes ) {
    $themes[] = 'my-theme';
    return $themes;
} );