README

Allows you to show pages and content elements for people in certain countries, continents or within a given area.

It uses the Maxmind GeoIP database to determine the user's probable physical location. Note that this is working most of the time, but also fails regularly.

Country and Continent rules are pretty safe to use, while small distances are not accurate at all.

Setup

Install the PHP extension geoip (requires root access to the server)

If that is not possible, install the Net_GeoIP package from PEAR
Install and activate this TYPO3 extension contexts_geolocation

Dependencies

contexts TYPO3 extension
static_info_tables TYPO3 extension
geoip PHP extension, see its homepage
or Net_GeoIP from PEAR instead of geoip

Context types

The contexts_geolocation extension ships with three different context types:

Continent

Matches when the user is on one of the selected continents.

Continent - unknown - can be used to match all users whose position could not be determined.

Country

Matches when the user accessing the page is in one of the selected countries.

Country - unknown - can be used to match all users whose position could not be determined.

Distance

Select a location on a map and a distance, and the context matches when the user's location is within this area.

Note that the free geoip database does seldom give you exact locations, so this is more a fun experiment rather that it should be used in production.

Plugins

Contexts geolocation: show current position

Shows a map with a marker at the detected position of the user's IP.

Also shows a dump of other data for this IP, like continent, country and city.

Useful for testing and debugging.

Allows manual IP address input.

netresearch / contexts_geolocation

Maintainers

Details