Title: Advanced Country Blocker Author: brstefanovic Published: 18 janvier 2025 Last modified: 6 février 2026 --- Recherche d’extensions ![](https://ps.w.org/advanced-country-blocker/assets/banner-772x250.png?rev=3432082) ![](https://ps.w.org/advanced-country-blocker/assets/icon-256x256.png?rev=3224899) # Advanced Country Blocker Par [brstefanovic](https://profiles.wordpress.org/brstefanovic/) [Télécharger](https://downloads.wordpress.org/plugin/advanced-country-blocker.2.3.2.zip) * [Détails](https://fr.wordpress.org/plugins/advanced-country-blocker/#description) * [Avis](https://fr.wordpress.org/plugins/advanced-country-blocker/#reviews) * [Installation](https://fr.wordpress.org/plugins/advanced-country-blocker/#installation) * [Développement](https://fr.wordpress.org/plugins/advanced-country-blocker/#developers) [Support](https://wordpress.org/support/plugin/advanced-country-blocker/) ## Description **Advanced Country Blocker** helps you secure your WordPress site by restricting access based on the visitor’s geolocation (country) or IP address. Upon activation, the plugin detects the activating admin’s country and automatically sets that as the only allowed country. All other visitors from different countries are blocked, unless they use a secret key parameter to temporarily whitelist their IP. Country detection uses the privacy-friendly ip-api.com service by default but can be switched to a fully offline MaxMind GeoLite2 (or compatible) database file once you configure a local copy. **Key Features:** * **Automatically allows the admin’s country** on plugin activation. * **Flexible IP-to-country lookups** – start with the built-in ip-api.com integration and optionally switch to an offline MaxMind GeoLite2 Country (or compatible) `. mmdb` database file. * **Allowlist or blacklist mode** – choose whether the country list acts as an allowlist or blocklist without re-entering countries. * **Temporary access** via a customizable secret URL parameter (e.g., `?MySecretKey =1`). * **CAPTCHA Challenge** – allow blocked visitors to solve a CAPTCHA to gain temporary access (supports Google reCAPTCHA v2/v3, hCaptcha, Cloudflare Turnstile). * **Real-Time Activity Monitor** – live dashboard showing active visitors, recent blocks, and traffic statistics. * **Analytics Dashboard** – comprehensive charts and statistics about blocked attempts. * **Manual blacklisting and safelisting of IPs** for added security and to accommodate uptime monitors. * **Optional email alerts** when new visitors are blocked. * **Admin bypass** so logged-in admins can always access the site (toggleable in the code). * **Detailed logging** of blocked attempts in a custom database table, displayed in the WP admin. * **Custom response controls** – personalise the block page title/message, choose the HTTP status (403, 410, 451) or redirect to any URL. * **Automatic log cleanup** with configurable retention plus a one-click « Clear Logs » button. Use the plugin settings page (**Country Blocker** menu in WP admin) to configure the list of allowed countries, blacklisted countries, blacklisted IPs, and whether email alerts are enabled. ### License This plugin is open-sourced software licensed under the [GPLv3 or later](https://www.gnu.org/licenses/gpl-3.0.html). ### External Services By default this plugin contacts the ip-api.com geolocation service to detect visitor countries. You can disable all external lookups by switching the IP lookup method to the local MaxMind database in the settings. ## Captures d’écrans [⌊Settings Page – Configure allowed/blacklisted countries, IPs, CAPTCHA, and email alerts.⌉⌊Settings Page – Configure allowed/blacklisted countries, IPs, CAPTCHA, and email alerts.⌉[ **Settings Page** – Configure allowed/blacklisted countries, IPs, CAPTCHA, and email alerts. [⌊Blocked Attempts Log – View a list of recently blocked visitors.⌉⌊Blocked Attempts Log – View a list of recently blocked visitors.⌉[ **Blocked Attempts Log** – View a list of recently blocked visitors. [⌊Analytics Dashboard – Visual charts and statistics about blocked traffic.⌉⌊Analytics Dashboard – Visual charts and statistics about blocked traffic.⌉[ **Analytics Dashboard** – Visual charts and statistics about blocked traffic. [⌊Live Monitor – Real-time view of active visitors and recent blocks.⌉⌊Live Monitor– Real-time view of active visitors and recent blocks.⌉[ **Live Monitor** – Real-time view of active visitors and recent blocks. ## Installation 1. **Upload the plugin folder** to the `/wp-content/plugins/` directory, or install via the WordPress « Add Plugin » feature. 2. **Download the GeoLite2 Country database** (or another compatible MaxMind DB format country database) from [MaxMind](https://dev.maxmind.com/geoip/geolite2-free-geolocation-data) and place the `.mmdb` file somewhere on your server where PHP can read it (optional but recommended for offline mode). 3. **Activate the plugin** through the « Plugins » menu in WordPress. 4. Upon activation, the plugin will: 5. * Detect the activating admin’s IP. * Determine the corresponding country using your selected lookup method (remote API by default). * Set that country as the **only** allowed country in the plugin settings. 6. Go to **Country Blocker** **Settings** in your WordPress admin menu to adjust configurations (e.g., secret key, blacklisted countries, blacklisted IPs, etc.), choose the IP lookup method, and (optionally) provide the absolute path to your`. mmdb` file for offline lookups. ## FAQ ### Where do I get the GeoIP database file? You can download the free [GeoLite2 Country database](https://dev.maxmind.com/geoip/geolite2-free-geolocation-data) from MaxMind (requires a free account). Upload the `.mmdb` file to a readable location on your server (for example, inside `wp-content/uploads/`) and paste the absolute file path into the **GeoIP Database Path** field on the plugin settings page. ### My IP geolocation is incorrect. How do I fix it? Local GeoIP databases occasionally have outdated entries. MaxMind updates GeoLite2 weekly, so download the latest release when you notice inaccuracies. You can also manually add or remove countries on the settings page to adjust who is allowed or blocked. ### What if I accidentally block myself? You can add your IP manually to the temporary whitelist by using the URL parameter(`? YourSecretKey=1`), solve the CAPTCHA challenge if enabled, or log in as an admin( if admin bypass is enabled). Alternatively, you can deactivate the plugin via FTP or your hosting control panel and adjust settings. ### Does this plugin store any visitor data? The plugin stores IP addresses and (optionally) country codes in a custom log table when visitors are blocked. This is purely for security and administrative review. Remove or adjust this functionality as needed to comply with privacy regulations. ### Can I bypass the plugin if I’m an administrator? Yes, by default, if you are logged in with `manage_options` capability. You can change or remove this bypass in the plugin code. ### Can I customise the block page or send visitors somewhere else? Yes. The settings page lets you change the block page title/message (with placeholders for `{ip}`, `{country_code}`, and `{reason}`), choose the HTTP status code to send( 403, 410, or 451) or redirect visitors to a custom URL with the status code of your choice. ### How do I only block a handful of countries? Stay in the default allowlist mode when you want to permit just the countries you list. Switch to « Use Blacklist Mode » to list only the countries you want to block— everything else will be allowed automatically. ### How can I clear or trim the log table? Use the « Clear Logs » button on the Block Logs screen to wipe all entries instantly. You can also configure automatic log cleanup from the settings page—set the retention to `0` days to keep everything indefinitely. ### What CAPTCHA providers are supported? The plugin supports Google reCAPTCHA v2 (checkbox), Google reCAPTCHA v3 (invisible), hCaptcha, and Cloudflare Turnstile. You can configure your preferred provider in the settings page. ### How does the Real-Time Monitor work? The Live Monitor shows real-time visitor activity including active visitors, recent blocks, and traffic statistics. Data updates automatically every 3 seconds and is stored temporarily. ## Avis ![](https://secure.gravatar.com/avatar/daf2b8d68c9e1070b6dead14787f8b011c76347a1162ab2773b378c982060555? s=60&d=retro&r=g) ### 󠀁[Excellent work](https://wordpress.org/support/topic/excellent-work-341/)󠁿 [Scooter](https://profiles.wordpress.org/1scooter/) 15 octobre 2025 Great functionality for restricting or allowing access to content.@brstefanovic is developing the plugin and adding to its functionality.I hope that in the future he will implement the ability to localize the interface into other languages. But even now, the plugin is easy and convenient to use and configure.Thank you, @brstefanovic. ![](https://secure.gravatar.com/avatar/a3a1c69e46b37711348220f981eaa445c37fb9f18a9e9be87246069ede8e96f8? s=60&d=retro&r=g) ### 󠀁[Seems to work quite well](https://wordpress.org/support/topic/seems-to-work-quite-well/)󠁿 [pavman](https://profiles.wordpress.org/pavman/) 10 octobre 2025 Looks like this works quite well with the other tools I use. I use uptime robot to monitor my site and disabled their servers' countries; the service has apparently been alerting for a few hours now. I went ahead and re-added it, but it's good to know this actually works, even if it throws a 403.Would rather see an http error 410 or 418 instead of 403. ![](https://secure.gravatar.com/avatar/61b923fc2de741746f088c6846673b718174aefcdeef754654df10127779ef99? s=60&d=retro&r=g) ### 󠀁[Powerful blocker yet simple and lightweight](https://wordpress.org/support/topic/powerful-blocker-yet-simple-and-lightweight/)󠁿 [d4niwp](https://profiles.wordpress.org/d4niwp/) 1 août 2025 Effective and powerful country/ip blocker, where others have failed, this plugin worked flawlessly and without issues. As an improvement to the plugin, I would suggest having an option to modify the blocking message and another to redirect to a custom URL. ![](https://secure.gravatar.com/avatar/f97a9164293fc527aa20059cc67fcc58703c2b59d49236b9f2c2106ff128a823? s=60&d=retro&r=g) ### 󠀁[Looks good so far](https://wordpress.org/support/topic/looks-good-so-far-12/)󠁿 [Mike Witt](https://profiles.wordpress.org/mike80222/) 19 juin 2025 I just installed this and it seems to be working quite well. This was the only plugin I could find where you could *allow* only certain countries without jumping through some hoops to install a geo database. ![](https://secure.gravatar.com/avatar/4de72be55b10dd3f8555fcf4f694e5fdae3ce8ab825cba1a4057b9fb71865a90? s=60&d=retro&r=g) ### 󠀁[Excited to Try](https://wordpress.org/support/topic/excited-to-try-2/)󠁿 [Tammy Storer](https://profiles.wordpress.org/tammystorer/) 14 mars 2025 So far beyond simple. I only wanted the US to access my website because its the only place I ship to and I get a ton of attacks from other countries. Within minutes my logs showed 3 other countries had already been blocked. I also have WordFence so I can see incoming traffic so it will be neat to see if this blocks the bulk of other countries. With high hopes I thank you for making this plugin! ![](https://secure.gravatar.com/avatar/55cc2ef441581bc830b6780bdc0ba8374bde93dd26cfef7e1d659f2ad5562632? s=60&d=retro&r=g) ### 󠀁[Nice Update & Saved Me](https://wordpress.org/support/topic/nice-update-10/)󠁿 [hawkeeye](https://profiles.wordpress.org/hawkeeye/) 29 août 2025 1 réponse Since my earlier review I had a problem with a foreign site that I needed to block. This plugin is so easy to use and so fast that it saved me a lot of heartache. This is a must have! The improvements in 2.0.2 are nice and for me seem more functional. If you are still open to suggestions, I think it would be helpful to sort the allowed or blocked countries alphabetically when you load the plugin. Once you add a dozen or so following your list becomes a little difficult. Just a suggestion and not a must have. Thanks for being so responsive. [ Lire les 6 avis ](https://wordpress.org/support/plugin/advanced-country-blocker/reviews/) ## Contributeurs/contributrices & développeurs/développeuses « Advanced Country Blocker » est un logiciel libre. Les personnes suivantes ont contribué à cette extension. Contributeurs * [ brstefanovic ](https://profiles.wordpress.org/brstefanovic/) “Advanced Country Blocker” a été traduit dans 1 locale. Remerciez [l’équipe de traduction](https://translate.wordpress.org/projects/wp-plugins/advanced-country-blocker/contributors) pour ses contributions. [Traduisez « Advanced Country Blocker » dans votre langue.](https://translate.wordpress.org/projects/wp-plugins/advanced-country-blocker) ### Le développement vous intéresse ? [Parcourir le code](https://plugins.trac.wordpress.org/browser/advanced-country-blocker/), consulter le [SVN dépôt](https://plugins.svn.wordpress.org/advanced-country-blocker/), ou s’inscrire au [journal de développement](https://plugins.trac.wordpress.org/log/advanced-country-blocker/) par [RSS](https://plugins.trac.wordpress.org/log/advanced-country-blocker/?limit=100&mode=stop_on_copy&format=rss). ## Journal des modifications #### 2.3.2 * Bug fixes and security audit fix #### 2.3.1 * Hotfix for Databases not being downloaded #### 2.3.0 * **New:** Added CAPTCHA Challenge feature allowing blocked visitors to verify via CAPTCHA to gain temporary access * **New:** Added Real-Time Activity Monitor with live visitor tracking, recent blocks, and traffic statistics * **New:** Added Analytics Dashboard with interactive charts showing blocked attempts over time, top countries, and block reasons * **Security:** Fixed secret key bypass vulnerability – now requires value to equal« 1 » instead of just checking existence * **Security:** Fixed SSRF vulnerability in GeoIP download – now validates URLs and restricts to trusted domains only * **Security:** Fixed IP address spoofing by using WordPress’s wp_http_get_original_ip() function * **Security:** Added file size limits and content validation for GeoIP database uploads/downloads * **Security:** Fixed CAPTCHA secret key exposure in settings page – now masked for security * **Security:** Added proper output sanitization for block reasons in AJAX responses * **Fixed:** Removed duplicate helper functions (advcb_get_country_name, advcb_get_country_flag) * **Fixed:** Redundant cleanup function calls removed for better performance * **Fixed:** Duplicate sanitize callbacks removed #### 2.2.0 * Added an optional local MaxMind GeoLite2 (or compatible) database lookup while keeping the ip-api.com integration as the default method. * Added settings fields to choose the lookup method, configure the path to the `. mmdb` database file, and display status messaging for admins. #### 2.1.0 * Added a fully customisable block page (title, message placeholders, and selectable HTTP status code). * Added optional redirect behaviour with configurable status codes for blocked visitors. * Added a trusted IP list to bypass the blocker (ideal for uptime monitoring services). * Added automatic log cleanup with adjustable retention and admin notices. * Improved settings guidance for switching between allowlist and blacklist modes. #### 2.0.4 * Tested with latest WordPress version #### 2.0.3 * Added feature to Clear Logs * Added feature to Disable Logs * Fixed pagination for Logs #### 2.0.2 * Added the blacklist mode #### 2.0.1 * Fixed WordPress Repo guideline issues #### 2.0.0 * Added logging to a custom database table. * Added blacklisted country/IP feature. * Added admin bypass for testing. * Added email alerts. #### 1.1.0 * Defaulted to admin’s country on plugin activation. * Introduced secret URL key for temporary IP whitelisting. #### 1.0.0 * Initial plugin release with basic country blocking and default country code. ## Méta * Version **2.3.2** * Dernière mise à jour **il y a 8 mois** * Installations actives **2 000+** * Version de WordPress ** 5.0 ou plus ** * Testé jusqu’à **6.9.10** * Version de PHP ** 7.2 ou plus ** * Langues * [English (US)](https://wordpress.org/plugins/advanced-country-blocker/) et [Russian](https://ru.wordpress.org/plugins/advanced-country-blocker/). * [Traduisez la dans votre langue](https://translate.wordpress.org/projects/wp-plugins/advanced-country-blocker) * Étiquettes * [blocking](https://fr.wordpress.org/plugins/tags/blocking/)[country](https://fr.wordpress.org/plugins/tags/country/) [geolocation](https://fr.wordpress.org/plugins/tags/geolocation/)[IP-blocking](https://fr.wordpress.org/plugins/tags/ip-blocking/) [security](https://fr.wordpress.org/plugins/tags/security/) * [Vue avancée](https://fr.wordpress.org/plugins/advanced-country-blocker/advanced/) ## Évaluations 5 sur 5 étoiles. * [ 6 avis à 5 étoiles ](https://wordpress.org/support/plugin/advanced-country-blocker/reviews/?filter=5) * [ 0 avis à 4 étoile ](https://wordpress.org/support/plugin/advanced-country-blocker/reviews/?filter=4) * [ 0 avis à 3 étoile ](https://wordpress.org/support/plugin/advanced-country-blocker/reviews/?filter=3) * [ 0 avis à 2 étoile ](https://wordpress.org/support/plugin/advanced-country-blocker/reviews/?filter=2) * [ 0 avis à 1 étoile ](https://wordpress.org/support/plugin/advanced-country-blocker/reviews/?filter=1) [Votre avis](https://wordpress.org/support/plugin/advanced-country-blocker/reviews/#new-post) [Tout voir](https://wordpress.org/support/plugin/advanced-country-blocker/reviews/) ## Contributeurs * [ brstefanovic ](https://profiles.wordpress.org/brstefanovic/) ## Support Demandes résolues ces deux derniers mois : 0 sur 1 [Voir le forum de support](https://wordpress.org/support/plugin/advanced-country-blocker/)