Geo Controller – Geolocation & Geotargeting
WordPress geolocation and geotargeting with IP lookup, geo redirects, dynamic content, WooCommerce localization and visitor blocking.
4.4
(31 ratings)Will this break my store?
What the WordPress.org registry says about keeping Geo Controller – Geolocation & Geotargeting running.
Tested to 7.1.3
Tested against the WordPress branch in use today.10 days ago
At least 2.7 releases a year since launch. WordPress.org only lists versions still available for download, so the real number may be higher.7.0
Your host must be running at least this version.6.0
2
Maintenance & trust
Scored on how Geo Controller – Geolocation & Geotargeting is looked after — not on how many stores run it.
95
out of 100Maintenance
35 / 35WordPress compatibility
20 / 20Support responsiveness
Not enough dataMerchant satisfaction
11 / 15Listing transparency
10 / 10Ratings
4.4
31 ratingsGeo Controller is a WordPress geolocation and geotargeting plugin that uses IP location data to personalize website content, redirect visitors by country or region, localize WooCommerce, and control geographic access. It combines location-based shortcodes, conditional content, geo redirects, country flags, Google Maps, Geo Defender, and developer APIs in one plugin.
Previously known as CF Geo Plugin, Geo Controller continues the development of the original WordPress geolocation plugin under its new name. Existing users can continue using supported shortcodes, integrations, and location-based functionality without switching to a different plugin.
WordPress IP Geolocation
Geo Controller resolves a visitor’s IP address through the Geo Controller API and makes the available location data accessible in WordPress. Depending on the lookup response and enabled options, this can include country, region, city, postcode, coordinates, timezone, language, currency, ISP, hostname, proxy, TOR, and device information.
- IPv4 and IPv6 lookup support
- Trusted proxy and Cloudflare-aware IP detection
- Configurable SSL, proxy, cache, and API transport settings
- Default values when requested data is unavailable
- Optional DNS, ISP, currency, and device-related data
IP geolocation is approximate. VPNs, proxies, mobile networks, shared connections, CDN configuration, and database accuracy can affect results. Review data sources and accuracy and IP detection guidance before using location data for important decisions.
Geotargeting and Dynamic Content
Use WordPress shortcodes to display visitor data or conditionally show content by country, region, city, continent, postcode, EU status, VAT status, proxy, TOR, or device type. Geo Banner rules provide another way to target text, media, and other WordPress content.
Common examples:
[cfgeo return="country"]
[cfgeo return="city" default="Your Default Text"]
[cfgeo include="US,GB,DE"]Content for selected countries.[/cfgeo]
[in_eu]Content for EU visitors.[/in_eu]
Nested shortcodes remain available in conditional content where the surrounding WordPress content area processes shortcodes. Optional Simple Shortcodes, such as [cfgeo_city], must be enabled in Geo Controller settings. See the shortcode reference for supported attributes and return values.
Location-specific HTML can be affected by full-page caching when one cached response is shared between visitors. Follow the dynamic content and caching guidance and test every rule with a safe fallback.
Common Geolocation Use Cases
Geo Controller can be used to create location-aware WordPress experiences without building a separate geolocation system.
- Display different content, messages, banners, or affiliate links based on visitor location.
- Redirect visitors to country-specific pages, regional websites, or localized content.
- Show local contact information, phone numbers, addresses, and Google Maps.
- Customize WooCommerce payment options and currency information by visitor location.
- Restrict access from selected countries, IP addresses, proxies, or TOR networks.
- Provide location-based information to custom themes, plugins, forms, and integrations.
These features can be combined using shortcodes, conditional content, WordPress integrations, and developer APIs. Availability depends on configuration and, for selected features, the active license.
Geo Redirects and Geographic SEO Redirection
Create ordered geographic rules for pages, posts, custom post types, or site-wide destinations. Rules can evaluate supported country, region, city, and postcode values, with exclusions, bot handling, referrer controls, and CSV import/export tools.
Available response codes are 301, 302, 303, 307, 308, and 404. Choose the response that matches the intended behavior: permanent redirects should not be used while destinations are still being tested, and 404 returns a not-found response rather than redirecting the visitor.
Redirects do not guarantee search-engine results or legal compliance. Avoid redirect loops, keep destinations crawlable where appropriate, and test caching, canonical URLs, language settings, and bot behavior before production use.
WooCommerce Geolocation, Currency and Payments
The included WooCommerce integration can use Geo Controller location data to support:
- Customer geolocation and location data saved with orders
- Country-based payment gateway visibility
- Local currency information and currency conversion
- EU and VAT-aware content
- Classic Checkout, Checkout Blocks, Store API, and HPOS workflows
Some WooCommerce controls and service-backed data require an eligible active license. Availability is shown in the plugin settings. Currency results are informational and may not match the final rate used by a payment provider, bank, tax service, or accounting system.
Geo Defender and Visitor Access Control
Geo Defender can restrict access using configured geographic and IP rules, with support for TOR, proxy, and spam-related signals where available. Administrators can configure a response, allow trusted addresses, receive notifications, and use the existing recovery mechanism if a rule blocks administrative access.
Geolocation and reputation signals can be incomplete or incorrect. Geo Defender is an access-control aid, not a replacement for authentication, a firewall, malware protection, or professional security and compliance review. Test rules carefully before enabling them on a production site.
Google Maps, Country Flags and Geographic Metadata
Enable [cfgeo_map] to display a single-point Google Map for a detected or specified location. A valid Google Maps API key is required.
[cfgeo_map longitude="-74.0059" latitude="40.7128" zoom="15" title="My Company Name"]
<h3>My Company Name</h3>
<p>No Name Street 35, New York, USA</p>
<p>We have what you need</p>
[/cfgeo_map]
Geo tags can add configured geographic metadata to selected public content. Country flags are available through [cfgeo_flag], including custom country, size, class, ID, inline CSS, and include/exclude options.
Examples:
[cfgeo_flag]
[cfgeo_flag country="ca" size="32px"]
Read the Google Maps shortcode documentation before enabling map output. Google Maps is a separate external service with its own account, billing, terms, and privacy behavior.
Integrations and Developer Features
The plugin contains dedicated integration code for WooCommerce, Elementor, Contact Form 7, Gravity Forms, BuddyBoss Platform, WooPlatnica, and Yoast SEO. It also includes Cloudflare-aware IP handling and settings intended for common caching configurations. Compatibility still depends on the active theme, plugin versions, cache/CDN behavior, and site configuration.
Developers can use:
CFGP_U::api()for the current structured geodata arrayCFGP_U::api('country_code')for a single available fieldCFGP_API::lookup()for an explicit advanced lookupwindow.cfgeowhen the plugin’s JavaScript output is enabled- Native WordPress
do_shortcode()in templates that intentionally render shortcode content - The optional public REST lookup feature when the required license level is active
Always validate returned keys and provide fallbacks because not every lookup returns every field.
Free and Licensed Features
The plugin can be installed and used without a paid license. The standard Geo Controller API allowance is up to 500 lookups per day. An active paid license provides unlimited lookups during its license period, and some service-backed features are enabled according to license level.
License-dependent controls can include automatic spam-IP checks, selected WooCommerce payment controls, and the public REST lookup service. The admin interface indicates whether a setting requires a license. Current license plans, available features, and site limits are listed on the pricing page.
Geo Controller depends on an external API service for IP lookup data. Review the Privacy Policy and privacy, consent, and compliance documentation to decide how the service fits your site’s disclosures and legal obligations.
Plugin Links
External Services and Privacy
Geo Controller sends IP lookup requests to the Geo Controller API. Optional Google Maps output uses Google Maps separately when configured. Site owners are responsible for evaluating these services, providing appropriate notices or consent, and meeting applicable legal requirements.
Review the Privacy Policy, Terms and Conditions, and privacy documentation before deployment.
Yes. The plugin works without a paid license with a standard allowance of up to 500 API lookups per day. Active paid licenses provide unlimited lookups during the license period and enable features associated with the applicable license level. See the current plans.
Yes. Geo Controller was previously known as CF Geo Plugin. It is the continuation of the same WordPress plugin, with ongoing development, improved functionality, and maintained compatibility with supported existing shortcodes and integrations. Existing users do not need to install a separate plugin or migrate to a different product.
IP geolocation requires communication with the Geo Controller API. An IP address and technical request data are processed to return approximate location information. Optional Google Maps output communicates with Google when enabled. Review the Privacy Policy and document these services appropriately for your site.
IP geolocation estimates network location; it does not verify a person’s physical position. Country results are generally more reliable than city or postcode results. VPNs, proxies, mobile carriers, corporate gateways, satellite connections, and incorrect trusted-proxy settings can change the detected IP or location. Provide fallback content and avoid using an IP result as the sole basis for high-impact decisions.
Use a controlled connection or reputable testing service that provides an exit point in the target location, then confirm the detected IP and fields on Geo Controller’s Debug page. Clear relevant page and plugin caches between tests. Do not assume that one VPN endpoint represents every visitor in that location.
A full-page cache or CDN may be serving one visitor’s rendered HTML to everyone. Exclude pages that require per-visitor output, use the plugin’s supported dynamic/AJAX behavior where appropriate, and purge caches after changing rules. See dynamic content and caching.
The provider may not have that field for the detected IP, the daily allowance may have been reached, the request may have failed, or proxy/CDN settings may identify the wrong address. Check the Debug page, the displayed API response and error, SSL/proxy settings, trusted forwarding headers, and server logs. Use a default shortcode value for expected gaps.
Yes, when the template processes WordPress shortcodes. For example:
echo do_shortcode('[cfgeo return="country" default="Unknown"]');
Use WordPress do_shortcode() only where rendering administrator-controlled shortcode content is appropriate.
Use the current helper and validate keys defensively:
$data = CFGP_U::api();
$country = is_array($data) ? ($data['country'] ?? '') : '';
$country_code = CFGP_U::api('country_code');
$response = CFGP_API::lookup('8.8.8.8', ['dns' => true]);
$city = is_array($response) ? ($response['city'] ?? '') : '';
See the PHP integration documentation. Historic global variables from older CF Geo Plugin releases should not be used for new integrations.
Enable the plugin’s JavaScript output, then read the generated window.cfgeo object after it is available:
if (window.cfgeo) {
console.log(window.cfgeo.country);
}
See the JavaScript integration documentation.
Yes, if JavaScript output is enabled. A form can contain fields such as:
[text* city placeholder "* City Name"]
[text* country placeholder "* Country Name"]
Your site script can then assign window.cfgeo.city and window.cfgeo.country after checking that the object and fields exist. Escape or validate values for the target context.
Any API call and location-dependent rendering has a cost. Geo Controller caches lookup data and supports dynamic loading options, but actual impact depends on hosting, network latency, cache configuration, enabled modules, and traffic. Measure the relevant pages and avoid unnecessary repeated lookups.
No plugin can guarantee compliance automatically. Geo Controller provides location-aware conditions that may support a site’s implementation, but the site owner remains responsible for notices, consent, access rules, data processing, taxes, and applicable law. Obtain qualified advice where needed.
Start with the documentation. If the issue remains, use Contact & Support and include the plugin version, WordPress version, relevant settings, Debug output with secrets removed, and steps to reproduce.
Categories
Plugin details
Tags on WordPress.org
Alternatives
Other plugins in the same categories.
Checkout Field Editor (Checkout Manager) for WooCommerce
Price Based on Country for WooCommerce
Calculadora de Frete e Campos Checkout para o Brasil
Admin Columns
