|
Installation Instructions |
We offer professional installation but many people like to install their own applications or are behind a firewall that does not allow external access. Follow the instructions below and you should not have any trouble. If you do run into difficulty do not hesitate to ask for assistance. Quick Install 1. Unzip the file on your local
harddrive. Detailed Installation Instructions 1. Unzip the file and transfer to your server with the following directory structure: is the URL to your website. Example: http://www.mycompany.com/cgi-script/csBanner/csBanner.cgi 2. Chmod csBanner.cgi to executable (chmod 755). Ask your server administrator for assistance if required. 3. If your Perl executable is not located at /usr/bin/perl, edit the first line of csBanner.cgi to reflect the true location.4. Run csBanner.cgi from your webrowser.
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:
Note: If you keep returning to the setup screen then your web server doesn't have the ability to write to your directories. If that is the case, a work-around is to chmod the csBanner and banners directory to 777. Hint: Deleting the setup.cgi file will trigger the script to go back into setup mode. Installing the script in your cgi-bin directory Due to the limitations of cgi-bin directories, you'll need to create 2 directories when installing the script in the cgi-bin directory. One directory inside cgi-bin that will contain the script and a directory outside the cgi-bin directory where all the other files will reside. For example, in your cgi-bin directory upload the csBanner.cgi and libs.cgi file in a csBanner subdirectory.. i.e. cgi-bin/csBanner Create a directory outside your cgi-bin directory like cgi-script/csBanner and upload the remaining files there. Run csBanner.cgi from your webbrowser to auto-create the setup.cgi file. Add the following variables to reflect the directory outside the cgi-bin directory.
So, for example, your final setup.cgi file ( that should reside in your cgi-bin/csBanner directory ) should look something like:
If you have any problems or questions with the installation, don't hesitate to email support@cgiscript.net. We also offer installation services.
Go to [root url]/csBanner.cgi?command=login where [root url] is the location of the script.
Creating and Deleting Groups Once you've entered the management screen, click on the 'Add Group' button to create a banner group. To permanently delete a group, highlight the appropriate group in the dropdown and click the delete button. Groups allow you to have separate 'pools' of banners. For example, you could have sports related banners in one group and news related banners in another group. The groups can be added to different pages on your website. Adding Banners When in a particular group, click the 'Add Banner' button. Enter a banner description. This will be shown either above or below the banner depending. You can specify top or bottom in the advanced settings configured for that particular group. Enter the click-through URL. This is the URL you want the viewer
to go to when they click on the banner/link. NEW - There
is an additional text area to enter custom html code. If there is code
in this field, then the BannerURL field will be ignored and this field
will be used instead. This allows the program not to be limited to just
jpg and gif banners. You can enter html code to display flash banners
and other custom code. You can also create plain text links instead of a
banner or image. You can leave the click-thru URL field blank and use
your own links in the BannerHTML field, however if you do this, be aware
that the program will not be able to track the click-thru's for that
particular banner. Advanced Settings There are additional configuration settings in the advances settings screen. These options include
specifying file types (allow or disallow) and setting a size limit on the images that are uploaded. In the
banner listing format, you can change the border thickness of the banner, specify where to place the NEW - A new feature of csBanner is the ability to turn off detailed logging and to automatically reset the logs based on the log size for the group. This is helpful for high traffic sites where the log files can get very large in a short amount of time. Logs Each banner has 2 groups of logs. Impressions and
Click-Thru's. Impressions indicate how many times
the banner has been displayed on a web page. Click-Thru's are how many times a banner has been
clicked on. Click the links to view the detailed logging information. Placing the Banners on your Web Pages. Click the 'Display Link' button to get the code needed to display the banners on your web pages. There are 2 types of code, server side include (SSI) and JavaScript. The advantage with using JavaScript is you don't have to have server side includes (SSI) enabled on your server to display the banners, plus you can call the banners across domain names. With server side includes (SSI), you can only call the code from the same server the script is installed on. NEW - A new feature for csBanner is to create javascript script slide shows of all the banners within that group. Just cut/paste either the SSI or javascript code to your webpage and the visitors will see all the banners rotate automatically from within their browser. The time delay between browsers can be modified in the advanced settings for the group. For this option, the weight and descriptive text is ignored. Also, if you use this option, you should make sure all your banners are the same dimensions. You don't want different dimension banners rotating because the surrounding text and layout will change with the size. If you experience any problems or questions, please feel free to email contact@cgiscript.net
|