######################################################################
##################     g_book.cgi  version 1.1    ####################
######################################################################                        
# Guestbook Plugin for perlshop.cgi                                  #
# Author : Chris Jacobs.(aka Jack)                                   # 
#          (email: Jack@sarune, chris_jacobs_nj@yahoo.com)           #
#                                                                    #
# I created this guestbook script from a script available on the net #
# I simply changed it to work as a plugin to use with the free       #
#                 shopping cart program Perlshop 4.                  #
#            Perlshop version 4.2.06 or later is required.           #
#                The latest version is available from                #
#                       waveridersystems.com                         #
#                                                                    #
#           WORKING DEMO  @ www.sarune.com/Sarunatic/                #
#                                                                    #
######################################################################
# Revision History                                                   #
######################################################################
# Version 1.1                                                        #
# - added SSI option                                                 #
# - added eMail hypertext link on result page option                 #
######################################################################
#                                                                    #
# I have tried to document the script for changing the variables     #
# that will need to be changed. Any suggestions, comments, questions #
# for improving the script or this ReadME file please send me eMail  #
#                          jack@sarune.com                           #   
#                                or                                  #
#                      chris_jacobs_nj@yahoo.com                     #
#                and I will do my best to help out                   #
#                          Thank you, Jack                           #
#                                                                    #
#    This script takes the entries from the form on the webpage      #
#     and then opens either a SSI file or the webpage itself         #
#      and writes the newest entry when it encounters the            #
#                     comment <!--bookmark-->                        #
#       so if you ever upload a new SSI file or webpage with         #
#        the same name as the one you have been using                #
#                 YOU WILL OVERWRITE THE ENTRIES                     #
#           So please look over the code and try to                  #
#      understand what is going on, it's not too difficult           #
#                                ;)                                  #
######################################################################
#                           OK, HERE IT IS                           #
#                                                                    #
#  You will need to upload the g_book.cgi to your cgi-bin where you  #
#  have your perlshop.cgi located. You will also need to upload the  #
#  message.html file to the catalog directory where you keep your    #
#  other catalog pages.Remember to upload all files as ASCII         #
#                 and set permissions to 755                         #
#                                                                    #
# IF YOU USE SERVER SIDE INCLUDES                                    #
# AND WANT A TO USE A SEPARATE FILE FOR THE ENTRIES                  #
#     Just set the Variable $SSI  equal to "YES"                     #
#     Set the Variable $GUESTBOOK TO YOUR .shtml FILE (message.shtml)#
#     Set the Variable $MESSAGES to your .txt file (messages.txt)    #
#     Then just include the .txt file into pages where you want to   #
#      show the page entries. If you keep your .txt file in          #
#      a sub directory of catalog then you will need to              #
#      reference all directories in the include for example:         #
#    <!--#include file="catalog/products/widgets/filename.txt" -->   #
#                                                                    #
# IF YOU DO NOT USE SERVER SIDE INCLUDES                             #
#     Just set the Variable $SSI  equal to "NO"                      #
#     Set the Variable $GUESTBOOK TO YOUR .html FILE (message.html)  #
#     Ignore the Variable $MESSAGES                                  #
#                                                                    #
#  ALL OTHER VARIABLE ARE DOCUMENTED IN g_book.cgi                   #
#                                                                    #
# Please feel free to customize the script and message page if you   #
#        feel that you can, it's not too confusing.                  #
#  You will also need to add the script to the ps.cfg file in the    #
#     area that SAYS:                                                #
######################################################################
                                                                     
# Plugin modules.  See the external documentation for details.
%plugins =
(
	'calendar'  => 
	{
		'program'	=>	'gencal.pl'
	}
);


######################################################################
# Add the guestbook plugin as follows:                               #
######################################################################

# Plugin modules.  See the external documentation for details.
%plugins =
(
	'calendar'  => 
	{
		'program'	=>	'gencal.pl'
	},

	'guestbook'	=> 
	{
		'program'	=>	'g_book.cgi'
	}
);


######################################################################
#                                                                    #
#                         Thats all,                                 #
#    just refer to message.html(.shtml) like any other catalog page  #
#                 Any suggestions for a plugin?                      #
#              Email me - chris_jacobs_nj@yahoo.com                  #
#                                                                    #
######################################################################