csGuest Installation Instructions

Included in the zip file is a setup.cgi.example file for your convenience, however, the auto installation portion of the script should configure and save the setup.cgi file for you automatically. 

Quick and Easy Installation Instructions:

Note: If you don't have the ability to run scripts outside your cgi-bin directory, see the cgi-bin installation instructions below.

1. Unzip the file on your computer.

2. Upload the cgi-script directory and its entire contents to a directory on your server (including the images and data subdirectories). This should be the same place where your index.htm file resides. All the files except for the images should be transferred in ASCII mode. You should end up with the following directory structure:
cgi-script
cgi-script/csGuest
cgi-script/csGuest/images
cgi-script/csGuest/data

3. CHMOD csGuest.cgi,vimage, and vsimage to 755.

3. Open up the csGuest.cgi file from your web browser. For example, open up your web browser and in the location field type: http://www.yourdomain.com/cgi-script/csGuest/csGuest.cgi .You should get the auto setup screen. Verify the information and change the username and password to your liking.. If you get an error message saying it can't save the setup.cgi file.. You will need to chmod the csGuest directory to 777 AND the csGuest/data directory to 777 and then try to resave the configuration info.

4. Once configured, you can enter the management of csGuest at any time by going to the URL: http://www.yourdomain.com/cgi-script/csGuest/csGuest.cgi?command=login

CGI-BIN Installation Instructions:

CGI-BIN directories are normally configured to disallow the viewing of images and other plain files. Due to this limitation you will need to place the images directory somewhere outside your cgi-bin directory. 

1. Unzip the file on your computer.

2. Upload the csGuest directory and its entire contents to your cgi-bin. Upload the data directory to the csGuest directory. All the files except for the images should be transferred in ASCII mode. You should end up with the following directory structure:
cgi-bin/csGuest
cgi-bin/csGuest/data

3. Create a directory in your normal html space (same place that your homepage resides) called 'cgi-script'. Inside that directory, create another directory called 'csGuest' and upload the images directory and its contents there. You should end up with

/cgi-script/csGuest/images

3. CHMOD csGuest.cgi, vimage.cgi, and vsimage.cgi to 755.

3. Open up the csGuest.cgi file from your web browser. For example, open up your web browser and in the location field type: http://www.yourdomain.com/cgi-bin/csGuest/csGuest.cgi .You should get the auto setup screen. Verify the information. Make sure the imageurl variable is pointing to the correct place.. i.e. http://www.yourdomain.com/cgi-script/csGuest/images. Change the username and password to your liking.. If you get an error message saying it can't save the setup.cgi file.. You will need to chmod the csGuest directory to 777 AND the csGuest/data directory to 777 and then try to resave the configuration info.

4. Once configured, you can enter the management of csGuest at any time by going to the URL: http://www.yourdomain.com/cgi-bin/csGuest/csGuest.cgi?command=login

 

Installing csGuest as a module for csPublisher.

1. Inside the csPublisher directory there will be a directory called 'mod' (if you don't have this directory, email us for the latest version of csPublisher). You need to install csGuest in that directory for csPublisher to pick it up as a module. When uploaded, it should be located at http://www.yourdomain.com/[urltopublisherdir]/mod/csGuest/csGuest.cgi
where [urltopublisherdir] is the where you have csPublisher installed on your server. Example:
http://www.yourdomain.com/cgi-script/csPublisher
or
http://www.yourdomain.com/cgi-bin/csPublisher

2. Once uploaded to that directory follow either the regular installation instructions.

3. To use the module, you log into csPublisher and you will see an additional row called 'Module Management' on the bottom of your file list. Clicking on the csGuest link will allow you to manage csGuest. Inside the editor in the misc functions dropdown, you will see 2 new options. Insert Guestbook and manage csGuest.

To insert a guestbook  to a webpage with the editor, simple place your cursor where you would like the guestbook to appear. Go to misc functions -> Insert Guestbook. Then select the guestbook you wish to add and click the place code button. That's it! Click 'save and exit' from the file menu to save the page. The guestbook should then appear on the page. You can resize the area where the guestbook appears but this is for only viewing in the editor. On a live web page, the guestbook will fill the width of the page or table.

NOTE ABOUT PERMISSIONS

If your webserver doesn't have write access to your files by default you will get an error message when you try to save the setup.cgi file. If you are on a windows based webserver, you will need to contact your hosting service to configure your directories so the webserver has write access to them. If you are on a unix based server, including FreeBSD or Linux, you can chmod the csGuest directory to 777 and the data subdirectory to 777. After the setup.cgi file has been created, you can chmod the csGuest directory back to 755 if you like.

Troubleshooting

I uploaded the files and when I run csGuest.cgi I get a 500 server error. 
500 Server errors are usually caused by incorrect FTP transfer modes or permissions problems. To make sure the file was uploaded in the correct mode, download the csGuest.cgi file off the server to your computer in BINARY mode and then reupload it back to the server in ASCII mode. Some FTP programs, like WS_FTP for example, will say its transferring in ASCII mode but instead transfers it in binary mode on some occasion. This seems to be most prevalent when your website is controlled by the Plesk web management system.

I forgot my username and password. How do I find out what it is?
You will need to delete the setup.cgi file and rerun the autosetup to change the username and password if you don't know what it is.. otherwise, there is a change password function on the main management screen when you are logged in.

I installed the script and everything seems to be working fine but I can't view the images in the script.
This happens when you have the images in your cgi-bin directory. Cgi-bin directories won't allow you to view normal files in them. They will usually give you either a 500 server error or a forbidden error message if you try to view them directly from your cgi-bin directory. If you are installing in the cgi-bin directory, follow the cgi-bin installation instructions.

I really would like to run the script from on directory outside my cgi-bin directory. How can I set that up?
If you have the apache web server running your site, then sometimes you can use an .htaccess file to configure the directory to run scripts. To do this, open up notepad and type:
AddHandler cgi-script .cgi
Options +ExecCGI

Save that file as .htaccess and upload it to the csGuest directory. Make sure there is a period in from of the name (.htaccess) and make sure there is no 'txt' extension. If there are problems with the name, you should be able to rename it correctly from your FTP program. If you get a forbidden error message instead of it displaying the source of the script, you might be able to just try
Options +ExecCGI in your .htaccess leaving out the AddHandler line. If when you do this you get a 500 server error.. this usually means you are forbidden to use these directives in the .htaccess file. If that is the case you need to delete the .htaccess file to be able to view files in that directory again. It is also more common than not that .htaccess files are hidden by the FTP server. When you upload the .htaccess file.. many times you won't be able to see it in the directory listing. If this is the case, what you can do is create a blank .htaccess file and just reupload that back to the server as opposed to deleting the file.

I get a forbidden error message when I try to run script.
This is usually caused by the script not being set to executable. Make sure the file permissions are set (CHMOD) to 755.

I am running a windows server. I know I can run Perl scripts on my site but when I try to run csGuest.cgi I either get a 500 server error or it displays the source of the script.
Many windows servers are set to only run files with a pl extension. What you can do is rename csGuest.cgi to csGuest.pl and then open csGuest.pl and change the line that says:
$in{'scriptname'} = 'csGuest.cgi';
to
$in{'scriptname'} = 'csGuest.pl';
Reupload the file and then try to open csGuest.pl with your web browser.

I have a windows server and when I try to run the script I get a 'can't locate libs.cgi' error message.
Open csGuest.cgi and where it has the line:
$basepath = './';
Change that to the full path to the csGuest program. Example:
$basepath = 'c:/inetpub/wwwroot/cgi-script/csGuest';

Also, make sure you use forward slashes in your path names instead of the normal windows backslashes.

When I try to log in, I get an error messages that says it can't find the page and the URL has in(cgiurl) in it.
That indicates you are trying to open one of the html files directory. You never go directly to any of the html template files. All access to these pages are through the script. Use csGuest.cgi or csGuest.cgi?command=login to log into the script.


Please refer to the instructions.htm page for detailed usage instructions. 

For tech support or questions, please email contact@cgiscript.net