外掛說明
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 :
- Example Site 1 : WordPress Hosting
- Example Site 2 : Web Design in Toronto
Features
- Cookie session established with IP address and latitude / longitude coordinates of the end-user browsing the site
螢幕擷圖
安裝方式
This section describes how to install the plugin and get it working.
e.g.
- Upload the plugin files to the
/wp-content/plugins/shif8-geoip
directory, or install the plugin through the WordPress plugins screen directly. - Activate the plugin through the ‘Plugins’ screen in WordPress
- Navigate to the plugin settings page and define your settings
- 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”.
-
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
-
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
使用者評論
這個外掛目前沒有任何使用者評論。
參與者及開發者
變更記錄
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