WindCodex

<p><strong>Country Restrictions for WooCommerce</strong> lets you control exactly which products customers can see and buy based on their country – using WooCommerce’s built-in geolocation engine. No API key. No third-party service. No code required.</p>
<p>Whether you need to comply with regional laws, manage export restrictions, honour licensing agreements, or limit shipping destinations – this plugin gives you precise per-product country control in minutes.</p>
<h4>Why store owners choose this plugin</h4>
<ul>
<li><strong>No more failed deliveries</strong> – Stop customers from ordering products you can’t ship to their country.</li>
<li><strong>Stay legally compliant</strong> – Block products restricted by local law (alcohol, supplements, age-restricted items, electronics).</li>
<li><strong>Honour licensing agreements</strong> – Restrict digital or licensed products to territories your agreement covers.</li>
<li><strong>Create country-specific catalogs</strong> – Show a tailored product selection to each market, automatically.</li>
<li><strong>Reduce chargebacks</strong> – Prevent orders you’d only have to cancel and refund.</li>
</ul>
<h4>3 Restriction Modes – Choose how to handle each restricted product</h4>
<p><strong>Hide completely</strong><br />
Product is removed from shop pages, search results, and category listings for restricted visitors. Direct product URL returns a 404 page. Optionally redirect restricted visitors to a custom URL instead.</p>
<p><strong>Hide from catalog, allow direct URL</strong><br />
Product is hidden from shop and search. The product page still loads via direct link – useful for distributors or partners in restricted regions. You can optionally allow full purchase via direct URL with a single toggle.</p>
<p><strong>Show restriction message</strong><br />
Product stays visible in the catalog. On the product page, the Add to Cart button and price are replaced with your custom HTML message. Perfect for explaining regional availability without making the product invisible.</p>
<h4>Key Features</h4>
<ul>
<li><strong>Per-product country rules</strong> – Set include or exclude rules on any product from the product edit screen. Searchable country selector with live rule summary.</li>
<li><strong>Include or Exclude mode</strong> – Whitelist specific countries (only they can buy) or blacklist countries (everyone except them can buy).</li>
<li><strong>Custom restriction message</strong> – Write your own HTML message. Supports links, bold text, and any markup allowed by WordPress.</li>
<li><strong>Configurable message position</strong> – Place the restriction notice above the title, below the title, after the description, or before product meta.</li>
<li><strong>Redirect on restriction</strong> – In Hide mode, redirect restricted visitors to any URL instead of a 404 page.</li>
<li><strong>Cart & checkout protection</strong> – Restricted products added to cart before a rule was applied are automatically removed at cart and checkout, with a clear notice.</li>
<li><strong>Server-side add-to-cart validation</strong> – Blocks direct POST, REST API, and AJAX add-to-cart attempts for restricted products. No client-side-only protection.</li>
<li><strong>Smart country detection (6 layers)</strong> – Shipping address -> billing address -> WC session -> transient cache -> MaxMind GeoLite2 -> store base. No manual input needed from shoppers.</li>
<li><strong>Cloudflare IP support</strong> – Reads <code>CF-Connecting-IP</code> automatically for sites behind Cloudflare.</li>
<li><strong>Force Geolocation option</strong> – Ignore saved addresses and always detect country from IP.</li>
<li><strong>Session & transient caching</strong> – Country detection results are cached per session for performance. Zero repeated geolocation lookups.</li>
<li><strong>Debug toolbar</strong> – Admin-only bar at the bottom of every frontend page showing detected country, IP address, detection source, and a direct link to settings.</li>
<li><strong>Shortcode support</strong> – <code>[geoblock_product_message]</code> renders the restriction message anywhere – page builders, custom templates, Elementor, Divi.</li>
<li><strong>HPOS compatible</strong> – Fully compatible with WooCommerce High-Performance Order Storage.</li>
<li><strong>Translation ready</strong> – Complete <code>.pot</code> file included. Fully translatable via Loco Translate or WPML String Translation.</li>
</ul>
<h4>Plugin Compatibility</h4>
<p>Built-in compatibility layers for 6 popular plugins – no configuration needed:</p>
<ul>
<li><strong>Price Based on Country for WooCommerce</strong> – Restriction message takes priority over country-based pricing on restricted products.</li>
<li><strong>WPML</strong> – Rules set on the original-language product automatically apply to all translated copies. No duplicate rules per language.</li>
<li><strong>WooCommerce Product Bundles</strong> – Restriction on the bundle parent blocks the entire bundle from being purchased.</li>
<li><strong>WooCommerce Subscriptions</strong> – Both <code>subscription</code> and <code>variable-subscription</code> product types are fully supported.</li>
<li><strong>WP Rocket</strong> – Product pages automatically excluded from page cache so every visitor gets the correct restricted/unrestricted version.</li>
<li><strong>Speed Optimizer by SiteGround</strong> – Product pages bypass SiteGround’s dynamic cache using <code>SGCACHENOCACHE</code> and <code>sgo_bypass_cache</code>.</li>
</ul>
<h4>Use Cases</h4>
<ul>
<li>Block alcohol or age-restricted products from countries where they’re prohibited</li>
<li>Restrict physical products to countries you can ship to</li>
<li>Limit digital downloads to licensed territories</li>
<li>Hide out-of-stock regional variants from other markets</li>
<li>Show a -contact us to order in your region- message instead of hiding the product</li>
<li>Create exclusive country-specific product catalogs</li>
</ul>
<h4>Shortcode</h4>
<p>Display the restriction message anywhere using:<br />
    [geoblock_product_message]</p>
<p><strong>Attributes:</strong><br />
* <code>id</code> – Product ID to check. Defaults to current product in the loop.<br />
* <code>class</code> – Extra CSS class(es) added to the message wrapper div.</p>
<p><strong>Examples:</strong><br />
    [geoblock_product_message id=123]<br />
    [geoblock_product_message id=123- class=my-notice highlight]</p>
<h4>How It Works</h4>
<ol>
<li>Install and activate the plugin.</li>
<li>Go to <strong>WooCommerce > GeoBlock Restrictions</strong> and choose a restriction mode.</li>
<li>Open any product and find the <strong>GeoBlock – Country Restrictions</strong> meta box.</li>
<li>Select Include or Exclude, choose your countries, and save.</li>
<li>GeoBlock automatically detects each visitor’s country and applies your rules in real time.</li>
</ol>
<h4>Requirements</h4>
<ul>
<li>WordPress 5.8 or higher</li>
<li>WooCommerce 7.0 or higher</li>
<li>PHP 7.4 or higher</li>
<li>WooCommerce Geolocation: <strong>WooCommerce Settings > General > Default customer location > Geolocate</strong></li>
</ul>
<h4>Privacy</h4>
<p>GeoBlock uses the visitor’s IP address solely to determine their country. No personal data is stored permanently. Detection results are cached in WooCommerce session storage and WordPress transients with a 1-hour TTL. No data is sent to external servers. This plugin does not collect, sell, or share any visitor data.</p>


WindCodex GeoBlock – WooCommerce country restrictions with geolocation

Restrict WooCommerce products by country. Hide products, block purchases, or show a custom message using geolocation - no API key required.

Mohamed Shili

<p>🔐 Block or allow visitors by country. Track access attempts. View analytics. Stay in control — effortlessly.</p>
<h3>🧠 Description</h3>
<p><strong>Geo Blocker</strong> gives you full control over who can access your WordPress site — based on visitor country and IP. Whether you’re protecting content, reducing attack surface, or managing regional access, this plugin does it with precision and clarity.</p>
<p>🎯 Designed for performance, security, and ease of use.<br />
📊 Built-in analytics and access logs.<br />
🧭 Never get locked out — admin-safe bypass included.</p>
<h3>🚀 Features</h3>
<h3>✅ Access Control That Makes Sense</h3>
<ul>
<li><strong>Block Selected Countries</strong> – deny access to specific regions  </li>
<li><strong>Allow Selected Countries</strong> – restrict site only to approved countries  </li>
</ul>
<h3>🧩 Smart Blocking Actions</h3>
<ul>
<li>📜 Show custom message  </li>
<li>🔁 Redirect to a URL  </li>
<li>🚫 Send HTTP 403 Forbidden response  </li>
</ul>
<h3>🌐 Visual Country Selector</h3>
<ul>
<li>Flag icons & search bar for quick targeting  </li>
<li>Filter by continent (Africa, Asia, Europe, etc.)  </li>
<li>One-click select/deselect all  </li>
</ul>
<h3>📈 Analytics Dashboard</h3>
<ul>
<li>Summary cards: total visits, blocks, IPs  </li>
<li>Hourly charts for real-time insights  </li>
<li>Filter by date range & data type (accesses, unique IPs, etc.)  </li>
</ul>
<h3>📋 Detailed Logs</h3>
<ul>
<li>See IP, country, URL, status, user agent  </li>
<li>Filters out common junk (favicon, robots.txt)  </li>
<li>Admin visits are auto-ignored to reduce noise  </li>
</ul>
<h3>🛠️ Admin-Proof Bypass URL</h3>
<ul>
<li>Special URL with bypass parameter to access login anytime  </li>
<li>Prevents accidental lockouts  </li>
</ul>
<h3>🔄 Data Export & Log Management</h3>
<ul>
<li>Export logs in CSV or JSON  </li>
<li>Clear logs with a single click  </li>
<li>Sort & search logs in the UI</li>
</ul>
<h3>🌐 External Services</h3>
<p>This plugin uses a third-party API to determine the visitor’s country based on their IP address.</p>
<ul>
<li><strong>Service used:</strong> <a href="https://ipwho.is" rel="nofollow ugc">IPWho.is</a>  </li>
<li><strong>Purpose:</strong> To perform IP geolocation and detect the country of each visitor, allowing the plugin to block or allow access accordingly.  </li>
<li><strong>Data sent:</strong> The visitor’s IP address is sent to the IPWho.is API on page load when geo-blocking is active.  </li>
<li><strong>Terms of Service:</strong> <a href="https://ipwhois.io/terms" rel="nofollow ugc">https://ipwhois.io/terms</a>  </li>
<li><strong>Privacy Policy:</strong> <a href="https://ipwhois.io/privacy" rel="nofollow ugc">https://ipwhois.io/privacy</a></li>
</ul>
<h3>🖥️ Screenshots</h3>
<ol>
<li><strong>📊 Dashboard Overview</strong> – See country blocks, allowed hits & total attempts   </li>
<li><strong>🔧 Blocking Rules</strong> – Choose block mode, action type, and targets. Enable or disable countries visually</li>
<li><strong>📉 Analytics Graphs</strong> – View access by time, state, and IP 5. <strong>📑 Logs Table</strong> – Deep insights with full logs of visitor attempts. Export CSV/JSON logs with one click</li>
</ol>
<h3>📦 Installation</h3>
<ol>
<li>Upload the plugin folder to <code>/wp-content/plugins/geo-blocker</code>  </li>
<li>Activate via <strong>Plugins <span aria-hidden="true" class="wp-exclude-emoji">→</span> Installed Plugins</strong>  </li>
<li>Go to <strong>Settings <span aria-hidden="true" class="wp-exclude-emoji">→</span> Geo Blocker</strong>  </li>
<li>Enable Geo Blocking using the toggle  </li>
<li>Choose between <strong>block</strong> or <strong>allow</strong> mode  </li>
<li>Select countries using the visual interface  </li>
<li>Pick your blocking action (message, redirect, or 403)  </li>
<li>Save settings — done!</li>
</ol>
<h3>❓ Frequently Asked Questions</h3>
<h3>How does Geo Blocker detect country?</h3>
<p>It uses the reliable <strong>IpWhoIs API</strong> to fetch country data based on the visitor’s IP.</p>
<h3>Will it slow down my site?</h3>
<p>Nope. It’s optimized with <strong>transient caching</strong> and smart triggers — no unnecessary lookups.</p>
<h3>Can I lock myself out?</h3>
<p>No. There’s a <strong>login bypass URL</strong> generated for administrators — shown right on the dashboard.</p>
<h3>Can I block specific pages?</h3>
<p>Not yet — current version works site-wide. Per-page rules may come in a future update.</p>
<h3>Can I export visitor logs?</h3>
<p>Yes. Logs can be exported in <strong>CSV or JSON</strong> format directly from the Logs tab.</p>
<h3>Does it work with caching plugins?</h3>
<p>Yes, but you may need to <strong>exclude the plugin’s logic</strong> from caching. Dynamic geo checks should not be cached.</p>
<h3>🗂️ Changelog</h3>
<h4>1.0.0</h4>
<ul>
<li>🎉 Initial release with all core features</li>
</ul>
<h3>🛡️ Additional Notes</h3>
<h3>Emergency Bypass</h3>
<p>Every admin gets a custom bypass link to avoid accidental lockouts. It’s always visible in the dashboard.</p>
<h3>Blocking Actions</h3>
<p>Choose the experience blocked users receive:<br />
– Custom message<br />
– Redirect to another URL<br />
– Send 403 Forbidden header</p>
<h3>Logs & Privacy</h3>
<p>Logs are stored locally in your WordPress database. The plugin sends only the visitor’s IP to IPWho.is — no personally identifiable information is shared or stored externally.</p>
<h3>💡 Enjoying Geo Blocker? Try Our Other Free Plugins</h3>
<p>Looking for even more control and peace of mind? Check out our other tools:</p>
<p>🔕 <strong><a href="https://wordpress.org/plugins/notification-blocker/" rel="ugc">Notification Blocker</a></strong> – Hide annoying plugin notices from your dashboard without hacking core files.</p>
<p>🛡️ <strong><a href="https://wordpress.org/plugins/fortress-login-pro/" rel="ugc">Fortress Login Pro</a></strong> – Obscure your login page, add brute-force protection, and block unauthorized access attempts with ease.</p>
<p>If you like Geo Blocker, you’ll probably find these just as helpful. Try them out!</p>


Geo Blocker – Control Site Access by Region and IP

🔐 Block or allow visitors by country. Track access attempts. View analytics. Stay in control — effortlessly.

WindCodex GeoBlock – WooCommerce country restrictions with geolocation vs Geo Blocker – Control Site Access by Region and IP