1. Unzip the file and transfer to your server with the following directory structure:

2. Chmod csBanner.cgi to executable (chmod 755). Ask your server administrator for assistance if required.

4. Run csBanner.cgi from your webrowser.

Example: http://www.mycompany.com/cgi-script/csBanner/csBanner.cgi

When the script is run for the first time, it goes into setup mode. A setup screen will appear where you can verify and modify the setup variables. Most of the time, there will be no need to modify any of these variables except the username and password. Those control access to the control panel and you can change then to anything you desire.

When you click the save button on the installation screen, it should automatically create a file called setup.cgi which will look something like:

$cgiurl='http://www.yourdomain.com/cgi-script/csBanner';
$cgipath='/home/httpd/vhosts/cgi-script/csBanner';
$datapath='/home/httpd/vhosts/cgi-script/csBanner/data';
$bannerpath='/home/httpd/vhosts/cgi-script/csBanner/banners';
$bannerurl='http://www.yourdomain.com/cgi-script/csBanner/banners';
$username='demo';
$password='CShjQYpiFrHXU';
1;

Note: Installations on unix servers will have the password encrypted

Note: If you get an error saying permission denied when you save the configuration screen, then you need to chmod the csBanner directory, the banners subdirectory and the data subdirectory to 777.

Hint: Deleting the setup.cgi file will trigger the script to go back into setup mode. This is also how you can reset the password in case you forget it.

Installing the script in your cgi-bin directory
If you can only run scripts from your cgi-bin directory then you will need to store the banners subdirectory somewhere outside the cgi-bin directory. This is due to the fact that cgi-bin directories won't allow you to view normal files like images. The html templates stay in the cgi-bin directory because they are outputted by the script are not meant to be directly accessible from your webbrowser. The only except is the client login page, login.htm. That page can be moved anywhere as long as the form action points to the csBanner installation.

1. Unzip the file on your local harddrive.
2. Upload the csBanner directory and the data subdirectory to your cgi-bin directory.
3. CHMOD the csBanner.cgi file to 755. You should end up with a structure like:

/cgi-bin/csBanner <-- csBanner directory
/cgi-bin/csBanner/color_selector.htm
/cgi-bin/csBanner/csBanner.cgi
/cgi-bin/csBanner/libs.cgi
/cgi-bin/csBanner/login.htm
/cgi-bin/csBanner/mod.cgi
/cgi-bin/csBanner/modsc.cgi
/cgi-bin/csBanner/readme.htm
/cgi-bin/csBanner/styles.pl
/cgi-bin/csBanner/t_add_banner.htm
/cgi-bin/csBanner/t_adddb.htm
/cgi-bin/csBanner/t_banner_advanced_settings.htm
/cgi-bin/csBanner/t_cp.htm
/cgi-bin/csBanner/t_login.htm
/cgi-bin/csBanner/t_manage.htm
/cgi-bin/csBanner/t_pub_manage.htm
/cgi-bin/csBanner/t_setup.htm
/cgi-bin/csBanner/t_show_links.htm
/cgi-bin/csBanner/t_show_links_mod.htm
/cgi-bin/csBanner/t_upload.htm
/cgi-bin/csBanner/data <-- directory to store the banners
/cgi-bin/csBanner/data/index.htm

/cgi-script/csBanner/banners <-- directory to store the banners
/cgi-script/csBanner/banners/index.htm
/cgi-script/csBanner/banners/logo_login.gif

If you have any problems or questions with the installation, don't hesitate to email support@cgiscript.net. We also offer installation services.

With your FTP program, browse to the csPublisher directory. Inside the csPublisher you will see a directory called 'mod'. If you don't see that directory then that means you need to upgrade csPublisher. Upload the csBanner directory from the zip file to the mod directory. If csPublisher was installed in your cgi-bin directory, then you'll need to put the banners directory for csBanner outside your cgi-bin directory.. Otherwise you can keep it with the other files so you will end up with the following structure:
mod/csBanner
mod/csBanner/data
mod/csBanner/banners
CHMOD csBanner.cgi to 755 and open it with your web browser.. For example, the URL might be: http://www.yourdomain.com/cgi-script/csPublisher/mod/csBanner/csBanner.cgi
Verify the variables, change the username and password variables to the same username and password you have configured for csPublisher. If you get a permission denied error, you will need to CHMOD the csBanner directory to 777, along with the data subdirectory. Then go back to the setup screen and you should be able to save it now.

If csBanner is installed successfully, you will be able to enter csPublisher, go to the html editor and in the misc. functions dropdown you should see 2 new items to select. Insert Banner and Manage Banners. Select the Manage Banners function to enter csBanner management. You will also see a link to manage csBanner at the bottom of the main management screen for csPublisher.

Install the new version of csBanner as described above. You can either install it in a new directory or overwrite the old files. The preferred method would be to install it in a different directory like csBanner2 instead of csBanner. If you are overwriting the files, then you will also need to delete the old setup.cgi file for the new version to go into the auto-setup mode.

Open import.cgi (included in the zip file) with a text editor and modify the following variables:
$oldbannerpath = '....';
$oldbannerurl = '....';

These variables should point to the old csBanner directory path and old csBanner directory URL. This would be the directory that contained the 'banners' subdirectory in case you had the directories split up on your previous install. Usually, it would be the same as the $cgipath and $cgiurl variables or $htmlpath and $htmlurl variables if they exist from the old version. 

Upload import.cgi to the same directory where the new version of csBanner.cgi is located and chmod it to 755. Open it up with your webbrowser. For example,
http://www.yourdomain.com/cgi-script/csBanner/import.cgi

You will see a series of messages. If all goes well, when you log into the new version of csBanner you will see all your old groups and banners imported.

The final phase of upgrading is to go into the link wizard and replace the old display code currently on your site with the display code from the new version. The code between the old version and new version are different so you will need to redo the display code or your banners will not display on your pages.

DELETE THE IMPORT.CGI FILE FROM THE DIRECTORY AFTER THE IMPORT IS COMPLETE

If you experience any problems or questions, please feel free to email contact@cgiscript.net