No Name Street 35, New York, USA
We have what you need
[/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](https://wpgeocontroller.com/documentation/quick-start/geo-controller-shortcodes/cfgeo_map) 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 array * `CFGP_U::api('country_code')` for a single available field * `CFGP_API::lookup()` for an explicit advanced lookup * `window.cfgeo` when 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](https://wpgeocontroller.com/pricing). Geo Controller depends on an external API service for IP lookup data. Review the [Privacy Policy](https://wpgeocontroller.com/privacy-policy) and [privacy, consent, and compliance documentation](https://wpgeocontroller.com/documentation/concepts/privacy-consent-and-compliance) to decide how the service fits your site’s disclosures and legal obligations. #### Plugin Links * [Geo Controller Website](https://wpgeocontroller.com/) * [Documentation](https://wpgeocontroller.com/documentation) * [Contact & Support](https://wpgeocontroller.com/contact-and-support) * [Terms and Conditions](https://wpgeocontroller.com/terms-and-conditions) * [Privacy Policy](https://wpgeocontroller.com/privacy-policy) #### 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](https://wpgeocontroller.com/privacy-policy), [Terms and Conditions](https://wpgeocontroller.com/terms-and-conditions), and [privacy documentation](https://wpgeocontroller.com/documentation/concepts/privacy-consent-and-compliance) before deployment. ## Screenshots [⌊Geo Controller Available shortcodes and values⌉⌊Geo Controller Available shortcodes and values⌉[ Geo Controller Available shortcodes and values [⌊CF Google Map shortcodes and setup⌉⌊CF Google Map shortcodes and setup⌉[ CF Google Map shortcodes and setup [⌊Anti Spam Protection settings⌉⌊Anti Spam Protection settings⌉[ Anti Spam Protection settings [⌊Geo Controller global settings⌉⌊Geo Controller global settings⌉[ Geo Controller global settings [⌊Debug Mode for Geo Controller and IP Lookup⌉⌊Debug Mode for Geo Controller and IP Lookup⌉[ Debug Mode for Geo Controller and IP Lookup [⌊Adding shortcode in text editor⌉⌊Adding shortcode in text editor⌉[ Adding shortcode in text editor [⌊Admin bar quick links⌉⌊Admin bar quick links⌉[ Admin bar quick links [⌊Example 1⌉⌊Example 1⌉[ Example 1 [⌊Example 2⌉⌊Example 2⌉[ Example 2 [⌊Example 3⌉⌊Example 3⌉[ Example 3 [⌊SEO Redirection settings⌉⌊SEO Redirection settings⌉[ SEO Redirection settings [⌊Contact Form 7 settings⌉⌊Contact Form 7 settings⌉[ Contact Form 7 settings [⌊Available tags⌉⌊Available tags⌉[ Available tags [⌊WooCommerce Settings⌉⌊WooCommerce Settings⌉[ WooCommerce Settings [[ ## Installation 1. Install **Geo Controller** from the WordPress Plugins screen, or upload the plugin files to `/wp-content/plugins/cf-geoplugin/`. 2. Activate the plugin. 3. Open **Geo Controller** in WordPress administration and review the general, feature, cache, and proxy settings. 4. Test a basic lookup with `[cfgeo return="country" default="Unknown"]`. 5. Configure only the modules you need, then test location rules with caching enabled exactly as it will be in production. When the plugin is uninstalled through WordPress, its plugin options, license data, transients, and plugin-owned database data are removed. Back up any configuration you may need before uninstalling. ## FAQ ### Is Geo Controller free? 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](https://wpgeocontroller.com/pricing). ### Is Geo Controller the same plugin as CF Geo Plugin? 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. ### What information is sent to an external service? 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](https://wpgeocontroller.com/privacy-policy) and document these services appropriately for your site. ### How accurate is IP geolocation? 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. ### How can I test content for another country, region, or city? 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. ### Why does every visitor see the same location-based content? 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](https://wpgeocontroller.com/documentation/concepts/dynamic-content-and-caching). ### Why is a field empty or showing its default value? 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. ### Can I use shortcodes in a custom theme or template? Yes, when the template processes WordPress shortcodes. For example: ``` echo do_shortcode('[cfgeo return="country" default="Unknown"]'); ``` Use [WordPress do_shortcode()](https://developer.wordpress.org/reference/functions/do_shortcode/) only where rendering administrator-controlled shortcode content is appropriate. ### How do I access geolocation data in PHP? 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](https://wpgeocontroller.com/documentation/advanced-usage/php-integration). Historic global variables from older CF Geo Plugin releases should not be used for new integrations. ### How do I access geolocation data in JavaScript? 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](https://wpgeocontroller.com/documentation/advanced-usage/javascript-integration). ### Can I populate Contact Form 7 fields? 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. ### Does Geo Controller slow down a site? 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. ### Does Geo Controller make a site legally compliant? 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. ### Where can I get help? Start with the [documentation](https://wpgeocontroller.com/documentation). If the issue remains, use [Contact & Support](https://wpgeocontroller.com/contact-and-support) and include the plugin version, WordPress version, relevant settings, Debug output with secrets removed, and steps to reproduce. ## Reviews  ### [Closing the door](https://wordpress.org/support/topic/closing-the-door/) [designwise](https://profiles.wordpress.org/designwise/) December 13, 2025 Finally a way to slam the door on countries whose only goal is to hack.  ### [nice and functional plugin](https://wordpress.org/support/topic/nice-and-functional-plugin/) [wildone1600](https://profiles.wordpress.org/wildone1600/) February 26, 2025 I work with international customers and this plugin helps me a lot getting the local data.Tip: give some examples how to use the shortcodes and GEO Controller menu text does not explain it shows all the shortcodes. Try to think as a dummy. Makes it a lot easier to understand.Thanks anyway for your plugin dev.  ### [Awesome plugin with geo-settings. Thank you](https://wordpress.org/support/topic/awesome-plugin-with-geo-settings-thank-you/) [bogdan547](https://profiles.wordpress.org/bogdan547/) October 4, 2024 I recently used the Geo Controller plugin, and I want to share my impressions. I want to note right away that I liked the flexibility of the settings that allow you to adapt the service to your needs. This is especially important when working with clients from different countries. The Geo Controller service provides a user- friendly interface for managing geographic data, which greatly simplifies working with international projects. Overall, I was satisfied with the service and recommend it to those who are looking for a reliable plugin to work with geographical data.  ### [Best in the Geo plugins](https://wordpress.org/support/topic/best-in-the-geo-plugins/) [sumitsharmawp](https://profiles.wordpress.org/sumitsharmawp/) August 13, 2024 Always gives precise result. This is the best geo location plugin. I started with their free version and moved to a paid one. Thank you, team. keep it up.  ### [Does the job well… BUT…](https://wordpress.org/support/topic/does-the-job-well-144/) [koandj](https://profiles.wordpress.org/koandj/) June 21, 2024 1 reply First, the documentation should definitely improve: elements are missing, implementation is not as clear, same with options (i.e. can I use the original name? Like Firenze instead of Florence), etc. Lots can be done there. And it's a bit annoying that it uses square brackets [ ] rather than curly {{ }}, because when you copy and paste, Gutenberg automatically converts the content to a shortcode, and this is no shortcode. Also, I live in London, but if I write include="London" it fails to recognise me because it believes my City is Westminster, which is rather the borough. The 1000 hits a day limit is not going to work for many: simply including the code in a post and testing it already consumed 54 hits (7 upon opening the settings page the first time). Anyway, the plugin does its job well. And I found that you can use it for more than just text: if you write a paragraph with [cfgeo include=""], then any amount of content in any Gutenberg block, and then close another paragraph with a [/cfgeo], the entire content gets managed by the plugin. So that's great. If everything I noted above can be sorted out, it's definitely a 5-star plugin. Ah, one more thing… Give an option to remove the content in the top admin bar, for those who find it unnecessary and annoying. Update: Ran out of the 1000 hits in just 1 week. Tested this on 1 old page on a very niche blog getting just about a dozen visitors a day( the page itself got only 2 visits in the period and the plugin is blocked on the other pages with Asset CleanUp), so obviously it's not a real match and it seems miscoded on purpose to convince you to upgrade… Guess it's not worth using this instead of other plugins then, unless you really need it and have the money. Downgraded from 3 stars to 1.  ### [Difficult Interface – Lacks documentation.](https://wordpress.org/support/topic/difficult-interface-lacks-documentation/) [fullermetric](https://profiles.wordpress.org/fullermetric/) November 24, 2023 Thought I would give this a try. Documentation was not clear to know whether you adding countries to block or adding countries to allow. I tried both ways, but neither choice blocked me when attempting to view our site through a VPN.. There are complete sections missing from to documentation. [ Read all 31 reviews ](https://wordpress.org/support/plugin/cf-geoplugin/reviews/) ## Contributors & Developers “Geo Controller – Geolocation & Geotargeting” is open source software. The following people have contributed to this plugin. Contributors * [ INFINITUM FORM ](https://profiles.wordpress.org/creativform/) * [ Ivijan-Stefan Stipic ](https://profiles.wordpress.org/ivijanstefan/) [Translate “Geo Controller – Geolocation & Geotargeting” into your language.](https://translate.wordpress.org/projects/wp-plugins/cf-geoplugin) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/cf-geoplugin/), check out the [SVN repository](https://plugins.svn.wordpress.org/cf-geoplugin/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/cf-geoplugin/) by [RSS](https://plugins.trac.wordpress.org/log/cf-geoplugin/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 9.0.5 * Reworked the WordPress.org readme with clearer geolocation, geotargeting, WooCommerce, access-control, privacy, caching, and licensing guidance. * Added accessible Copy controls for shortcode, geo tag, CSS property, and Google Maps syntax examples, with fallback and translated feedback. * Refined the five primary admin pages with cleaner, compact tabs, tables, sections, descriptions, focus states, and responsive controls. * Aligned Simple Shortcodes tab visibility with its standard feature setting. #### 9.0.4 * Fixed [in_eu] and [not_in_eu] shortcode registration after the Simple Shortcodes option moved from beta to standard settings. #### 9.0.3 * Security: moved dedicated Geo Controller API endpoints to HTTPS and removed the former automatic direct-IP HTTP downgrade. * API: added centralized, backward-compatible GET/POST transport selection; GET remains the default, while POST sends API parameters in the request body. * Added an optional Defender emergency direct-IP HTTP fallback that is disabled by default and excludes license keys, API secrets, authentication tokens, passwords, and renewal data. * Security: validated forwarding headers against trusted proxy and Cloudflare ranges, bounded and rate-limited public location requests, and restricted integration actions to administrators. * Security: safely JSON-encoded dynamic geolocation JavaScript property names and values so remote or cached data cannot escape the inline object. * Compatibility: preserved geolocation, Defender, licensing, API response handling, product information, Live News, and WordPress update integrations. #### 9.0.2 * Fixed escaped shortcode examples and interactive map configuration output. * Moved the Simple Shortcodes option to standard feature settings and kept Redis caching experimental. * Compatibility: improved WooCommerce Classic Checkout, Checkout Blocks, Store API, and HPOS order handling. * Fixed WooCommerce price conversion, geolocation, payment-country restrictions, and gateway settings output. #### 9.0.1 * Fixed license renewal synchronization for renewed subscription activations. * Added automatic renewal revalidation for valid subscription activations. * Improved expired-license renewal diagnostics and administrator guidance. #### 9.0.0 * Compatibility: maintained PHP 7.0 to PHP 8.4 support. * Stabilized shortcode and Geo Banner caching across transient, database, and Redis modes. * Fixed cache cleanup and prevented Geo Banner caching when disabled. * Stabilized shortcode, GPS, Geo Banner, and Google Map attributes while preserving legacy support. * Added optional REST API transport for public authentication and lookups; AJAX remains the default. * Added API transport settings and endpoint documentation. * Preserved existing API responses and access-token behavior. * Security: protected Defender saves, previews, and bypass cookies with capability, nonce, and method checks. * Security: limited permanent Defender bypass to administrators and removed legacy recovery and bot bypasses. * Security: added single-use recovery links for temporary WordPress login access. * Security: protected global and page-level SEO settings with capability, nonce, and method checks. * Fixed postcode matching, country-city redirects, exclusion rules, empty CSV exports, and import rollbacks. * CSS display controls now preserve flex, grid, inline, inline-block, table, and other display modes. ## Meta * Version **9.0.5** * Last updated **12 hours ago** * Active installations **1,000+** * WordPress version ** 6.0 or higher ** * Tested up to **7.1.3** * PHP version ** 7.0 or higher ** * Language * [English (US)](https://wordpress.org/plugins/cf-geoplugin/) * Tags * [GeoIP](https://srd.wordpress.org/plugins/tags/geoip/)[geolocation](https://srd.wordpress.org/plugins/tags/geolocation/) [geotargeting](https://srd.wordpress.org/plugins/tags/geotargeting/)[redirect](https://srd.wordpress.org/plugins/tags/redirect/) [woocommerce](https://srd.wordpress.org/plugins/tags/woocommerce/) * [Advanced View](https://srd.wordpress.org/plugins/cf-geoplugin/advanced/) ## Ratings 4.4 out of 5 stars. * [ 26 5-star reviews ](https://wordpress.org/support/plugin/cf-geoplugin/reviews/?filter=5) * [ 0 4-star reviews ](https://wordpress.org/support/plugin/cf-geoplugin/reviews/?filter=4) * [ 1 3-star review ](https://wordpress.org/support/plugin/cf-geoplugin/reviews/?filter=3) * [ 0 2-star reviews ](https://wordpress.org/support/plugin/cf-geoplugin/reviews/?filter=2) * [ 4 1-star reviews ](https://wordpress.org/support/plugin/cf-geoplugin/reviews/?filter=1) [Your review](https://wordpress.org/support/plugin/cf-geoplugin/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/cf-geoplugin/reviews/) ## Contributors * [ INFINITUM FORM ](https://profiles.wordpress.org/creativform/) * [ Ivijan-Stefan Stipic ](https://profiles.wordpress.org/ivijanstefan/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/cf-geoplugin/) ## Donate Would you like to support the advancement of this plugin? [ Donate to this plugin ](https://ko-fi.com/ivijanstefanstipic)