Getting Started: Configuration

The first step in customizing the viewer is to configure your environment.

Upload files to website

The easiest way to create a new theme is to build it on top of one of the basic themes provided by Issuu. So we'll start by downloading a basic theme containing everything you need, and uploading these files to your own website. It has to be publicly accessibly website, so the Issuu viewer can access them.

Download the tutorial theme and unzip the archive.

Copy the crossdomain.xml file and the Issuu folder to the root of your website.

Besides the layout.xml and the skin.swf file, there's two files called crossdomain.xml. These allow the Issuu viewer access to the other styling resources. One of the crossdomain.xml files should be located at the root level of you website, and the other crossdomain.xml file in the folder where you have your stying resources.

Note: Besides the location of the two crossdomain.xml files, you don't have to follow this file or folder structure.

The uploaded file should be located like so:

http://website.com/crossdomain.xml
http://website.com/issuu/basicBlue/crossdomain.xml
...

See that it works

Having fully deployed the basic theme onto your website, you should now be able to see it work.

Copy the URL below, and paste it into the address bar of your web browser, replacing the value of the layout parameter with the path to the layout.xml file on your website.

http://issuu.com/jesper/docs/gan_issuu?mode=embed&documentId=080311154822-183d3d833
4a544518a0d5e324f2543d4&layout=http://example.com/issuu/basicBlue/layout.xml

When you open this URL in your web browser, it should look like this:
If it cannot access your files, a default grey theme is shown.

Bookmark this URL for later.

 

Congrats! All files are working.
Next: IML Basics

 

Overview