Form Processor with no SPAM from robots.
Anti-spam, anti-robot, anti-flame, Guestbook for your website.
Manage Remote websites from your website. Allow clients to update sections of their own web pages.
PS Guestbook 2.1
|
 This Perl Script has been quality guarantee stamped by our customers. If this script does not perform for you on your server as advertised, we'll issue you with a full refund plus a 10% credit voucher.
|
CGI Script - PS Guestbook
Page 1 - Getting Started with PS GuestbookPage 2 - Managing PS Guestbook via Web Administration Settings
- On/Off Switches
- Validation Options
- Editing Templates
- Guest Form
Permit HTML
Permitting HTML in Messages posted by Guests can cause your Guestbook to render incorrectly if improper HTML is used. Unless you're an experienced Webmaster that can correct these types of error, we strongly recommend you leave this set to No. Whether set to Yes or No, PS Guestbook will attempt to strip all <script> tags.
To Top
Permit Edit
Permitting Editing enables your Guests to optionally set a Password at the time they create their Message, subsequently enabling them to Edit their own messages after supplying the correct Password. If you set this to Yes, you must also add a Form field to your Guest Form named Password. The complete code can be found in the Admin Section and by clicking on Guest Form in the Admin Control Panel.
Edit links will only appear beneath any Guestbook messages which have had a password set, and Permit Editing is set to Yes.
To Top
Parse Email
Setting Parse Email to Yes will automatically convert any e-mail addresses typed in Messages to click-able hyper-links. This also applies to the email field if you're printing it to the Guestbook.
To Top
Parse URL
Setting Parse URL to Yes will automatically convert any website addresses typed in Messages to click-able hyper-links. The following setting, Open in new Window?, will then force any converted hyper-links to open in a new browser window.
To Top
Direct Posting
Selecting Direct Post in the Validation Options will immediately post all messages to your Guestbook without validation or policing of any sort. This method will not go a long way in preventing your Guestbook from being trashed.
To Top
Admin Approved
Selecting Admin Approved in the Validation Options will notify you of any new requests made by your Guests to have their message posted to your Guestbook, thus allowing you to, at your own leisure, either :
a). log in and approve acceptable messages or
b). edit the pending messages prior to publishing them or
c). delete the undesired messages before they're ever seen by your decent visitors.
To Top
E-mail Confirmation
Selecting E-mail Confirmation in the Validation Options will store the submitted message in a non-visible database on your server and send an e-mail to the Guest asking them to confirm their request. Once the Guest clicks the link e-mailed to them, their message is immediately posted to your Guestbook, provided the expiration period (found in Settings under Expired Confirmations) has not lapsed.
To Top
Admin Notification E-mail
If you've selected Admin Approved as your Validation Option, it would be a good idea to also set Notify me of new Submissions to Yes so you're made aware of any new Guest submissions. On the same Settings page, a little further down you can modify the Admin Notification Template e-mail Subject and Message. Both the Subject and Message can be coded to send you the information typed in to your Guest Form by utilizing special markers.
Simply type in the name of any Form field found in your Guest Form, padded by 3 percentage signs on either side. Be sure not to include any spaces. To have the Guest's email address sent your e-mail notification for example, you could type the following in to your subject or Message :
Submitter's email address is : %%%email%%%
PS Guestbook will substitute %%%email%%% with the data typed in to the e-mail address field before issuing the notification e-mail.
Notes 1. Admin notification e-mail messages are not issued when an Administrator Posts a pending message from within the Admin section.
To Top
Confirmation E-mail
If you've selected E-mail Confirmation as your Validation Option, it's important that your Guest Form not only contains a Form field named email, but also requires the Guest to enter an e-mail address. See Requiring Fields for guidance on setting Guest Form fields as required.
If no e-mail address is entered in to the Guest Form, the Confirmation e-mail will not be delivered to the Guest and they will not be able to Confirm it. Admin however will be notified of a new submission if Notify me of new Submissions is set to Yes.
On the same Settings page, a little further down you can modify the Confirmation Template e-mail Subject and Message. Both the Subject and Message can be coded to send you the information typed in to your Guest Form by utilizing special markers.
Simply type in the name of any Form field found in your Guest Form, padded by 3 percentage signs on either side. Be sure not to include any spaces. To have the Guest's email address sent your e-mail notification for example, you could type the following in to your subject or Message :
Hi : %%%First_Name%%%, please click %%%link%%% ...
PS Guestbook will substitute %%%First_Name%%% with the data typed in to the First_Name field before issuing the notification to the Guest. The %%%link%%% marker is substituted by an auto-generated URL.
To Top
Thank You E-mail
The Thank You E-mail is issued to the Guest if all of the following conditions are met :
i. you have Send Thank You E-mail set to Yes and
ii. your guest entered a valid e-mail address and
one of the following events occurs :
i. you've selected Direct Post as your preferred Validation Option and a submission is made or
ii. you've selected E-mail Confirmation as your Validation Option and the Guest clicks the Confirmation Link sent in the Confirmation Template or
iii. you've selected Admin Approved as your Validation Option and as Admin you approve a pending message.
Notes 1. if you delete a pending message, the Thank You E-mail is not issued.
2. you can edit a pending message several times, the Thank You E-mail is only issued when you approve the message.
3. if you approve and post a message waiting to be confirmed by a Guest, the Thank You E-mail will be issued (provided all above conditions are met) and the message will no longer be available for the Guest confirm.
On the same Settings page, a little further down you can modify the Thank You Template e-mail Subject and Message. Both the Subject and Message can be coded to send you the information typed in to your Guest Form by utilizing special markers.
Simply type in the name of any Form field found in your Guest Form, padded by 3 percentage signs on either side. Be sure not to include any spaces. To have the Guest's email address sent your e-mail notification for example, you could type the following in to your subject or Message :
Thanks for your kind message : %%%First_Name%%%
PS Guestbook will substitute %%%First_Name%%% with the data typed in to the First_Name field before issuing the Thank You message to the Guest.
To Top
Custom Header and Footer
Found at the very bottom of the Admin Settings these large textboxes accommodate the carving in of your web site's look and feel. If you set Use Custom Header and Footer to Yes, all Aesthetical Settings are ignored and the code you enter in the textboxes is parsed instead.
Your Header code should start with an <html> and the Footer code should close it. Essentially, the code for your entire Guestbook page is sequentially made up of three parts: your Header code; the program generated code; followed by your Footer code; The sum of the three parts form to create one page. Each page of your Guestbook has it's Header and Footer remain constant, with only the Program Generated code changing.
Question 1 in our General FAQ may shed some more light on the flow of code.
To Top
Adding Custom Form Fields
You can add as many custom Form fields as you require to your Guest Form. Click on Guest Form in the Admin Control Panel and carefully read the guidelines printed.
As with Forms all over the Web, all standard HTML is valid. PSGuestbook will not however upload any files. You can then use your Custom Form fields in the e-mail templates to transmit information entered in to the Form to both yourself and the Guest.
You may copy the default code in to your favorite HTML editor to further develop it, provided it does not change the case of any of the form tags, and then paste it back in to the textbox and save it.
Should your Form cease to function after making changes, you may have to choice but to restore the original code, achieved by ticking the Restore Default Form checkbox and pressing the Submit changes button.
To Top
Requiring Fields
All fields are optional, unless defined as required. You define required fields by editing the Guest Form which can be accessed by clicking on Guest Form in the Admin Control Panel. The default Guest Form has the following four fields defined as required :
<input type="Hidden" name="required" value="First_Name,Last_Name,email,Comments">
The value of this input tag is a comma separated list of the names of your Form's fields. You can add or remove Form field names to require or unrequire those fields respectively. It's important you do not use any spaces in this tag.
To Top
