New Admin-Tool: GeoIP

thorn

Offline

Posts: 980

« on: September 27, 2008, 09:42:02 PM »

Hello,

GeoIP v1.3.2 (updated: 05 Apr 2009)

Developer Documentation: http://nettest.thekk.de/docs/geoip/files/geoip_functions-php.html

This version includes the database-file, so there is no need for an initial download.
ATTN: if you have downloaded the database manually so far, you may have to remove it manually too, before trying to update this module.

GeoIP provides a geoip-database which can be used from within other website baker modules.
(I used "GeoLite Country" from http://maxmind.com/).
There are flag-icons added for each country, too.
Since 1.2, there is the phpwhois-library, too.

Requirements:
PHP 4.1 (4.3 for download-functionality) or higher, or PHP 5.x

See the second image for an example on what you can do (as module developer) with this data.

If you are a module-developer, planning to make use of geoip-data for your own module, please consider to use this admin-tool (please read the developer documentation under Admin-Tools-->GeoIP-->Developer-Docu).

Edit: Database-download requires PHP >=4.3. For PHP <4.3 the download-field will be disabled and one has to download the database manually.

In time of writing there are two module using this tool (searchtools >= v0.60.01, guestbook >= v2.8.2.)

Using-example (if geoip is required):

Code: (example)

// load geoip-functions
if(file_exists(WB_PATH.'/modules/geoip/geoip_functions.php'))
require_once(WB_PATH.'/modules/geoip/geoip_functions.php');
else
exit('GeoIP-module not installed!');

$gi = geoip_open_db(); // opens GeoIP database
if($gi===FALSE)
exit(Failed to open GeoIP-database!);

$ip = geoip_best_ip();

echo $ip.' - '.geoip_country_code_by_addr($gi, $ip).' - '.geoip_country_name_by_addr($gi, $ip).' - '.geoip_flag_html($gi, $ip);

geoip_close($gi);

Quote from: output

86.10.40.1 - GB - United Kingdom -

Using-example II (if geoip is optional):

Code: (example)

// load geoip-functions, if available
if(file_exists(WB_PATH.'/modules/geoip/geoip_functions.php'))
require_once(WB_PATH.'/modules/geoip/geoip_functions.php');

if(function_exists('geoip_open_db'))
$gi = geoip_open_db(); // $gi will be FALSE if this fails
else
$gi = FALSE;

// Now you can check against $gi or defined('GEOIP_DATABASE_LOADED') to see if geoip-database is ready to use
// if($gi) { // ready to use } else { // not available }
// if(defined('GEOIP_DATABASE_LOADED')) { // ready to use } else { // not available }

if($gi)
$ip = geoip_best_ip();
else
$ip = '';

if($gi) {
echo $ip.' - '.geoip_country_code_by_addr($gi, $ip).' - '.geoip_country_name_by_addr($gi, $ip).' - '.geoip_flag_html($gi, $ip);
} else {
echo '<br />';
}

if($gi)
geoip_close($gi);

End-users: You need to install this admin-tool ONLY if required by a module.

Download: http://www.websitebakers.com/pages/admin/admin-tools/geoip.php

thorn.

This product includes GeoLite data created by MaxMind, available from http://maxmind.com/
This product includes flag-icons, available from http://www.famfamfam.com/
This product includes phpwhois, available from http://sourceforge.net/projects/phpwhois


« Last Edit: July 24, 2009, 01:57:23 PM by thorn »	Logged

Projekte

thorn

Offline

Posts: 980