Blackhole for Bad Bots 3.9 has 6 actions and 38 filters, read directly from its source code on Nov 17, 2026. The list updates automatically when a new version is released.
How to use these hooks
Actions let you run your own code at a specific moment. Filters let you change a value before the plugin uses it. Put your code in a child theme's functions.php or a code-snippets plugin, never in the plugin's own files, because updates overwrite them.
// Run your own code when Blackhole for Bad Bots fires an action
add_action( 'blackhole_badbots_contextual_help', function( $screen ) {
// Your code runs here.
}, 10, 1 );
// Change a value Blackhole for Bad Bots is about to use
add_filter( 'blackhole_admin_footer_text', function( $array ) {
// Change $array here.
return $array;
}, 10, 1 );Parts of a name in {braces} are filled in at runtime (for example a post type or field ID). Choose Example on any hook for a ready-to-edit snippet.
All hooks
-
blackhole_alert_headers
filterapply_filters( 'blackhole_alert_headers', $headers, $vars ); -
blackhole_alert_message
filterapply_filters( 'blackhole_alert_message', $message, $vars ); -
blackhole_alert_name
filterapply_filters( 'blackhole_alert_name', get_option('blogname') ); -
blackhole_alert_subject
filterapply_filters( 'blackhole_alert_subject', __('Bad Bot Alert at ', 'blackhole-bad-bots') . $name .' @ '. $domain ); -
blackhole_badbots
filterapply_filters( 'blackhole_badbots', $blackhole_badbots ); -
do_action( 'blackhole_badbots_contextual_help', $screen ); -
blackhole_block_connection
filterapply_filters( 'blackhole_block_connection', 'Connection: Close' ); -
blackhole_block_protocol
filterapply_filters( 'blackhole_block_protocol', 'HTTP/1.1' ); -
blackhole_block_status
filterapply_filters( 'blackhole_block_status', '403' ); -
blackhole_check_date_expired
filterapply_filters( 'blackhole_check_date_expired', '2026-12-20' ); -
blackhole_custom_dir
filterapply_filters( 'blackhole_custom_dir', 'blackhole' ); -
blackhole_dash_icon
filterapply_filters( 'blackhole_dash_icon', 'dashicons-shield-alt' ); -
blackhole_default_ips
filterapply_filters( 'blackhole_default_ips', $ips ); -
blackhole_default_uas
filterapply_filters( 'blackhole_default_uas', $uas ); -
blackhole_delete_bot
actiondo_action( 'blackhole_delete_bot', $bot_id, $bot_ip, $badbots_update ); -
blackhole_domain
filterapply_filters( 'blackhole_domain', $http_host, $server_name ); -
blackhole_email_address
filterapply_filters( 'blackhole_email_address', $address ); -
blackhole_enable_host_check
filterapply_filters( 'blackhole_enable_host_check', true ); -
blackhole_get_badbots
filterapply_filters( 'blackhole_get_badbots', $bbb_badbots ); -
blackhole_get_options
filterapply_filters( 'blackhole_get_options', $bbb_options ); -
blackhole_ignore_backend
filterapply_filters( 'blackhole_ignore_backend', true ); -
blackhole_ignore_loggedin
filterapply_filters( 'blackhole_ignore_loggedin', false ); -
blackhole_ignore_login
filterapply_filters( 'blackhole_ignore_login', true ); -
blackhole_ip_filter
filterapply_filters( 'blackhole_ip_filter', $options ); -
blackhole_log
filterapply_filters( 'blackhole_log', $log, $vars ); -
blackhole_log_bot
actiondo_action( 'blackhole_log_bot', $log, $vars ); -
blackhole_log_data
filterapply_filters( 'blackhole_log_data', $data, $key, $val ); -
blackhole_message_custom
filterapply_filters( 'blackhole_message_custom', $message ); -
blackhole_message_default
filterapply_filters( 'blackhole_message_default', $message ); -
blackhole_message_nothing
filterapply_filters( 'blackhole_message_nothing', $message ); -
blackhole_needle
filterapply_filters( 'blackhole_needle', 'ip_address', $vars, $bbb_badbots ); -
blackhole_options
filterapply_filters( 'blackhole_options', $blackhole_options ); -
blackhole_reset_badbots
actiondo_action( 'blackhole_reset_badbots', $badbots_update, $badbots_default ); -
blackhole_reset_options
actiondo_action( 'blackhole_reset_options', $options_update, $options_default ); -
blackhole_robots_rules
filterapply_filters( 'blackhole_robots_rules', $rules, $path ); -
do_action( 'blackhole_settings_contextual_help', $screen ); -
blackhole_template_filename
filterapply_filters( 'blackhole_template_filename', 'blackhole-template' ); -
blackhole_trigger
filterapply_filters( 'blackhole_trigger', $link, $text, $title, $href, $nonce ); -
blackhole_validate_ip_log
filterapply_filters( 'blackhole_validate_ip_log', 'Invalid IP Address: '. $ip, $ip ); -
blackhole_vars
filterapply_filters( 'blackhole_vars', $vars ); -
blackhole_verify_nonce
filterapply_filters( 'blackhole_verify_nonce', $verify ); -
blackhole_whois_port
filterapply_filters( 'blackhole_whois_port', 43 ); -
blackhole_whois_server
filterapply_filters( 'blackhole_whois_server', 'whois.arin.net' );
Generated from Blackhole for Bad Bots's GPL-licensed source code. Hooks inside bundled third-party libraries are not listed.
Can't find the right hook?
We can build the customisation for you. Describe what you need: