description
Author: | elialgranti (profile at wordpress.org) |
WordPress version required: | 3.0 |
WordPress version tested: | 4.9.7 |
Plugin version: | 1.1.4 |
Added to WordPress repository: | 09-12-2014 |
Last updated: | 21-07-2018
Warning! This plugin has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.
|
Rating, %: | 94 |
Rated by: | 3 |
Plugin URI: | https://wordpress.org/plugins/geoswitch/ |
Total downloads: | 3 691 |
Active installs: | 70+ |
Click to start download
|
FAQ
Installation Instructions
Prerequisites
The Geoswitch plugin uses either MaxMind’s city database or webservice.
- To use a local database for geocoding you’ll need either the free GeoLite2 city database
(download from here) or obtain a license from MaxMind
for a GeoIP2 citydatabase. After obtaining the database uncompress it before installation.
- To use the webservice you’ll need to obtain a user ID and license key for GeoIP2 Precision Services.
Installation
- Copy the Plugin directory to your wordpress plugins directory (usually wp-content/plugins)
- Optionally copy your MaxMind binary database to the database subdirectory inside the plugin root direcory (GeoSwitch/database).
The database should be uncompressed.
- In the WordPress administration settings search for the GeoSwitch configuration page:
- Select the type of geocoding service to use (local database or webservice).
- Enter the name of the database or the user ID and license key depending on the service you’ve selected.
- Set the units to use for distance calculations (kilometer or miles).
Note: if you use the local database you should update it periodically.
Why do I see only question marks instead of my location?
Your IP was not found in the database. The most usual cause if that your browser and server are behind a NAT and you are
getting a private IP not a public one. For debugging purposes you can set the IP used by plug-in in the settings page.
My location is wrong/partial. How come?
Geolocation using IP addresses is not entirely accurate. The geolocation relies on a static database of addresses and
their approximate location, not exact location like mobile GPS.
To ensure maximum accuracy make sure you have the latest database. Purchasing the non-lite version of the database from MaxMind
or a license for their service may also yield better information.
I am not affiliated in any way with MaxMind, so it is up to you to contact them and evaluate their offers for suitability to your purposes.
How do I test other locations?
You can set the IP used in by the plug-in in the settings page and use Google to search for IPs in the location you are interested
in (i.e. IP in California) or use the geoswitch_setip
shortcode.
Debug overrides for other setting are coming.
ChangeLog
1.1.4
- Bug fix: Private and reserved IPs are not checked and no longer generate
- Added filter hook
geoswitch_skip_ip_check
to bypass the ip check based on
(Thanks to Arūnas Liuiza from arunas.co for the BugFix and filter hook)
1.1.3
Bug fix: when IP cannot be found plugin correctly evaluates all cases and uses default empty case (if it exists), instead of not displaying anything.
Implemented support for comma separated values in geoswitch_case shortcode. Previous version mentioned this feature in the Readme file, but it was not actually implemented.
1.1.2
Error deploying to wordpress. Use version 1.1.3 instead.
1.1.1
Added setting to for user IP for debugging purposes and updated MaxMind Libraries.
1.1.0
- Added support for MaxMind GeoIP2 Precision Service (thanks to Paul Scarrone
and carlcapozza).
- Fixed bug with measurement units. Units were always considered kilometers.
- Tested under WordPress 4.1.
1.0.0