[{"data":1,"prerenderedAt":398},["ShallowReactive",2],{"docs-\u002Fdocs\u002Fwordpress-reference":3,"docs-nav":375},{"id":4,"title":5,"body":6,"description":365,"extension":366,"meta":367,"navigation":368,"order":369,"path":370,"section":371,"seo":372,"stem":373,"__hash__":374},"docs\u002Fdocs\u002Fwordpress-reference.md","WordPress Plugin – Settings Guide",{"type":7,"value":8,"toc":342},"minimark",[9,14,23,39,42,46,51,59,69,71,75,78,86,98,100,104,107,113,118,120,124,127,132,142,145,148,150,154,158,161,174,177,179,183,186,190,192,196,199,203,205,209,212,219,221,225,228,230,234,237,242,244,248,251,254,258,260,264,271,273,276,279,314,316,320,323,339],[10,11,13],"h2",{"id":12},"opening-the-settings-panel","Opening the settings panel",[15,16,17,18,22],"p",{},"After activating the plugin, go to ",[19,20,21],"strong",{},"WP Admin → Blockbots"," in the left sidebar. The settings page has two tabs:",[24,25,26,33],"ul",{},[27,28,29,32],"li",{},[19,30,31],{},"Free Features"," — available to all users",[27,34,35,38],{},[19,36,37],{},"Pro Features"," — unlocked with an API key",[40,41],"hr",{},[10,43,45],{"id":44},"free-features-tab","Free Features tab",[47,48,50],"h3",{"id":49},"protect-wp-login-page","Protect WP Login Page",[15,52,53,54,58],{},"Enables bot verification on ",[55,56,57],"code",{},"wp-login.php",". When turned on, any visitor trying to access the WordPress login page will go through the same bot check as the rest of your site.",[15,60,61,64,65,68],{},[19,62,63],{},"Recommended:"," Turn on if you receive brute-force login attempts.\n",[19,66,67],{},"Default:"," OFF",[40,70],{},[47,72,74],{"id":73},"ignore-logged-in-users","Ignore Logged-In Users",[15,76,77],{},"When enabled, any visitor who is already logged in to WordPress bypasses the bot check entirely.",[15,79,80,82,83,85],{},[19,81,63],{}," Keep this ON. If you turn it off, admins and editors will also be checked on every page load, which may cause issues.\n",[19,84,67],{}," ON",[87,88,89],"blockquote",{},[15,90,91,92,97],{},"If you ever get locked out of your site, see ",[93,94,96],"a",{"href":95},"#locked-out","Troubleshooting lockout",".",[40,99],{},[47,101,103],{"id":102},"block-known-bad-bots","Block Known Bad Bots",[15,105,106],{},"Blocks all user agents that are not in the whitelist. Any request from a user agent not recognized as a legitimate browser or search engine is automatically rejected.",[15,108,109,110,97],{},"This setting works through the whitelist — you do not need to manually add blocked agents, only agents you want to ",[19,111,112],{},"allow",[15,114,115,117],{},[19,116,67],{}," ON (always active)",[40,119],{},[47,121,123],{"id":122},"whitelist-user-agents","Whitelist User Agents",[15,125,126],{},"A text area where you can add additional user agents that should always be allowed through, one per line. These are added on top of the built-in whitelist (Googlebot, Bingbot, etc.).",[15,128,129],{},[19,130,131],{},"Example — allow your uptime monitor:",[133,134,139],"pre",{"className":135,"code":137,"language":138},[136],"language-text","MyUptimeService\nStatusCakeBot\n","text",[55,140,137],{"__ignoreMap":141},"",[15,143,144],{},"Matching is case-insensitive and uses partial (substring) matching — you only need to enter part of the user agent string.",[15,146,147],{},"Your browser's current user agent is displayed below the text area for reference, which is useful if you need to whitelist a specific tool you're using.",[40,149],{},[10,151,153],{"id":152},"pro-features-tab","Pro Features tab",[47,155,157],{"id":156},"api-key","API Key",[15,159,160],{},"Enter your BlockBots API key here to unlock all PRO features. The field shows a masked version once saved (first 4 and last 4 characters visible).",[15,162,163,166,167,173],{},[19,164,165],{},"Where to get your key:"," ",[93,168,172],{"href":169,"rel":170},"https:\u002F\u002Fpanel.blockbots.org",[171],"nofollow","panel.blockbots.org"," → your account dashboard.",[15,175,176],{},"Once a valid key is entered and saved, all PRO toggles below become active.",[40,178],{},[47,180,182],{"id":181},"detect-all-bots-by-signatures","Detect All Bots by Signatures",[15,184,185],{},"Enables advanced deep bot detection using behavioral analysis and signature matching. Goes beyond simple user-agent checks to catch bots that mimic real browsers.",[15,187,188,85],{},[19,189,63],{},[40,191],{},[47,193,195],{"id":194},"real-time-cloud-protection","Real-time Cloud Protection",[15,197,198],{},"Checks each visitor's IP against a live cloud database of known malicious bots, scrapers, and bad actors. Decisions are made in real time before the page loads.",[15,200,201,85],{},[19,202,63],{},[40,204],{},[47,206,208],{"id":207},"detect-vpn-connection","Detect VPN Connection",[15,210,211],{},"Identifies visitors connecting through VPN services and blocks them. Useful for ad fraud prevention and reducing fake signups.",[15,213,214,215,218],{},"Turn this ",[19,216,217],{},"OFF"," if a significant portion of your legitimate audience uses VPNs (e.g., corporate users, privacy-conscious users).",[40,220],{},[47,222,224],{"id":223},"detect-proxy-connection","Detect Proxy Connection",[15,226,227],{},"Identifies visitors using proxy servers — including open proxies, datacenter proxies, and residential proxies — and blocks them.",[40,229],{},[47,231,233],{"id":232},"detect-emulators","Detect Emulators",[15,235,236],{},"Identifies headless browsers and browser automation tools such as Puppeteer, Selenium, and Playwright that are pretending to be real users.",[15,238,239,241],{},[19,240,63],{}," ON for most sites.",[40,243],{},[47,245,247],{"id":246},"show-loading-indicator","Show Loading Indicator",[15,249,250],{},"Displays an animated loading overlay to the visitor while the cloud verification runs in the background. The overlay disappears automatically once verification completes (typically under 1–2 seconds).",[15,252,253],{},"Turning this off means the page appears to hang briefly with no visual feedback. Keeping it on provides a smoother user experience.",[15,255,256,85],{},[19,257,67],{},[40,259],{},[10,261,263],{"id":262},"saving-settings","Saving settings",[15,265,266,267,270],{},"After making changes on either tab, click the ",[19,268,269],{},"Save Settings"," button at the bottom of the page. Settings take effect immediately — no cache clearing or server restart required.",[40,272],{},[10,274,96],{"id":275},"troubleshooting-lockout",[15,277,278],{},"If bot protection locks you out of your own site:",[280,281,282,285,295,298,307],"ol",{},[27,283,284],{},"Connect to your server via FTP or cPanel File Manager.",[27,286,287,288,291,292],{},"Rename the plugin folder from:\n",[55,289,290],{},"\u002Fwp-content\u002Fplugins\u002Fblockbots\u002F","\nto:\n",[55,293,294],{},"\u002Fwp-content\u002Fplugins\u002Fblockbots-disabled\u002F",[27,296,297],{},"Log in to WordPress normally.",[27,299,300,301,304,305,97],{},"Go to ",[19,302,303],{},"WP Admin → Blockbots → Free Features"," and enable ",[19,306,74],{},[27,308,309,310,313],{},"Rename the folder back to ",[55,311,312],{},"blockbots"," to re-enable the plugin.",[40,315],{},[10,317,319],{"id":318},"upgrading-from-free-to-pro","Upgrading from Free to PRO",[15,321,322],{},"You do not need to install a separate plugin. Simply:",[280,324,325,330,336],{},[27,326,300,327,97],{},[19,328,329],{},"WP Admin → Blockbots → Pro Features",[27,331,332,333,335],{},"Enter your API key in the ",[19,334,157],{}," field.",[27,337,338],{},"Save settings.",[15,340,341],{},"PRO features are activated instantly within your existing installation.",{"title":141,"searchDepth":343,"depth":343,"links":344},2,[345,346,353,362,363,364],{"id":12,"depth":343,"text":13},{"id":44,"depth":343,"text":45,"children":347},[348,350,351,352],{"id":49,"depth":349,"text":50},3,{"id":73,"depth":349,"text":74},{"id":102,"depth":349,"text":103},{"id":122,"depth":349,"text":123},{"id":152,"depth":343,"text":153,"children":354},[355,356,357,358,359,360,361],{"id":156,"depth":349,"text":157},{"id":181,"depth":349,"text":182},{"id":194,"depth":349,"text":195},{"id":207,"depth":349,"text":208},{"id":223,"depth":349,"text":224},{"id":232,"depth":349,"text":233},{"id":246,"depth":349,"text":247},{"id":262,"depth":343,"text":263},{"id":275,"depth":343,"text":96},{"id":318,"depth":343,"text":319},"A walkthrough of every setting in the BlockBots WordPress admin panel — what each option does and how to configure it.","md",{},true,8,"\u002Fdocs\u002Fwordpress-reference","WordPress Plugin",{"title":5,"description":365},"docs\u002Fwordpress-reference","TsP5QE9zx5gzEkAKQbVVj3XW7NII6rxnG7Ylx9oCwIM",[376,381,385,390,394,397],{"title":377,"path":378,"order":379,"section":380},"Getting Started","\u002Fdocs\u002Fgetting-started",1,"Introduction",{"title":382,"path":383,"order":349,"section":384},"PHP – Quick Start","\u002Fdocs\u002Fphp-quickstart","PHP Integration",{"title":386,"path":387,"order":388,"section":389},"JavaScript SDK – Quick Start","\u002Fdocs\u002Fjavascript-quickstart",5,"JavaScript SDK",{"title":391,"path":392,"order":393,"section":389},"JavaScript SDK – Reference","\u002Fdocs\u002Fjavascript-reference",6,{"title":371,"path":395,"order":396,"section":371},"\u002Fdocs\u002Fwordpress-plugin",7,{"title":5,"path":370,"order":369,"section":371},1790770390589]