這個外掛並未在最新的 3 個 WordPress 主要版本上進行測試。開發者可能不再對這個外掛進行維護或提供技術支援,並可能會與更新版本的 WordPress 產生使用上的相容性問題。

Geo IP Library

外掛說明

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

使用者評論

這個外掛目前沒有任何使用者評論。

參與者及開發者

以下人員參與了開源軟體〈Geo IP Library〉的開發相關工作。

參與者

將〈Geo IP Library〉外掛本地化為台灣繁體中文版

對開發相關資訊感興趣?

任何人均可瀏覽程式碼、查看 SVN 存放庫,或透過 RSS 訂閱開發記錄