Wordpress plugin: Retrieving Geo-Information using one the Maxmind GeoIP2 databases. (BTW, We're looking for a new developer! yellowtree.de/jobs/)
PHP Shell
Latest commit a969758 Dec 9, 2016 Benjamin Pick update vendor
Failed to load latest commit information.
bin Update travis script Dec 21, 2015
data-sources New feature: ['source'] can be used to override the current source fo… Nov 20, 2016
languages Typo (`LICENCE` -> `LICENSE`), user-dismissible UI notice, missing i18n. Jan 6, 2016
lib/geonames Update Geonames Nov 11, 2016
tests Add test Nov 20, 2016
vendor update vendor Dec 9, 2016
views Fix label for admin UI Sep 28, 2016
.gitignore Add test for v1 compat Nov 11, 2014
.travis.yml fix travis Dec 22, 2015
LICENSE Typo (`LICENCE` -> `LICENSE`), user-dismissible UI notice, missing i18n. Jan 6, 2016
README.md Release 2.6.0 (yeah) Sep 30, 2016
admin-ui.php Fix screen after first install of auto source Sep 28, 2016
api-stubs.php Update cacert Nov 10, 2016
api.php Update documentation Nov 20, 2016
check_requirements.php Update Licence headers. Sep 17, 2016
composer.json Fix composer name (ci skip) Aug 30, 2016
composer.lock update vendor Dec 9, 2016
deploy.sh Hopefully svn:ignore works now. Sep 30, 2016
deprecated.php refactor tests Apr 3, 2015
filter.php Update Licence headers. Sep 17, 2016
geoip-detect-lib.php New feature: ['source'] can be used to override the current source fo… Nov 20, 2016
geoip-detect.php New feature: ['source'] can be used to override the current source fo… Nov 20, 2016
init.php 3 more i18n strings Feb 20, 2016
legacy-api.php Update Licence headers. Sep 17, 2016
phpunit.xml disable codacy Apr 6, 2015
readme.txt update for compat CF7 4.6 Dec 9, 2016
screenshot-1.png screenshots Apr 30, 2015
screenshot-2.png screenshots Apr 30, 2015
shortcode.php update for compat CF7 4.6 Dec 9, 2016
upgrade-plugin.php Update Licence headers. Sep 17, 2016


Tests: Build Status Composer: Dependency Status

GeoIP Detection

Retrieving Geo-Information using one the Maxmind GeoIP2 databases.

== Description ==

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).

= Features: =

  • 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)
  • You can use one of these data sources (see comparison):
  • For the property names, see the results of a specific IP in the wordpress backend (under Tools > GeoIP 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).
  • When enabled on the options page, it adds CSS classes to the body tag such as geoip-country-DE and geoip-continent-EU.
  • 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 [geoip_detect2_countries mycountry]
    • Tracking information for the email text [geoip_detect2_user_info]

See API 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 suggest an timezone to use when displaying dates
  • 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!

System Requirements: You will need at least PHP 5.3.1.

This extension is "charity-ware". If you are happy with it, please leave a tip for the benefit of this charity. (See FAQ for more infos.)

This product can provide GeoLite2 data created by MaxMind, available from http://www.maxmind.com.

== Installation ==

  • 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.


Does 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?

== Frequently Asked Questions ==

Technically speaking, how could I verify if my visitor comes from Germany?

How can I show text only if the visitor is coming from Germany?

How can I add the current country name as text in my page?

Which data source should I choose?

Can I change the time period how long the data is cached?

The Maxmind Lite databases are licensed Creative Commons ShareAlike-Attribution. When do I need to give attribution?

Does this plugin work in a MultiSite-Network environment?

What you mean by "This plugin is charity-ware"?

Further documentation

API Documentation

Record Properties

API usage examples

== Screenshots ==

  1. Lookup page (under Tools > GeoIP Lookup)
  2. Options page (under Preferences > GeoIP Detection)

= 2.6.0 =

Support for Cloudflare & AWS. 2 shortcodes for Contact Form 7.

= 2.5.6 =

Some users reported problems with open_basedir-notices - if that's you, this update will help. Otherwise there are no changes.

= 2.5.3 =

This is a security update (please update).

= 2.5.1 =

Hotfix: If you upgraded to 2.5.0, please verify that the correct datasource is still chosen. Sorry for any inconvenience caused.

= 2.5.0 =

If you use a caching plugin, you don't need to exempt geo-content pages manually anymore. When the API of this plugin is called, then this plugin signals to the caching plugin that this page should not be cached. You can disable this behavior on the options page.

= 2.4.2 =

You don't need to upgrade to this version, this release is mainly to fix installation behavior.

= 2.4.1 =

Reverting Requirements check to behavior before 2.4.0

= 2.4.0 =

Maxmind Precision API support is here ... Try it out, I would tag it "experimental" at the moment.

= 2.3.1 =

The plugin was down for licensing issues. All users must now opt in to use the database because it is licensed CC BY-SA. Otherwise, the Web-API of HostIP.info is used.

= 2.3.0 =

The plugin was down for licensing issues. All users must now opt in to use the database because it is licensed CC BY-SA. Otherwise, the Web-API of HostIP.info is used.

= 2.1.1 =

Update to v2.x is a major update. At least PHP 5.3.1 is required now. See Migration Guide at https://github.com/yellowtree/wp-geoip-detect/wiki/How-to-migrate-from-v1-to-v2

= 2.0.1 =

This major update uses the new Maxmind API (v2). At least PHP 5.3.1 is required now. See Migration Guide at https://github.com/yellowtree/wp-geoip-detect/wiki/How-to-migrate-from-v1-to-v2

= 1.7.1 =

Cron update was broken again ...

= 1.6 =

Automatic weekly update didn't work in all installations.

= 1.5 =

Fixing automatic weekly updates.

== Changelog ==

= 2.6.0 =

  • ADD: New datasources for Cloudflare & Amazon AWS CloudFront (countries for current IP only).
  • ADD: Country information (names, lat/lon, continent, localized in the different languages) are now filled in for sources that only detect the country code (Cloudflare, Amazon, hostip.info)
  • ADD: 2 shortcodes for Contact Form 7 (a select with all countries [geoip_detect2_countries mycountry], and tracking information for the email text [geoip_detect2_user_info]) - see Documentation
  • FIX: Cron scheduling is checked every time you visit the plugin page.
  • FIX: Timezones of US & Canada are now detected more often (if country+state is known)
  • FIX: Shortcode didn't use current sitelang as default, but always english
  • Maxmind vendor code was updated to the current version (2.4.2).

= 2.5.7 =

  • ADD: Shortcodes can now optionally specifiy the IP: [geoip_detect2 property="country.isoCode" ip="(ipv4 or ipv6)"]
  • ADD: Plugin is now translated into German.
  • FIX: geoip_detect2_get_info_from_current_ip() now also handles the case when REMOTE_ADDR contains multiple IP adresses

= 2.5.6 =

  • FIX: Removed noticed concerning open_basedir.

= 2.5.5 =

  • Clean-up changes to prepare plugin translation.
  • FIX: Only show the "no database installed" admin notice to admins (props @meitar)

= 2.5.4 =

  • FIX: Manual datasource filepath handling corrected.
  • FIX: Potential incompability with BuddyPress removed.

= 2.5.3 =

  • FIX: (Security) Add nonces to backend to avoid CSRF (thanks to Gerard Arall).
  • FIX: Do not use PHP shortcode tags (<?=) as some servers do not support it with PHP 5.3
  • Maxmind vendor code was updated to the current version (2.3.3).

= 2.5.2 =

  • FIX: Also disallow proxy caching via HTTP header, if possible.
  • NEW: Shortcodes for the other API functions: [geoip_detect2_get_current_source_description], [geoip_detect2_get_client_ip], and [geoip_detect2_get_external_ip_adress]
  • FIX: geoip_detect2_get_external_ip_adress() : do not filter if $unfiltered is true.

= 2.5.1 =

  • FIX: Upgrade script did change the source.
  • FIX: Page caching is only disabled on upgrade when set_css_country is disabled.

= 2.5.0 =

  • CHANGE: The parameter $skipCache is now $options['skipCache']. Using $skipCache is deprecated, but still works.
  • NEW: $options['timeout'] for Web-API lookups can now be specified.
  • FIX: Hostip.info did not set traits->ipAddress
  • FIX: Hostip.info does not include data for IPv6. Add a lookup error message.
  • NEW: Disable page caching if geoip-API was called (this is configurable in the options). (Supported plugins: WP Super Cache, W3 Total Cache, ZenCache, and possibly others)
  • Maxmind vendor code was updated to the current version (2.3.1).

= 2.4.3 =

  • FIX: Options Page: The checkboxes didn't show (even though the option was saved) since 2.4.0
  • NEW: A fixed external IP can now be specified on the options page. (Useful in development scenarios without internet, or mixed internet/intranet cases. You can also use this to speed up things on the production server if you know the IP will not change.)
  • NEW: Hidden feature/side-effect: Clicking on save in the General Options section also empties the external IP cache.

= 2.4.2 =

  • FIX: Trim whitespace of IP adress.
  • FIX: some PHP notices.
  • FIX: The Installation message "No database installed" failed to install the Maxmind database since 2.4.0
  • NEW: Show IPv6-not-supported notice.
  • FIX: Add empty fallback functions in case the plugin requirements are not met. (To avoid fatal errors.)

= 2.4.1 =

  • FIX: Revert IPv6 check. (Sorry for this. I thought PHP compiled without IPv6 would be esoteric.)

= 2.4.0 = This is a major refactor in order to support multiple sources properly. The Lookup and the Options were seperated into 2 screens (accessible in the menu under Tools and Options, respectively.)

  • NEW: Add a Cache for Web-API-Requests. Consequently, the function geoip_detect2_get_info_from_ip() received a new parameter "$skipCache" to skip this cache if not needed. You can check if the result is coming from the cache by checking $result->extra->cached (it is 0 when not cached, UNIX timestamp of cache event otherwise).
  • This also applies to the shortcode API ([geoip_detect2 property="extra.cached" skip_cache="true"])
  • NEW: Error messages during lookup are now in $record->extra->error.
  • NEW: Experimental support for the Maxmind Precision API.
  • NEW: Shortcodes now also support fallback languages. ([geoip_detect2 property="country" lang="fr,de"])
  • FIX: Check for IPv6 support for PHP.
  • FIX: Country data now also get timezones.

= 2.3.1 =

  • NEW: API function geoip_detect2_get_current_source_description() (as there are different sources to choose from now)
  • FIX: Show error message if PHP < 5.3 (instead of fatal error)

= 2.3.0 =

  • NEW: Add HostIP.info-Support

= 2.2.0 =

  • FIX: Update Maxmind Reader to 1.0.3 (fixing issues when the PHP extension mbstring was not installed)
  • NEW: Commercial databases are now supported. You can specify a file path in the options.
  • NEW: A country database (lite or commercial) database now works as well.

= 2.1.2 =

  • FIX: Show error message if PHP < 5.3 (instead of fatal error)
  • FIX: Support multiple proxies (but currently only one reverse proxy)

= 2.1.1 =

  • FIX: Notice "Database missing" should not show during/right after database update.

= 2.1.0 =

  • NEW: A nagging admin notice shows up on every wp-admin page when no database is installed (yet).

= 2.0.1 =

  • NEW: Using v2 version of the API. See Migration Guide at Github

Other changes:

  • NEW: The v2-functions now support location names in other locales. By default, they return the current site language if possible.
  • NEW: The new shortcode [geoip_detect2 ...] also supports a "lang"-Attribute.
  • NEW: IPv6 addresses are now supported as well.
  • Legacy function names and shortcode should work in most cases. For details check the guide above.

= 2.0.0 =

(Was not released on wordpress.org to make sure that development releases get this update as well.)

= 1.8 =

  • NEW: Support reverse proxies (you have to enable it in the plugin options.)
  • NEW: Shortcode now has a default value when no information for this IP found.

= 1.7.1 =

  • FIX: Fatal error on cron run

= 1.7 =

  • FIX: Schedule Database update to do in background immediately after plugin installation/re-activation.
  • FIX: Longitude can be smaller than -90

= 1.6 =

  • NEW: Can add a country- and continent-specific class on the body tag. You need to activate this in the options.
  • FIX: Automatic weekly update. (Didn't work on all installations).
  • FIX: Do not include Maxmind Libraries again if already included by another plugin/theme

= 1.5 =

  • FIX: Automatic weekly update. Go to the plugin page (Tools menu) to verify that an update is planned.

= 1.4 =

  • Feature: Add shortcode [geoip_detect property="(property name)"] for direct use in posts/pages

= 1.3 =

  • FIX: Manual install works again (was broken since 1.2)

= 1.2 =

  • FIX: property region_name is now filled again (was broken since 1.1)

= 1.1 =

  • Add function geoip_detect_get_external_ip_adress(): Ask a webservice to tell me the external IP of the webserver.
  • New filter: When developing locally, the external IP is used to determine the geographic location.

= 1.0 =

  • First working release.