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

Shift8 GEO IP Location

外掛說明

Plugin that utilizes ip-api to get geolocation coordinates based on the end-users’ IP address. Read the blog post detailing how to interact with the plugin.

Want to see the plugin in action?

You can view three example sites where this plugin is live :

Features

  • Cookie session established with IP address and latitude / longitude coordinates of the end-user browsing the site

螢幕擷圖

  • Admin area

安裝方式

This section describes how to install the plugin and get it working.

e.g.

  1. Upload the plugin files to the /wp-content/plugins/shif8-geoip directory, or install the plugin through the WordPress plugins screen directly.
  2. Activate the plugin through the ‘Plugins’ screen in WordPress
  3. Navigate to the plugin settings page and define your settings
  4. Once enabled, the system should trigger for every site visit.

常見問題集

I tested it on myself and its not working for me!

Try clearing all cookies and re-visit the website. Then examine the cookies set by the website in your browser. The cookie name should be “shift8_geoip”.

How do I read and use the shift8_geoip cookie?

The plugin will set the cookie after successful geolocation and encrypt the value using OpenSSL with wp_salt(‘auth’) as a key. This means in order to access the geolocation data you have to write code (in functions.php for example) such as the following :

$cookie_data = explode('_', shift8_geoip_decrypt(wp_salt('auth'), $_COOKIE['shift8_geoip']));

The cookie data when decrypted will look like the following :

ipaddress_latitude_longitude

Which means you can use php’s explode function to convert it into an array as in the above example

How can I decrypt the cookie data? You encrypted it!

Well the data could be construed as somewhat sensitive and could be used maliciously to (for the most part) geographically place the end user. The decision to encrypt the cookie data was made to protect the user from the data falling into the wrong hands. In the plugin code, we are using OpenSSL to encrypt/decrypt the geo-location data. You can use the function below to decrypt the cookie data :

// Function to decrypt session data
function shift8_geoip_decrypt($key, $garble) {
    if (!empty($key) && !empty($garble)) {
        list($encrypted_data, $iv) = explode('::', base64_decode($garble), 2);
        return openssl_decrypt($encrypted_data, 'aes-256-cbc', $key, 0, $iv);
    } else {
        return false;
    }
}

So to actually use the above function, you could do the following :

shift8_geoip_decrypt(wp_salt('auth'), $_COOKIE['shift8_geoip']);

What is wp_salt?

You can read more about the wp_salt function by clicking here

使用者評論

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

參與者及開發者

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

參與者

將〈Shift8 GEO IP Location〉外掛本地化為台灣繁體中文版

對開發相關資訊感興趣?

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

變更記錄

1.0

  • Stable version created

1.01

  • Switched from stored session variable to encrypted cookie using wp_salt function. This is to easily allow development options to read and process the cookie data

1.02

  • Updated readme with helpful FAQ entries

1.03

  • Better error checking with geoip class and returned array

1.04

  • If no valid IP is found in the get_ip function, the last return value still needs to be chcecked if a valid IP, otherwise return false

1.05

  • Now including country code in geoip encrypted cookie

1.06

  • WordPress 5 compatibility

1.07

  • WordPress 5.5 compatibility

1.08

  • WordPress 6.2 compatibility