GeoPlugin

Gather location information about your visitors.

Geoplugin

GeoPlugin is an ExpressionEngine module which utilizes the free geoPlugin online service (http://www.geoplugin.com/) to provide geolocation information about your visitors.

Usage

Installation

Copy /system/expressionengine/third_party/cl_geoplugin into /system/expressionengine/third_party

Tags

{exp:cl_geoplugin:locate}

Locates a user.

Parameters

  • ip_address (default: user’s ip_address)

    An ip address to geolocate.

Variables

{ip} {city} {region} (two character state) {area_code} {dma_code} {country_name} {country_code} {continent_code} {latitude} {longitude} {currency_code} {currency_symbol} {currency_converter} {nearby} {nearby_city} {nearby_region} {nearby_country_code} {nearby_latitude} {nearby_longitude} {/nearby}

Examples

In your template this is how you’d get the current user’s city and state.

{exp:cl_geoplugin:locate} You are in {city}, {region}. {/exp:cl_geoplugin:locate}

You are in Seattle, WA.

{exp:cl_geoplugin:variable}

Returns any of the variables available via the {exp:cl_geoplugin:locate} tag pair.

Parameters

  • ip_address (default: user’s ip_address)

    An ip address to geolocate.

Examples

In your template this is how you’d get the current user’s currency symbol.

{exp:cl_geoplugin:currency_symbol}

$

{exp:cl_geoplugin:is_nearby}

Returns true or false whether the specified ip_address is in the nearby list that GeoPlugin provides.

Parameters

  • ip_address (default: user’s ip_address)

    An ip address to geolocate.

  • city (required if lat/long not set)

    A city you are trying to see if is nearby what was geolocated.

  • region (required if lat/long not set)

    A region (two character state) you are trying to see if is nearby what was geolocated.

  • country_code (required if lat/long not set)

    A country code (two character) you are trying to see if is nearby what was geolocated.

  • radius (default: 10)

    Distance in miles from the geolocated ip_address to find nearby locations.

  • limit (default: 100)

    Used to limit the results since we are comparing a listing. In dense areas you might need to set it even higher.

Help

Please login or sign-up first.

Change Log

v1.0.1 (Released 05-25-2018)

  • Issue after server move