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

Alternatives to Geolocation IP Detection

Top alternatives