Provides geographic information detected by an IP adress. This can be used in themes or other plugins, as a shortcode, or via CSS body classes. The city & country names are translated in different languages (supported languages).
- You can use one of these data sources (see comparison):
- Free (default source): HostIP.info (IPv4 only)
- Free with registration: Maxmind GeoIP2 Lite City, automatically updated weekly
- Commercial: Maxmind GeoIP2 City or Maxmind GeoIP2 Country
- Commercial Web-API: Maxmind GeoIP2 Precision (City, Country or Insights)
- Hosting-Provider dependent: Cloudflare or Amazon AWS CloudFront (Country)
- Free or Commercial Web-API: Ipstack
- Commercial Web-API via AWS Marketplace: Fastah
- Provides these 5 functions (see API Documentation):
geoip_detect2_get_info_from_ip($ip, $locales = array('en'), $options = array()): Lookup Geo-Information of the specified IP
geoip_detect2_get_info_from_current_ip($locales = array('en'), $options = array()): Lookup Geo-Information of the current website user
geoip_detect2_get_current_source_description(...): Return a human-readable label of the currently chosen source.
geoip_detect2_get_external_ip_adress(): Fetch the internet adress of the webserver
geoip_detect2_get_client_ip(): Get client IP (even if it is behind a reverse proxy)
- For the property names, see the results of a specific IP in the wordpress backend (under Tools > Geolocation IP Detection).
- You can include these properties into your posts and pages by using the shortcode
[geoip_detect2 property="country.name" default="(country could not be detected)" lang="en"](where ‘country.name’ can be one of the other property names as well, and ‘default’ and ‘lang’ are optional).
- You can show or hide content by using a shortcode
[geoip_detect2_show_if country="FR, DE" not_city="Berlin"]TEXT[/geoip_detect2_show_if]. See Shortcode Documentation.
- When enabled on the options page, it adds CSS classes to the body tag such as
- If you are using a page cache, it is recommended to use the AJAX mode (see AJAX)
- When enabled on the options page, the client IP respects a reverse proxy of the server.
- If you are using Contact Form 7, you can use these shortcodes:
- A select input with all countries, the detected country being selected by default:
- A text input that is pre-filled with the detected city (or other property):
[geoip_detect2_text_input city property:city lang:fr id:id class:class default:Paris]
- Geolocation information for the email text:
- A select input with all countries, the detected country being selected by default:
- Together with SVG Flags you can show the flag of the detected country:
See Documentation for more info.
How can I use these functions?
- You could choose the currency of the store based on the country name
- You could pre-fill the shipping country
- You could show the store nearest to your customer
- You show or hide content specific to a geographic target group
- Etc. … You tell me! I’m rather curious what you’ll do with this plugin!
- Be careful to comply to the applicable laws. For example Regulation (EU) 2018/302 …
- If you need to get the user’s timezone, it is more accurate to use JS solutions.
System Requirements: You will need at least PHP 7.2.5 . Also, if you use the plugin WooCommerce, you’ll need at least WooCommerce 3.9.0 .
GDPR: See Is this plugin GDPR-compliant?
This product can provide GeoLite2 data created by MaxMind, available from http://www.maxmind.com.
geoip_detect2_get_info_from_current_ip()return the same country, regardless of where you are visiting the site from?
- Maybe your server has a reverse proxy configured. You can check this: Go to the options page and look for “reverse proxy”. Are there 2 IPs listed there? If so, which one corresponds to your public IP?
- Or maybe you are using a site cache plugin. Then enable the option
Disable caching a page that contains a shortcode or API call to geo-dependent functions.
- Install the plugin
- Go to the plugin’s option page and choose a data source.
- Test it by clicking on “Lookup” on the lookup page.
Contributors & Developers
“Geolocation IP Detection” is open source software. The following people have contributed to this plugin.Contributors
- FIX: Respect JS file variant
- UI: Show selected file variant in backend options
- Library updates
- NEW: You can now specify to use a JS file variant if you are only using a subset of the features (see https://github.com/yellowtree/geoip-detect/wiki/API:-AJAX#js-variants)
- Note[!]: frontend.js has now been renamed to frontend_full.js
- Library updates
- FIX: The format for new Maxmind licence keys has changed. (Existing licence keys will continue to work.)
(5.2.1 was a broken release)
- NEW: The list of reverse proxies of AWS CloudFront or CloudFlare can now be added as “known proxy”
- FIX [!]: AWS Cloudfront header name changed to HTTP_CLOUDFRONT_VIEWER_COUNTRY
- Reduced JS size (AJAX mode)
- Library updates
- NEW: For the reverse proxy configuration, internal adresses (such as 10.0.0.0/8) are now whitelisted by default. You can override this behaviour by using the wordpress filter
- NEW: Body classes now include the city name in English (e.g. geoip-city-Munich)
- FIX: Some server configurations showed this warning: Use of undefined constant CURL_HTTP_VERSION_2_0
New Datasource: Fastah Web API (beta), see https://aws.amazon.com/marketplace/pp/prodview-k5gjowexrefl2
* NEW: The JS function
geoip_detect.set_override_with_merge can modify the override record in one property, merging it with the currently saved property
Other minor changes:
* FIX: In non-AJAX mode, properties such as “extra.original.zip” can be accessed again
* FIX: Automatic download of Maxmind database now also works when the temp folder is group/world writeable (as in AWS configurations)
* If you want to enable more Warnings (e.g. while debugging), you can add
define('GEOIP_DETECT_DEBUG', true) to your wp-config.php or so.
* Library updates
In this release, there a small breaking changes marked by [!].
* FIX [!]: Empty attribute values such as
[geoip_detect2_show_if country=""]Country was not detected[/geoip_detect2_show_if] are now working (they were ignored before)
* FIX [!]: Shortcodes that have an invalid value for the property
[geoip_detect2_text_input ajax="invalid"]) are now using the AJAX option instead of always disabling AJAX
* FIX: In CF7, the country selector can now be used in AJAX mode
* FIX: In AJAX mode, the shortcode
[geoip_detect2_show_if] renders as a
<div> if it detects that the containing content has HTML block level elements
* NEW (Beta): In AJAX mode, the new property
autosave saves the user input as local override for this browser.
[geoip_detect2_countries mycountry autosave] and
[geoip_detect2_text_input city property:city autosave]. (Please give feedback if this works as expected!)
* FIX: In AJAX mode, calling the method
set_override(record, duration_in_days) now refreshes the AJAX shortcodes and CSS body classes.
-> Thus, it is now possible to quickly implement different content for different countries with an autodetected default country, see https://github.com/yellowtree/geoip-detect/wiki/API-Usage-Examples#country-selector-that-can-be-overridden-by-the-user
* NEW: Drastically improving performance if the lookup is performed for the current IP more than once (e.g. because of shortcodes without AJAX mode)
* UI: Showing the time for the subsequent lookup on the Test Lookup page
* FIX: Maxmind Datasource: Check if the database file is really a file, not a directory
* NEW: Header Datasource: Now a custom HTTP header can be used via the wordpress filter
Other minor changes:
* Update the list of available APIs for getting the external IP (as whatismyip went down)
* Minimum WordPress version is 5.4 now.
* Update some internal libraries & dev tools
* Checked compatibility with PHP 8.1
- FIX: Further improve the Maxmind admin notice UI
- Update some smaller libraries
- FIX: Show Maxmind admin notice only on GeoIP pages to make it less intrusive
- FIX: Do not disable lookup automatically when potentially incompatible Maxmind libraries are found.
- NEW: Show a warning on the options page when there are incompatibilities with other plugins that also use the Maxmind libraries.
- FIX: Remove an incompatibility of the libraries with Toolset or other Laravel-based plugins
- NEW: In CF7, you can now add any property to the mail body with a special syntax, e.g.
- FIX (JS): Replace the internally used library ‘lodash’ with ‘just’ to reduce the JS file size
- FIX (JS): Improve error handling in AJAX mode
- FIX: Port numbers in reverse proxies are ignored now (removes incompatibility with Azure reverse proxies)
- FIX: Prevent Cloudflare APO from caching when using AJAX mode or page caching is disabled in the plugin options
- NEW: An
[geoip_detect2_show_if city="Berlin"]You are in Berlin[else]You are not in Berlin[/geoip_detect2_show_if]
- FIX: The JS for AJAX wasn’t working for Safari browsers
- FIX: Improving some edge cases of
Record.get_with_locales()and other methods of
Recordto be consistent with non-AJAX mode
- FIX: Revert more Maxmind libraries to fix incompatibility with WooCommerce
- FIX: Revert Maxmind library to 2.10.0 for now as the most current version seems to be incompatible with Wordfence and other plugins using the older version of the Maxmind library
This version has many changes regarding the Shortcodes API. It is a major version because it increases some system requirements (see below).
- NEW: Shortcodes can now also be resolved in AJAX mode (without coding JS).
If you are using a page cache, AJAX mode is the best solution for you. And thanks to shortcodes, this doesn’t need custom coding anymore.
You can keep using the same shortcodes as before – just tick the options “Enable AJAX endpoint” and “Resolve shortcodes (via AJAX)”.
Instead of doing the geo-lookup while generating the HTML, it will generate boilerplate HTML (for the cache) that will be filled by the plugin’s JS automatically (in the client’s browser).
- NEW: JS has a new function called
set_override(record, duration_in_days)(see AJAX documentation) so that the record information can be overridden manually (e.g. when the user selects a certain country manually). A PHP equivalent will follow.
- NEW: The JS syntax of the shortcodes now supports both underscore_case and camelCase (e.g. both country.is_in_european_union and country.isInEuropeanUnion are valid)
- NEW: [geoip_detect2_show_if] and [geoip_detect2_hide_if] now have a new attribute
operator="OR"– this can be used to create conditions such as “continent = EU OR country = US”
* NEW (UI): Add a “Empty Cache”-Button on the Lookup page if the data source is caching the results
* FIX: In some cases, the Privacy Exclusions Update wasn’t rescheduled properly before
* FIX: Ipstack: The property country.isInEuropeanUnion is now filled properly.
* Updated vendor code
* The minimum PHP version is now 7.2.5
* Minimum WordPress version is now 5.0
* The plugin is now using PHP Type-Hinting for API functions – if you used the PHP API, please check if you see PHP errors
* If you are using WooCommerce, you need at least version 3.9.0 (released Jan 2020) – otherwise this plugin lookup disables itself
- NEW shortcode
- NEW option “Add a country-specific CSS class to the -Tag (via AJAX).” It is enabled automatically when upgrading the plugin, if the options “AJAX” and the “body tag” was enabled before.
- Some UI fixes
- FIX: Fix a fatal error that can occur in 3.2.0 if WP_DEBUG is enabled on your installation.
- NEW: The plugin now integrates the Maxmind Privacy Exclusion API. If you are using a Maxmind datasource, the plugin will return an empty result when looking up an IP that is on the privacy blacklist. You need to enter your Account ID for this.
- FIX: If timeZone is unknown, leave empty value instead of NULL
- FIX: Improve compatibility with PHP 8.0
- UI: Improving some strings for clearer documentation
- AJAX mode is now declared stable (no code change)
- NEW: The shortcode
[geoip_detect2_text_input]now has a parameter
typefor hidden or other HTML5 input types (see Postal code example)
- FIX: The Backend UI “Lookup” does not show an empty timezone anymore if there is no data attached to this IP.
- NEW: In all datasources, the new record property
$record->extra->currencyCodefor the currency code of the detected country has been added
- FIX: Compatibility with PHP 8.0
- NEW: Add the possibility to access the ISO-3166 alpha3 version of
- FIX: The (CF7) shortcode
[geoip_detect2_countries]now selects the selected country on page reload (the HTML tag autocomplete is set to
- FIX: Subnets can now be entered in the preferences of the reverse proxy again (this was a regression of the Admin UI changes in 3.0.3)
- FIX: Do not log “It has not changed since the last update.” as a cron-related error that should be shown to the user.
- FIX: The property access for shortcodes has been rewritten so that property names such as “extra.original.zip” (Datasource: ipstack) are possible now.
- FIX: The lookup page now also shows subdivisions (e.g. for IPs from Uk that have 2 levels of subdivisions)
- NEW: The (CF7) shortcode
[geoip_detect2_countries mycountry include_blank flag tel]now adds the flag emoji (or ISO code in Windows) and the telephone international code to the country name
- FIX: AJAX mode: Using localStorage instead of Cookies for caching (as we hit the Cookie size limitation sometimes)
- FIX: AJAX mode: Remove jQuery dependency
- FIX: AJAX mode:
- When an error occurs during the Cron update of the Maxmind database, it is now shown in the backend.
- FIX: All times shown in the Admin backend now use the timezone set by WordPress
- FIX: In the Admin Options, it was not possible to revert an hardcoded “External IP of this server” back to “automatic detection”
[geoip_detect2_show_if property="country.isInEuropeanUnion" property_value="true"]Products list for EU[/geoip_detect2_show_if]now works properly (boolean values can be “true”/”yes” or “false”/”no”)
[geoip_detect2_current_flag]now compatible with the SVG Flags version 0.9.0. See Documentation for more infos.
- Minor admin improvement: If the value “IPs of trusted proxies” is set, but “The server is behind a reverse proxy” is not ticked, issue an warning
- Hotfix: The filename specified in the manual datasource can be changed properly again.
- The Plugin has been renamed to “Geolocation IP Detection” in order to prevent trademark issues
- FIX: Minor improvements in the backend UI
- FIX: Security hardening against XSS
(Was not released)
- FIX: Button “Update now” now works also on the lookup page.
- FIX: Reverted the vendor code to the one used in 2.13 because it broke installations with the WooCommerce-plugin. I will update the vendor code again once we found a long-term solution for this interdepency.
- MAJOR CHANGE: Due to legal reasons, Maxmind now requires registration and some use cases are no longer allowed with the free data. If you use the Maxmind data source with automatic update, the update will fail for versions < 3.0 or if you have not entered a license key yet.
- Updated the Maxmind update mechanism
- Updated Maxmind vendor code
The code of the plugin has not changed much, I have named this version 3.0 to indicate the major change on Maxmind’s side of things. They explain it in this blog post: