IPGeolocation.io – Geo Redirects & Content Control

IPGeolocation.io – Geo Redirect & Content Control is a powerful WordPress plugin that allows you to control how visitors interact with your site based on their geographic location.

The plugin uses the ipgeolocation.io API to determine a visitor’s country and other metadata, enabling advanced geo-based logic without slowing down your site.

Main Features

• Country-based redirects (entire site, specific pages, or URL patterns)
• Optional popup confirmation before redirect
• Country-level access control (allow or block)
• Conditional content shortcodes
• Output visitor geolocation data via shortcode
• Page and query-string exclusions
• Redirect bypass and reset via URL parameters
• Bot detection (search engines & social crawlers excluded)
• Administrator-safe (admins are never redirected)
• IP response caching using WordPress transients

Configuration

The plugin supports the following API plans from ipgeolocation.io:

• Developer (Free)
• Paid

Additional security-related features are available for paid plans only.

Shortcodes

Display Single Geolocation Field

[ipgeo country]
[ipgeo city]
[ipgeo country_code]
[ipgeo latitude]
[ipgeo longitude]

Available fields include:
ip, city, state, country, country_code, zipcode, continent, latitude, longitude, currency, calling_code, languages, is_proxy, is_tor, is_anonymous, cloud_provider

Conditional Content (Show If Match)

[ipgeo_if country_code=”US,CA” logic=”OR”]
Visible to visitors from the US or Canada.
[/ipgeo_if]

Supported attributes:
* country
* country_code
* state
* city
* continent
* is_proxy
* is_tor
* is_cloud_provider
* is_anonymous
* logic (AND / OR)

Conditional Content (Hide If Match)

[ipgeo_if_not country=”Germany”]
Hidden from visitors in Germany.
[/ipgeo_if_not]

Redirect Bypass

For testing or user control, redirects can be bypassed:

• ?geo_bypass=1 — bypass redirects for 30 days
• ?geo_reset=1 — reset the bypass cookie

External Services Used

This plugin relies on the ipgeolocation.io API to provide its core geolocation functionality.

API Features Used:
– Determines visitor country, city, state, continent, latitude/longitude, and more
– Detects proxy, VPN, Tor usage, and cloud providers
– Enables country-based redirects, content visibility rules, and access control
– Caches API responses for 24 hours per IP to reduce requests and improve performance

Important Notes:
– An ipgeolocation.io API key is required. You can obtain one by creating a free or paid account at ipgeolocation.io.
– Without the API, the plugin’s core features (redirects, content rules, access control) will not function.
– All API calls respect the user’s privacy and are only used for geolocation purposes.

Link to Terms of Use: ipgeolocation.io Terms

License

This plugin is licensed under the GPL v2 or later.