GuestBook script

The GuestBook script enables you to add a guest book to your site where your visitors can "sign" their names, provide their contact information or leave comments, suggestions or ideas. The GuestBook script is pre-installed and configured for your server. The URL for your guest book is:

http://www.yourdomain.com/guest/guestbook.html

If you use the GuestBook script in your site, your guest book entries will be stored in:

/www/yourdomainname/cgi-bin/guestbook.pl

If you are not familiar with scripting, you can use SiteControl's Script Managers to customize these scripts and automatically generate any necessary HTML code. The Script Managers provide Web-based interfaces that simplify the process of customizing these scripts and walk you through the steps. For more information, see the SiteControl User Guide.

You can customize this script in two different ways:

• Customize the guest book main page (guestbook.htm)
• Select from a number of options that control the way the guest book operates.

Before you modify the guestbook.htm file or the guestbook.pl script, download the files in ASCII mode from the server to your computer and make a backup copy of the original files.

To customize the main page:

1. Connect to your server and locate the guestbook.htm file at /home/[domainname]/www/guest.
2. Download the file in ASCII mode.
3. Open and modify this HTML file in any way you like. Be sure, however, to leave the <input> and <method> tags unchanged.
4. Save and upload the file as necessary.

To select guest book options:

1. Connect to your server and locate the guestbook.pl script in your /cgi-bin directory.
2. Download the file in ASCII mode.
3. Open the file and turn the following options on (1) or off (0) as desired:
   
   

   Options	Description
   $mail	Enables you to have notifications automatically sent to a specified email address each time a new entry is added to your guest book. If you turn this feature on (1), define the following two variables: $recipient. The email address to which to send the email notification. $mailprog. The location of the "send mail" program on your host machine: /usr/sbin/sendmail
   $uselog	Enables you to use the logging feature.
   $linkmail	Turns the email addresses in your guest book into hyperlinks.
   $separator	When this option is turned on, entries in the guest book will be separated with a horizontal rule. If this option is not activated, entries will be separated as paragraphs.
   $redirection	Enables you to redirect your visitors to another page after they "sign" the guest book. If this option is not turned on, visitors will receive a confirmation that their entry has been received and will be provided a link to return to the guest book.
   $entry_order	When this option is turned on, new entries are added to the top of the list. When this option is turned off, new entries are added to the bottom of the list.
   $remote_mail	Enables you to automatically send a form email message to any user who adds his or her contact information to the guest book. If you turn this feature on (1), you can specify the contents of the email message by editing the section of the script that sends the mail to the remote user.

4. Save and upload the file.