Developer Reference
Constants
| Constant | Value | Description |
|---|---|---|
SCRAPERBLOCK_VERSION | 1.0.0 | Plugin version |
SCRAPERBLOCK_PLUGIN_FILE | __FILE__ | Plugin main file path |
SCRAPERBLOCK_PLUGIN_DIR | plugin_dir_path() | Plugin directory |
SCRAPERBLOCK_PLUGIN_URL | plugin_dir_url() | Plugin URL |
Filters
| Filter | Arguments | Description |
|---|---|---|
scraperblock_bot_blocklist | $bots (array) | Modify the full list of blocked user-agent strings |
scraperblock_is_blocked | $blocked (bool), $user_agent (string) | Override block decision for a specific UA |
scraperblock_rate_limit_threshold | $limit (int), $ip (string) | Override the rate limit for a specific IP |
scraperblock_robots_txt_entries | $entries (array) | Modify robots.txt directives before output |
scraperblock_meta_tags | $tags (array) | Modify meta AI tags before output |
Actions
| Action | Arguments | Description |
|---|---|---|
scraperblock_bot_blocked | $user_agent (string), $ip (string), $reason (string) | Fires when a request is blocked |
scraperblock_rate_limit_hit | $ip (string), $count (int) | Fires when rate limit is exceeded |
Options
| Option Key | Type | Default | Description |
|---|---|---|---|
scraperblock_settings[protection_enabled] | string yes/no | yes | Master toggle |
scraperblock_settings[enable_robots_blocking] | string yes/no | yes | robots.txt directives |
scraperblock_settings[enable_htaccess_blocking] | string yes/no | no | htaccess rules |
scraperblock_settings[enable_meta_noai] | string yes/no | yes | Meta noai tags |
scraperblock_settings[enable_per_page_control] | string yes/no | yes | Per-page editor box |
scraperblock_settings[enable_rate_limit] | string yes/no | yes | Rate limiting |
scraperblock_settings[requests_per_minute] | int | 60 | Rate limit threshold |