Provides geographic information detected by an IP adress.

Benjamin Pick

<p>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 (<a href="https://dev.maxmind.com/geoip/geoip2/web-services/#Languages-8" rel="nofollow ugc">supported languages</a>).</p>
<h4>Features:</h4>
<ul>
<li>You can use one of these data sources (see <a href="https://github.com/yellowtree/geoip-detect/wiki/FAQ#which-data-source-should-i-choose" rel="nofollow ugc">comparison</a>):
<ul>
<li>Free (default source): <a href="http://www.hostip.info/" rel="nofollow ugc">HostIP.info</a> (IPv4 only)</li>
<li>Free with registration: <a href="http://dev.maxmind.com/geoip/geoip2/geolite2/" rel="nofollow ugc">Maxmind GeoIP2 Lite City</a>, automatically updated weekly</li>
<li>Commercial: <a href="https://www.maxmind.com/en/geoip2-country-database" rel="nofollow ugc">Maxmind GeoIP2 City</a> or <a href="https://www.maxmind.com/en/geoip2-city" rel="nofollow ugc">Maxmind GeoIP2 Country</a></li>
<li>Commercial Web-API: <a href="https://www.maxmind.com/en/geoip2-precision-services" rel="nofollow ugc">Maxmind GeoIP2 Precision</a> (City, Country or Insights)</li>
<li>Hosting-Provider dependent: <a href="https://support.cloudflare.com/hc/en-us/articles/200168236-What-does-CloudFlare-IP-Geolocation-do-" rel="nofollow ugc">Cloudflare</a> or <a href="https://aws.amazon.com/blogs/aws/enhanced-cloudfront-customization/" rel="nofollow ugc">Amazon AWS CloudFront</a> (Country)</li>
<li>Free or Commercial Web-API: <a href="https://ipstack.com" rel="nofollow ugc">Ipstack</a></li>
<li>Commercial Web-API via AWS Marketplace: <a href="https://aws.amazon.com/marketplace/pp/prodview-k5gjowexrefl2" rel="nofollow ugc">Fastah</a></li>
</ul>
</li>
<li>Provides these 5 functions (see <a href="https://github.com/yellowtree/geoip-detect/wiki/API:-PHP" rel="nofollow ugc">API Documentation</a>):
<ul>
<li><code>geoip_detect2_get_info_from_ip($ip, $locales = array('en'), $options = array())</code>: Lookup Geo-Information of the specified IP</li>
<li><code>geoip_detect2_get_info_from_current_ip($locales = array('en'), $options = array())</code>: Lookup Geo-Information of the current website user</li>
<li><code>geoip_detect2_get_current_source_description(...)</code>: Return a human-readable label of the currently chosen source.</li>
<li><code>geoip_detect2_get_external_ip_adress()</code>: Fetch the internet adress of the webserver</li>
<li><code>geoip_detect2_get_client_ip()</code>: Get client IP (even if it is behind a reverse proxy)</li>
</ul>
</li>
<li>For the property names, see the results of a specific IP in the wordpress backend (under <em>Tools > Geolocation IP Detection</em>).</li>
<li>You can include these properties into your posts and pages by using the shortcode <code>[geoip_detect2 property="country.name" default="(country could not be detected)" lang="en"]</code> (where ‘country.name’ can be one of the other property names as well, and ‘default’ and ‘lang’ are optional).</li>
<li>You can show or hide content by using a shortcode <code>[geoip_detect2_show_if country="FR, DE" not_city="Berlin"]TEXT[/geoip_detect2_show_if]</code>. See <a href="https://github.com/yellowtree/geoip-detect/wiki/API:-Shortcodes#show-or-hide-content-depending-on-the-location" rel="nofollow ugc">Shortcode Documentation</a>.</li>
<li>When enabled on the options page, it adds CSS classes to the body tag such as <code>geoip-province-HE</code>, <code>geoip-country-DE</code> and <code>geoip-continent-EU</code>.</li>
<li>If you are using a page cache, it is recommended to use the AJAX mode (see <a href="https://github.com/yellowtree/geoip-detect/wiki/API:-AJAX" rel="nofollow ugc">AJAX</a>)</li>
<li>When enabled on the options page, the client IP respects a reverse proxy of the server.</li>
<li>If you are using <a href="https://wordpress.org/plugins/contact-form-7/" rel="ugc">Contact Form 7</a>, you can use these shortcodes:
<ul>
<li>A select input with all countries, the detected country being selected by default: <code>[geoip_detect2_countries mycountry]</code></li>
<li>A text input that is pre-filled with the detected city (or other property): <code>[geoip_detect2_text_input city property:city lang:fr id:id class:class default:Paris]</code></li>
<li>Geolocation information for the email text: <code>[geoip_detect2_user_info]</code></li>
</ul>
</li>
<li>If you are using <a href="https://wordpress.org/plugins/wpforms-lite/" rel="ugc">WP Forms</a>, you can use this shortcode:
<ul>
<li>Geolocation information for the email text: <code>[geoip_detect2_user_info]</code></li>
</ul>
</li>
<li>Together with <a href="https://wordpress.org/plugins/svg-flags-lite/" rel="ugc">SVG Flags</a> you can show the flag of the detected country: <code>[geoip_detect2_current_flag]</code> (see <a href="https://github.com/yellowtree/geoip-detect/wiki/API:-Shortcodes#add-a-flag-of-the-visitors-country" rel="nofollow ugc">documentation</a>)</li>
</ul>
<p>See <a href="https://github.com/yellowtree/geoip-detect/wiki" rel="nofollow ugc">Documentation</a> for more info.</p>
<h4>How can I use these functions?</h4>
<ul>
<li>You could choose the currency of the store based on the country name</li>
<li>You could pre-fill the shipping country</li>
<li>You could show the store nearest to your customer</li>
<li>You show or hide content specific to a geographic target group</li>
<li>Etc. … You tell me! I’m rather curious what you’ll do with this plugin!</li>
<li>Be careful to comply to the applicable laws. For example Regulation (EU) 2018/302 …</li>
<li>If you need to get the user’s timezone, it is more accurate to use JS solutions.</li>
</ul>
<p><strong>System Requirements</strong>: 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 .</p>
<p><em>GDPR: See <a href="https://github.com/yellowtree/geoip-detect/wiki/FAQ#is-this-plugin-gdpr-compliant" rel="nofollow ugc">Is this plugin GDPR-compliant?</a></em></p>
<p><em>This extension is “charity-ware”. If you are happy with it, please <a href="https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=BSYUZHS8FH3CL" rel="nofollow ugc">leave a tip</a> for the benefit of <a href="http://www.jmem-hainichen.de/homepage" rel="nofollow ugc">this charity</a>. (See <a href="https://github.com/yellowtree/geoip-detect/wiki/FAQ#what-you-mean-by-this-plugin-is-charity-ware" rel="nofollow ugc">FAQ</a> for more infos.)</em></p>
<p><em><a href="https://github.com/yellowtree/geoip-detect/blob/master/CONTRIBUTING.md" rel="nofollow ugc">Here are other ways to contribute to the development of this plugin.</a></em></p>
<p><em>This product can provide GeoLite2 data created by MaxMind, available from http://www.maxmind.com.</em></p>
<h3>Troubleshooting</h3>
<ul>
<li>Does <code>geoip_detect2_get_info_from_current_ip()</code> return the same country, regardless of where you are visiting the site from? </li>
<li>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 <a href="https://www.whatismyip.com/" rel="nofollow ugc">public IP</a>?</li>
<li>Or maybe you are using a site cache plugin. Then enable the option <code>Disable caching a page that contains a shortcode or API call to geo-dependent functions.</code></li>
</ul>
<p><a href="https://github.com/yellowtree/geoip-detect/wiki/Troubleshooting" rel="nofollow ugc">More Troubleshooting Hints</a></p>


Geolocation IP Detection

Great plugin although the documentation could be better

Works well

Great plugin, easy to use


Really well written plugin that does exactly what it promises, includes well written documentation.



To those who wrote negative reviews about detection that is not the author's fault, he links you to several providers that issue that data, you literally could not ask for more.


Alternatives to Geolocation IP Detection

Top alternatives