General

The Norman Affiliate Program is a system for setting up on-line purchasing of Norman's products from your own web. This document will describe the method of getting your Norman webshop up and running in no time, with up-to-date information.
The system is based on javascript, and you should be aware that not all browsers support javascript. Some visitors may also have turned off this function in their browser. However, about 90% of all visitors will be able to view this page.

The webshop consists of two files which must be placed on your local webserver, and they will communicate with two files on Norman’s server (newton.norman.com). One of these files will add a javascript array to the webpage, which is a “copy" of an XML feed with the same information. Information about the XML-feed can be found below, in case you want to set up your own system using this.

The default page will look like this: http://newton.norman.com/affiliate/norman_webshop.html

The simplest way

Follow these easy steps to set up the webshop with the default setting:

  1. Download the zipfile containing the two files (http://newton.norman.com/affiliate/norman_webshop.zip)
  2. Extract the files to a place on your webserver
  3. Open the norman_webshop.html in your favourite HTML editor (or notepad if you don’t have any).
  4. Locate the line var currency = 'eur';
  5. If you want to display a different currency than Euro, change eur to one of the available currencies.
  6. Locate the line with http://newton.norman.com/affiliate/norman_webshop.php?
      id=XXXX&language=YY&js=1
     
  7. Replace XXXX with your affiliate id. If you do not do this, you will not receive your commission.
  8. If you want another language on your page than English change YY to one of the available languages.
  9. Save the file
  10. Navigate your browser to the file, for example http://yoursite.com/norman_webshop.html to check that the result is as you want it to be.

The files

The webshop consists of two files; one HTML file and one css-file (stylesheet). The files will have comments in them, and this document will try to describe them in detail.

norman_webshop.html

This is the webpage your visitors will go to. It consists of normal HTML-tags, and includes links to the two javascript files in this system, as well as to the stylesheet.
There is one small javascript which sets a global variable which you can change:

<script type="text/javascript">
var currency = 'nok';
</script>

The currency variable tells the system which currency to display prices (see below for an overview of available currencies).

There is a line like this in the file:

<script src="http://newton.norman.com/affiliate/norman_webshop.php?
   id=XXXX&language=YY&js=1" type="text/javascript"></script>

This is the line which requests a file on Norman’s server, which generates the javascript array containing the data that will be transformed with another javascript file. Remember to change the XXXX to your affiliate id and YY to your desired language (see below for available languages).
Language tells the system in which language the different texts will be shown (the file will contain an overview of available languages).

The javascript array created by this will be transformed by the norman_webshop.js (this file is on Norman’s server, but you may download it and edit it) and will be placed in the div tag with id “products":
Note that if you download the norman_webshop.js file to your own server, you must change the link in norman_webshop.html accordingly.

The data which is placed here are made up of different div-tags and their structure can be found below.

norman_webshop.css

This is the stylesheet for the webshop page. This is where the div tags are given their styles. You can change this to reflect you own web design styles. For example font, size, placement, margins etc.

DIV structure

This is how the resulting DIV tags are structured automatically by norman_webshop.js:

<div id="main">
<div id="productgroup"></div>
<div id="box">
<div id="image">
<div id="right">
<div id="info"></div>
<div id="additional"></div>
<div id="license"></div>
</div>
</div>
</div>

Below is an example of how this will look like for one product group: Norman Virus Control.

main surrounds the entire block. Inside this you will find productgroup which has the value “Norman Virus Control Single User". Next is box which surrounds the remaining div tags. image contains the box-shot of the product. Then there is a right which has three tags inside. First is info which has the short product information (“User-friendly...etc). Additional is the “Product info", which links to the detailed product information on Norman’s web. Finally license will contain the licenses available for this product group; 1, 2 and 3 year licenses. They will be linked into the element5 cart page, from which the customer can go back to this page.

The XML feed

The XML-feed this system uses contains up_to-date prices in all currencies, up-to-date product information and images, and other relevant text. The XML-feed will change at least once a day due to currency exchange rates (about two hours after midnight UTC).

To view the XML, follow this link:
http://newton.norman.com/affiliate/norman_webshop.php?
   id=XXXX&language=YY

Replace XXXX with your affiliate id and YY with the language you want.

(if you add the parameter &js=1 to the URL above it will return a javascript array instead of a XML-feed)

You will see that the root node is called products
Then there is a node for text:

<text>
<addtocart>Add to cart</addtocart>
<prodinfo>Product Info</prodinfo>
</text>

This will contain some text in the selected language which is used in the automatic system above.

Then the nodes for productgroup follow. Each of these will have the following child nodes: name (name of the group), productinfo (short description in selected language), productimage (the current box-shot of the product), additionalinfo (link to product information on Norman’s web) and license.
license will have the following child nodes: name (name of the license, for example 1 year license), productid (the element5 product id), pricing and link (the link which will add the product/license to the element5 cart page). pricing will contain the price of the product/license in all currencies.

Currencies and languages

The following currencies are available:

eur
nok
sek
usd
gbp
chf
ars
aud
brl
cad
cny
hkd
inr
jpy
nzd
rub
sgd
krw
twd

The following languages are available:

no = Norwegian
de = German
fr = French
en = English
fi = Finnish
se = Swedish
es = Spanish
it = Italian
dk = Danish
nl = Dutch