Geo IP Personalization

• In some situations it might be useful to customize the content on your website based on the geographical region the visitors are coming from.
• There are numerous ways to personalise content with GeoIP within Terminalfour. In this example you are going to create a single Content Type to output content for three different countries/regions.
• You will need a new Content Type, which has a number of elements; these will be used to output content for the different countries/regions.

Requires PHP

This exercise requires the webserver to be able to process PHP.

Enable PHP on your channel

1. Your channel needs to allow PHP to be used as an extension. If this is not already the case, modify the Channel; go toAdministration > Set up Sites & Channels > Channels.
2. Select your channel. You only need to modify the available file extensions as shown below.
   1. Available file extensions
      1. Enable file extension overriding: check this box if you have previously defined additional extensions, this allows you to publish your channel using alternative extensions such as PHP, RSS, CFM etc.
      2. Permitted file extensions: select the check box for the relevant extension i.e. PHP.
3. Click Save changes to save the changes made to the Channel.

Create a GeoIP Content Type

You need to create a Content Type which has a number of different country elements. The GeoIP script will display one of the appropriate country field based on where the viewer is coming from.

1. Go to Assets > Content Types > + Create content type.
2. Fill in the General tab:
   1. Name: enter a name here. This should suggest what type of content it is used for, e.g. GeoIP.
   2. Description: describe in more detail when to use this Content Type.
   3. Minimum user level: if you wish to restrict who can use this Content Type, you can set a level here. If Content Types are created in groups, a user has to be a member of the group as well as meet the minimum user level criteria in order to use the Content Type.
   4. Enable in direct edit: decide if Direct Edit can be used for this Content Type.
   5. Mark as eForm: check this for eForms and xForms only. This is not relevant in this example.
   6. Workflow: if relevant, enable a workflow for content using this Content Type.
   7. Primary group: Select your group. This allows you to select the group which is permitted to use this content type. Click Show shared groups to share the content type with more than one group.

3. Select the Elements tab.
4. Add the elements you need by filling in the information as outlined in the table below.

5. Once you have added all your elements, click Save changes. The Content layouts tab opens. The Content layouts tab contains the content layouts for your Content Type.
6. Click + Add content layout to begin.
7. Name: Fill this in using the default type set in your Channel; e.g. text/html. This ensures the content can be displayed.
8. The File extension will need to be set to PHP.
9. Select the relevant Syntax type language to enable syntax highlighting, e.g. PHP
10. Copy the example content layout PHP code in the screenshot below and paste it into the content layout.

Country Codes

The country code used in GeoIP follows the ISO 3166 standards for Country Codes.
To customize the country code, look up the country code for the country you wish to use; http://maxmind.com/app/iso3166 and replace the codes in the PHP "if statement".

<?php
include($_SERVER['DOCUMENT_ROOT'].'GeoIP.inc');

$gi = geoip_open($_SERVER['DOCUMENT_ROOT'].'country.dat', GEOIP_STANDARD);
$country = geoip_country_code_by_addr($gi,$_SERVER['REMOTE_ADDR']);
//start of if 
if (( $country == "IE"))  {
?>
    <h2>Welcome Irish visitors</h2>    
<?php } else if (($country == "US")) { ?>
    <h2>Welcome American visitors</h2> 
<?php } else { ?>
    <h2>Welcome visitors</h2>
<?php }
geoip_close($gi);
?> Country.dat

Country.dat file should be loaded directly onto the server and it should be directly linked to from the Content Layout.

It is done like that for security reasons and to let the server update this file regularly. If it is in the Media Library, the file
cannot be updated by the server and needs to be manually maintained.

For this exercise we are, however, going to load the file into the media library as you might not have access to the server.
We are going to make use of some PHP ($_SERVER['DOCUMENT_ROOT']) to create the full path to the file on the server
instead of URI .

11. In Media T4 tag tab, click Select media. This opens the Media Library.
12. To upload the file to your Category in the Media Library, click + Add media (repeat for both files):
    1. Media file: drop the file here or click to choose the relevant file.
    2. Name: enter a name for your file. It is easiest if you use the filename.
    3. Description / Alt text: enter a description.
    4. Media type: this must be set to Media Path (based on standard configuration).
    5. Syntax highlighting language: leave as None.
    6. Media language dependence:
       1. Fully independent: the media is the same in all languages and can hence not be translated.
       2. Independent media file: the file and thumbnail exist independent of language. Other elements can be modified based on language.
       3. Fully dependent: all elements depend on language and can be translated.
13. Click Save changes and select the file.
14. A T4 Tag appears. Click Copy to clipboard to copy the XML Code. It should look similar to this: <t4 type="media" formatter="path/*" id="1234"/> and paste this T4 tag into the Content Layout replacing the relevant text.
15. Click the </> Generate T4 tag button again.
16. Using what you have learned above, build a tag to output the Default Language element:
    1. Normal Output (inline).
    2. Parse for Media Library Tags.
    3. Parse for Section Navigation Tags.
17. A T4 Tag appears. Click Copy to clipboard to copy the XML Code and use it to replace the relevant code in your content layout. Repeat for the other elements you created.
18. Click Save changes to save the new Content Layout. The Content Type is complete

Enable and test your content type

1. Enable your Content Type, so you can test it. On the Site Structure screen, click Edit section from the Section Actions menu beside the section you created earlier.
2. Select the Content types tab.
3. Click the radio button to enable the Content Type for either the branch or section:
   1. Enabled (Branch): the Content Type can be used in this section as well as all its sub-sections.
   2. Enabled (Section): the Content Type can be used in this section only.
4. Click Save changes to save the changes made.
5. Click into the Content tab and click the + Add content button.
6. Select your new Content Type.
7. Enter content for each element.
8. Click Save & approve.

Publish and test

• To view the content you need to publish your channel and use a web proxy provider to view the results as if you were viewing your content from different geographical IP addresses.

1. To publish your website, go to Sites & Channels > Publish Channels.
2. Locate your channel and select Enable publish.
3. Click Publish channels to publish.
4. View the publish site to see your content, using a web proxy to disguise your GeoIP location.

Feedback survey

Congratulations on completing the Advanced Web Developer Training module.

Please provide feedback in our on-line survey.