To Use Geo Blocking

Using geo blocking feature you can block items based on geographical location. There is two list called whiteList and blackList. One list will be active at a time. If you want to allow items only for certain countries then you should usewhiteList. If you want to block only certain countries then you should use blackList. You will find the list in com/escenic/framework/geo/GeoLookupManager. Currently this feature is implemented only for video items (simpleVideo).

To use geo blocking feature for video you have to follow these steps-

  • Configure com/escenic/framework/geo/GeoLookupManager and set the country code. Knowing the exact country code is very important. You will find the country code in csv format from here. http://geolite.maxmind.com/download/geoip/database/GeoIPCountryCSV.zip

  • You must need the geo-ip database file. We are using the open source database provided by Maxmind (http://www.maxmind.com). You should place this file to appropriate place and have to specify the path in com/escenic/framework/geo/GeoLookupManager

  • Create a simpleVideo and if you want to block that video then check the blocking option.

  • Place the video in a group in content section

  • Create and configure a video widget. Specify the group name where you placed the video

  • Save and Publish the video widget

Create other two video item which is unblocked and place them in the same group of content section. Say, you choosed to block by blackList and in the blackList you specified BD,US. So, people from these two countries cannot see the blocked video as they are in black list. But they can see and play the unblocked videos. If users from these two countries goes to the article view of blocked video they will ses a message that This content is not accessible in your region.

You should periodically update the geo-ip data file. The open source data file used in widget-framework provides 99.5% accuracy and the premium data file provides 99.8% accuracy. See http://www.maxmind.com/app/geolitecountry for more details.