EXT: GeoIP Libraries¶

What does it do?¶

GeoIP Libraries (ml_geoip) provides the services of MaxMinds free libraries and additional flag icons. It can be used by extension developers to find out the geographical location of ip addresses.

Installation¶

The extension GeoIP Libraries uses the MaxMind libraries, before you can use the extension you have to import this libraries. The url from which the libraries should be downloaded is defined via the extension manager. By default the url “ http://geolite.maxmind.com/download/geoip/database/tmp/GeoIP.dat.gz ” is set.

To import a new version use the “UPDATE” method of the extension manager.

Function Reference¶

GeoIP Libraries currently provides this functions:

• getCountryIdByAddress($ip)Gets the country id by given ip address
• getCountryCodeByAddress($ip)Gets the country code by given ip address
• getCountryNameByAddress($ip)Gets the country name by given ip address
• getCountryIdByName($address)Gets the country id by given internet address e.g. www.dkd.de
• getCountryCodeByName($address)Gets the country code by given internet address e.g. www.dkd.de
• getCountryNameByName($address)Gets the country name by given internet address e.g. www.dkd.de
• getCountryFlagByAddress($ip, $useHtml = false, $backendLink = false)Get the according flag to a certain country:=> ip – ip address=> useHTML – the filename is surrounded by a html img tag=> backendLink – the img path is prepared for typo3 backend use
• getCountryFlagByCode($code, $useHtml = false, $backendLink = false)Get the according flag to a certain country=> code – country code (2-digit iso code)=> useHTML – the filename is surrounded by a html img tag=> backendLink – the img path is prepared for typo3 backend use

How to use ml_geoip¶

To use the functions of GeoIP Libraries you have to include the class file

require_once(t3lib_extMgm::extPath('ml_geoip').'class.tx_mlgeoip.p hp');

The next step is to make an instance of the class “tx_mlgeoip”

$geoip = t3lib_div::makeInstance('tx_mlgeoip');

Now you can use the functions, e.g.

$geoip->getCountryCodeByAddress($ip);