HTML Rotate >> Documentation
HTML Rotate Documentation
1.1 Requirements to run HTML Rotate
1.2 Installation instructions
1.3 Using HTML Rotate
What is required to run HTML Rotate? (Most Linux based web hosts will automatically meet the requirements)
Your own standard cgi-bin directory.
This is the directory where the cgi scripts are executed from. An example of a standard cgi-bin directory:
Perl Ver 5+
FTP access to transfer files and to set permissions of files and directories.
Linux/Unix based host/server
- The Professional Version additionally requires a MySQL database.
1.2 Installation Instructions
The installation of HTML Rotate should be painless. Every measure has been taken to ensure that you get it right the first time. You don't have to edit any files and only need to supply information via a setup interface.
Follow the steps below exactly as described and you should have HTML Rotate serving you in a couple of minutes. Do the steps as you read through them. The setup instructions looks lengthy but it could actually have been explained in a couple of lines. The reason for it being a lot of text, is that we are trying to cover all possible situations when doing the setup and to explain it thoroughly to avoid any setup problems.
Step 1. (Extract the .zip archive)
Extract the files with their directories that came in the .zip archive.
Step 2. (Create a directory called 'html')
Create a directory called 'html' or anything else you would like to call it. This directory should be inside your public html directory.
Step 3. (Assign permissions of 777 to the 'html' directory)
Assign the permission setting of 777 to the 'html' directory you have just created.
Step 4. (Copy or transfer files to the 'html' directory)
The installation .zip archive will contain directories inside it. These directories are 'cgi', and 'html'
Now copy or transfer the files inside the 'html' directory of the .zip archive to the 'html' directory you have created.
Step 5. (Copy or transfer files to your 'cgi-bin' directory)
The .zip archive will contain directories inside it. These directories are 'cgi', and 'html'
Copy or transfer the files in the 'cgi' directory of the .zip installation archive to your 'cgi-bin' directory. You could also place the files in for example: http://www.yourdomain.com/cgi-bin/htmlrotate/
Step 6. (Set file permissions in cgi-bin directory)
Set the permissions of the .cgi and .pm files to the permission setting of 755.
Step 7. (Set config.cgi to the permission setting of 777)
Assign the permission setting of 777 to config.cgi - config.cgi is one of the files that you copied into your cgi-bin directory.
Step 8. (The setup interface)
Load setup.cgi in your browser and follow the instructions from there. setup.cgi is in your 'cgi-bin' directory where you have copied or transferred the .cgi and .pm files.
It should be located at, for example:
1.3 Using HTML Rotate
1.3.1 How to create HTML or text to be rotated
To create HTML or text snippets that is to randomly rotate on your web pages, log into the control panel.
Create a group for the first set of items to be rotated.
After you created a group, click on the 'edit' link next to it.
After clicking the 'edit' link, add a name for the HTML or text snippet and add the HTML code or text to the 'HTML Code or Text Snippet' box and press the 'Create' button. You can for example create a piece of HTML in your web editor and copy and paste the HTML code into the 'HTML Code or Text Snippet' box.
By adding more than one item, the HTML or text snippets will be rotated on your pages.
Let's say you now have a group and a couple of HTML or text snippets in the group. To rotate the HTML or text snippets on your web site, go to the 'Home' page section of the control panel and click the 'Get HTML code' link. Copy and paste the HTML code into the web pages where you would like the group of HTML or text snippets randomly rotated.
1.3.2 How to use images in HTML or Text snippets that is to be rotated
When you make use of images in the HTML code supplied, you must use a URL link to indicate their locations.
<img src="someimage.gif"> will not work.
You have to indicate the entire URL where someimage.gif is located. For example:
The <img is an HTML tag indicating that you want to insert an image in the HTML page. The src= part indicates that you want to specify the location of the image to be inserted. Some web editors will support inserting images from a web url and some won't. If your web editor does not support this, insert the image into the HTML page like usual and when finished edit the source of the HTML code and manually insert the URL path's to the images. Ensure that the images are on the server for the URL path's you specify.
Example, editing the HTML source code:
Replace <img src="someimage.gif"> with