Plugin / Geo IP Library

Ricardo Miguel

Description

Description

Geo IP Library enables sort of simple but powerful functions in order to provide geo ip country features on WordPress. Main features so far until now:

  • Static PHP functions to be used in plugins and themes.
  • Shortcodes to display different contents by country or a bunch of countries.
  • Update management of local library from its source.

About library

This plugin uses a third-party PHP single library file which does not have external dependencies, so it comes within the plugin and works locally. It is intended for anyone who don’t want to use (or depend of) web services or either implement native PHP GeoIP extensions.

The library was made by Chirag Mehta.

Library update

Since working with a local library can be a time-saver, its data may get deprecated sometime in the future. This plugin allow update your local library from its remote source. To do that, go to admin dashboard (specifically under Tools menu), where the library can be updated without any risk.

Updating restriction

The library can be updated every 72 hours. It is not really necessary a minor interval.

How to use

Shortcode

Display different content for each country (or countries) within posts and pages by using [geo-ip] or [geo] tags. To do magic, see the following syntaxes:

/**
* INCLUDE PROPERTY
* Display content to a specific country or many countries
*/

// [geo-ip] tag
[geo-ip include="{2-digits country code [, other countries]}"]{plain text, HTML and/or shortcodes}[/geo-ip]

// [geo] tag
[geo include="{2-digits country code [, other countries]}"]{plain text, HTML and/or shortcodes}[/geo]

/**
* EXCLUDE PROPERTY
* Display content to all countries but...
*/

// [geo-ip] tag
[geo-ip exclude="{2-digits country code [, other countries]}"]{plain text, HTML and/or shortcodes}[/geo-ip]

// [geo] tag
[geo exclude="{2-digits country code [, other countries]}"]{plain text, HTML and/or shortcodes}[/geo]
  • [geo] tag is only available if no other plugin is using it (since it’s a pretty common word).
  • include and exclude cannot be used together due to their purpose.

Coding

The following static functions can be used anywhere along GeoIPLibrary class:

/** Returns the current client's IP address as STRING. 
    * It bypasses proxies and/or forwarding. 
    * Returns FALSE if it fails. */
GeoIPLibrary::get_client_address()


/** Returns the current client's ISO 3166-1 alpha-2 country code 
    * or the specified at $ip parameter as STRING. 
    * Returns FALSE if it fails. */
GeoIPLibrary::get_client_country_code(string $ip = '')


/** Returns the current client's country name 
    * or the specified at $ip parameter as STRING. 
    * Returns FALSE if it fails. */
GeoIPLibrary::get_client_country_name(string $ip = '')<h3>Contributions</h3>Geo IP Library is still in development, but currently stable. You can contribute with new ideas, coding improves/issues and even grammar/spelling check (english is not my mother language). Feel free to [make a pull request](https://github.com/ricardo-miguel/geo-ip-library/pulls) or [open an issue](https://github.com/ricardo-miguel/geo-ip-library/issues).

DIRECTORY DISCLAIMER

The information provided in this THEME/PLUGIN DIRECTORY is made available for information purposes only, and intended to serve as a resource to enable visitors to select a relevant theme or plugin. wpSocket gives no warranty of any kind, express or implied with regard to the information, including without limitation any warranty that the particular theme or plugin that you select is qualified on your situation.

The information in the individual theme or plugin displayed in the Directory is provided by the owners and contributors themselves. wpSocket gives no warranty as to the accuracy of the information and will not be liable to you for any loss or damage suffered by you as a consequence of your reliance on the information.

Links to respective sites are offered to assist in accessing additional information. The links may be outdated or broken. Connect to outside sites at your own risk. The Theme/Plugin Directory does not endorse the content or accuracy of any listing or external website.

While information is made available, no guarantee is given that the details provided are correct, complete or up-to-date.

wpSocket is not related to the theme or plugin, and also not responsible and expressly disclaims all liability for, damages of any kind, arising out of the use, reference to, or reliance on, any information or business listed throughout our site.

Keep Leading Your Followers!
Share it for them.