Ektron retrieves the IP address information from a site visitor's IP address via 3 databases. The databases are installed to your site root's App_data folder and listed in your site's web.config file.

NOTE: The tilde character (~) in the value element represents the site root folder.

• <!-- GeoIP City Database -->

  <add key="GeoIpCityDatabase" value="~/App_Data/GeoLiteCity.dat"/>

  Returns the following information, based on IP address:

  • Area code
  • City
  • US State
  • Country code and name
  • Latitude and Longitude
  • MetroCode
  • PostalCode
  • Telephone area code
• <!-- GeoIP Organization Database -->

  <add key="GeoIpOrgDatabase" value="~/App_Data/GeoIPOrg.dat"/>

  Returns the organization name, based on IP address.

• <!-- GeoIP Domain Database -->

  <add key="GeoIpDomainDatabase" value="~/App_Data/GeoIPDomain.dat"/>

  Returns the domain name, based on IP address.

If you want to move the databases to another folder, you must update their web.config value elements to the new location.

Best Practice 

You should keep the GeoIP databases in the App_data folder, because this folder prevents unauthorized copying of the database.

Using GeoIP information in the Targeted Content widget

Among the Targeted Content widgetA mini-application that you place on a Web page using PageBuilder; a widget provides either specific functionality (calculators, search, social bars, and so on) or areas into which you can add content (content blocks, list summaries, collections, and so on).'s criteria is User Regional Info, which has 2 options: Country and US Regions.

If you choose US Regions, you can select from states in the United States.

User Regional Info data uses GeoIP information. See also: Creating and using widgets

Using GeoIP information in the Map server control

You can center a map on a specific location by using the Map server control's latitude and longitude properties. You also can use GeoIP information to obtain a user's latitude and longitude, based on IP address. For example, if a site visitor searches for a chain restaurant, the map can indicate restaurants near the user.

The following code shows how to set up the Map server control to populate latitude and longitude with GeoIP information.

Sample .aspx page, showing the placement of the Map server control.

<cms:Map ID="uxMap" runat="server" />

Code-behind page in C#

Ektron.Cms.UserLocationData userLocationData = 
  Ektron.Cms.UserContext.GetCurrentUserLocationInfo();
        if(userLocationData != null)
        {
        	uxMap.Latitude = userLocationData.Latitude;
        	uxMap.Longitude = userLocationData.Longitude;
        }

Accessing GeoIP information with the API

The following APIApplication Programming Interface code demonstrates the retrieval of a user's GeoIP information. Note that Ektron.Cms.UserContext.GetCurrentUserLocationInfo() returns the Ektron.Cms.UserLocationInfo() object, which provides access to all elements listed in retrieving IP address informationexcept IP address.

To obtain the IP address, use Ektron.Cms.UserContext.IP.