GeoShield - Country Restrictions Lite for WooCommerce
| 开发者 | sabbir37 |
|---|---|
| 更新时间 | 2026年9月21日 18:35 |
| 捐献地址: | 去捐款 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
GeoShield - Country Restrictions Lite for WooCommerce lets you control exactly which products are visible and purchasable based on your customer's country — using fast, privacy-first geolocation with zero configuration required.
Whether you are dealing with territorial licensing agreements, cross-border shipping limitations, regional export compliance regulations, or localized product lines, GeoShield gives you granular control over your product catalog by country — without writing a single line of code.
Need to automate catalog visibility at scale across categories, tags, or entire continents? Explore GeoShield Country Restrictions Pro for automated global rules and smart geo-tools.
HPOS Compatible · WooCommerce Blocks Ready · Cloudflare & CDN Friendly · 100% Privacy & GDPR Safe
What You Can Do
- Restrict products per country — Choose between Blacklist (block selected countries) or Whitelist (allow only selected countries) directly inside the WooCommerce product editor.
- Two flexible restriction actions — Choose what happens when a customer visits from a restricted country:
- Hide Product (Full Restriction) — Automatically removes the product from the shop catalog and search results. Direct single-product URL visits cleanly return a 404 page or redirect to the shop page.
- Disable Checkout (Lock Purchase) — Keeps the product visible in the catalog, but locks purchasing by removing the Add to Cart button and displaying a custom restriction notice.
- Variation-level country restrictions — Apply independent restriction rules to individual product variations. Sell specific sizes, colors, or options globally while restricting others within the same variable product.
- Fast, multi-layer geolocation engine — Detects visitor country instantly:
- Checks Cloudflare's country header (
CF-IPCountry) first for instant 0ms edge detection. - Uses WooCommerce's native MaxMind GeoIP2 integration for accurate local server detection.
- Gracefully falls back to IP geolocation if MaxMind is not configured.
- Includes automated localhost detection so developers can test rules locally without configuration.
- Custom restriction messages — Set personalized notices per product or per variation explaining to restricted shoppers why the item is unavailable in their location.
- Global fallback settings — Set a storewide fallback restriction message and configure direct URL access behavior (Return 404 or Redirect to Shop).
- Multi-layer catalog & checkout protection — Enforces restrictions across shop loops, product archives, search results, single product templates, cart additions, and checkout submissions.
- WooCommerce Blocks & Classic ready — Works seamlessly with both classic shortcodes and the new WooCommerce Cart & Checkout blocks via the WooCommerce Store API.
- HPOS Compatible — Fully certified for WooCommerce High-Performance Order Storage (custom order tables).
- Privacy-first & GDPR compliant — Uses local MaxMind geolocation first. No customer personal data (names, emails, addresses) is ever collected, stored, or transmitted.
- Automated Global Catalog Rules: Restrict whole product lines instantly by Product Category, Product Tag, or Shipping Class — zero individual product setup required.
- Continent, State & Province Targeting: Restrict or whitelist entire continents, states, and provinces worldwide with granular regional accuracy.
- Catalog Mode (Hide Price & Add to Cart): Keep product pages visible and indexed for global SEO while disabling prices and purchase actions for restricted countries.
- Smart Geo-Forwarding & Auto-Redirects: Seamlessly redirect shoppers from restricted locations to designated localized regional domains or custom URLs.
- Role-Based B2B Restrictions: Define rules by WordPress user role (e.g., allow Wholesale / B2B buyers while restricting retail guests).
- Shipping Class & Freight Controls: Apply custom geographic restrictions to heavy freight, fragile goods, or restricted carrier zones.
- Priority Technical Support: Direct, premium assistance from senior WooCommerce plugin engineers.
- Install and activate GeoShield - Country Restrictions Lite.
- Edit any WooCommerce product and open the Country Restrictions tab in the Product Data panel.
- Toggle on Enable Restrictions, select your mode (Blacklist or Whitelist), and choose your target countries.
- Choose your restriction action: Hide Product (catalog removal + direct access control) or Disable Checkout (show product with custom restriction message).
- Save the product. Customers visiting from restricted locations will automatically experience your configured rules.
- Multilingual plugins — WPML, Polylang, TranslatePress, Weglot
- Page builders — Elementor, Divi, Beaver Builder, Gutenberg Block Editor
- Search plugins — Advanced Woo Search, Relevanssi, FiboSearch
- Caching plugins — WP Rocket, LiteSpeed Cache, W3 Total Cache, WP Super Cache, SiteGround Optimizer
- Multi-currency plugins — Works harmoniously with WooCommerce currency switchers
- WooCommerce Subscriptions — Variation-level and product-level restrictions supported on subscription products
- Ensure your caching plugin is set to vary cache by WooCommerce's geolocation cookie (
woocommerce_geo_hash). - Alternatively, enable "Geolocate (with page caching support)" under WooCommerce > Settings > General. This allows WooCommerce to handle country detection via an unobtrusive AJAX endpoint on cached pages.
- If using Cloudflare, GeoShield automatically leverages Cloudflare's
CF-IPCountryheader for instant, zero-latency detection.
安装:
- Go to Plugins > Add New in your WordPress admin dashboard and search for "GeoShield Country Restrictions".
- Click Install Now, then click Activate.
- In WooCommerce > Settings > General, ensure Default Customer Location is set to "Geolocate" (recommended for automatic location detection).
- Edit any product, click the Country Restrictions tab in the Product Data box, and configure your country rules.
- Navigate to GeoShield > Settings in your WordPress sidebar to manage global settings and default restriction messages.
geoshield-country-restrictions-lite folder directly to your /wp-content/plugins/ directory and activate it through the WordPress Plugins screen.屏幕截图:
常见问题:
How does GeoShield detect a customer's country?
GeoShield uses a smart multi-layer detection engine:
- It checks Cloudflare's country header (
CF-IPCountry) first for instant 0ms edge detection if your site is behind Cloudflare. - It uses WooCommerce's built-in geolocation engine (MaxMind GeoIP2) to resolve the country locally on your server with 99.5% accuracy.
- If a customer is at checkout or logged in, their entered billing/shipping country is respected first for maximum checkout precision.
- A lightweight fallback API lookup acts as a backup only when local MaxMind is not configured.
Can I restrict a product so only customers from specific countries can buy it?
Yes. Set the restriction rule to Whitelist (Allow Selected) mode, and choose the permitted countries. Customers from any country not on your list will be restricted based on your chosen action (hidden, or visible with checkout disabled).
Can I block specific countries from buying a product?
Yes. Set the restriction rule to Blacklist (Block Selected) mode, and select the countries you wish to block. Customers from those blocked countries cannot buy or view the product, while customers from all other nations can purchase normally.
What happens to restricted customers — do they still see the product?
You have complete control via two restriction actions:
- Hide Product (Full Restriction): The product is hidden from shop archives, search results, and category pages. Direct single URL visits return a 404 or redirect to the shop page (configurable in Global Settings).
- Disable Checkout (Lock Purchase): The product remains visible in the catalog, but the Add to Cart button is replaced with your custom restriction notice.
Can I restrict individual product variations by country?
Yes. GeoShield Lite fully supports variation-level restrictions. You can sell Size Large in the United States and Canada while restricting Size Small or specific color options to other countries within the same variable product.
Does GeoShield work with WPML, Polylang, or multilingual setups?
Yes. GeoShield is fully compatible with multilingual plugins including WPML, Polylang, and TranslatePress. Restriction rules configured on a product apply consistently across all language translations.
Will caching plugins interfere with country detection?
If your host or caching plugin serves static HTML pages without recognizing location cookies, country detection can be bypassed. To prevent this, set your WooCommerce customer location setting to "Geolocate (with page caching support)" under WooCommerce > Settings > General, or configure your caching plugin (WP Rocket, LiteSpeed, W3TC) to bypass or vary cache for geolocation cookies.
Does GeoShield work with WooCommerce High-Performance Order Storage (HPOS)?
Yes. GeoShield is 100% compatible with HPOS (custom order tables) and declared compliant using WooCommerce's FeaturesUtil API.
Does GeoShield work with WooCommerce Subscriptions?
Yes. GeoShield supports both simple and variable subscription products, including variation-level restrictions on subscription tiers.
Is GeoShield GDPR compliant?
Yes. GeoShield does not collect, store, or profile personal visitor information. Only an IP address is checked in real-time to identify the geographic country. When WooCommerce's native MaxMind database is active, all geolocation lookups occur locally on your server without sending any data to third-party servers.
Can I restrict entire product categories, tags, or continents at once?
GeoShield Lite is optimized for granular control at the individual product and variation level. If your store requires automated catalog-wide rules by product category, tag, shipping class, or entire continents, you can use GeoShield Country Restrictions Pro.
What is the difference between GeoShield Lite and GeoShield Pro?
- GeoShield Lite provides everything most WooCommerce stores need: granular country restrictions configured per product or per variation with Blacklist and Whitelist modes, full catalog hiding, or locked checkout notices.
- GeoShield Country Restrictions Pro is designed for stores with large inventories requiring global catalog automation (by Category, Tag, or Shipping Class), sub-country targeting (continents, states, provinces), Catalog Mode, and automatic regional redirects.
- If your catalog expands and you need automated storewide rules, you can seamlessly Upgrade to Pro at any time.
更新日志:
1.0.3
- Security: Strengthened input sanitization, capability validations, and nonce checks across administration settings.
- Improvement: Enhanced user experience with refined dashboard statistics, modernized upgrade cards, and reliable vector icons.
- UI: Improved product-level settings toggle resilience and tooltip info in WooCommerce product data.
- Security: Enhanced input sanitization and output escaping across all admin interfaces following WordPress Coding Standards.
- Performance: Optimized geolocation transient caching to eliminate redundant lookups.
- Improvement: Enhanced core features and UI responsiveness for a smoother administrative workflow.
- Compatibility: Tested and certified compatible with WordPress 7.0.
- Initial public release on WordPress.org.
- Per-product country restrictions with Whitelist and Blacklist modes.
- Product variation-level geographic restrictions.
- Two restriction actions: Hide Product (full catalog & direct access control) and Disable Checkout (custom restriction notice).
- Native WooCommerce MaxMind GeoIP2 integration with IP lookup fallback.
- Full compatibility with WooCommerce High-Performance Order Storage (HPOS) and WooCommerce Blocks.