WindCodex ScraperBlock Pro Developer Reference

Constants

Constant	Value	Description
`SCRAPERBLOCK_PRO_VERSION`	`1.0.0`	Pro version
`SCRAPERBLOCK_PLUGIN_FILE`	`__FILE__`	Plugin file path

Filter	Arguments	Description
`scraperblock_bypass_request`	`$bypass (bool), $user_agent (string), $ip (string), $remote_addr (string)`	Return `true` to let a request skip runtime blocking. By default only local WordPress loopback and Plugin Check requests are bypassed. Does not change `robots.txt` or `.htaccess` rules.
`scraperblock_log_max_entries`	`$max (int)`	Number of log entries to keep (default `5000`)

Key	Default	Description
`behavioral_detection`	`yes`	Enable behavioral analysis
`content_poisoning`	`no`	Enable content poisoning
`honeypot_traps`	`yes`	Enable honeypot traps
`geo_blocking`	`no`	Enable country blocking
`blocked_countries`	`[]`	Blocked country codes
`realtime_threat_feed`	`yes`	Subscribe to threat feed
`email_alerts`	`no`	Enable email notifications
`alert_email`	`''`	Alert recipient
`multisite_support`	`no`	Network-wide management
`woocommerce_protection`	`no`	WooCommerce endpoint protection
`woocommerce_strict_rate_limit`	`yes`	Stricter WC rate limit
`woocommerce_requests_per_minute`	`120`	WC rate limit threshold
`enable_ip_access_control`	`no`	IP allowlist/blocklist
`blocked_ips`	`[]`	Blocked IPs/ranges
`whitelisted_ips`	`[]`	Allowed IPs/ranges
`block_scheduling`	`no`	Time-based blocking
`active_hours_start`	`00:00`	Block active start
`active_hours_end`	`23:59`	Block active end
`allow_ai_search_bots`	`no`	Allow AI search and assistant bots