For a new guestbook entry, a form page must be setup with all the fields you would like to offer.

Each field is composed of the field name (in red) and its corresponding value (see screenshot) according to the user input. Every field within this form can be processed by GuestBook.

Not only does the submit button has the function to send the data to the following page, the name of the submit button is crucial to GuestBook: only if this button initates the form will the corresponding GuestBook object process the data.

If the objects detects the submit button, the processing of a new entry is initiated. Fields you want to check against are tested whether they contain any value or are empty - leading to an success or error message.

GuestBook looks for a correct email email adress and in case it finds one uses the EMail format string to add an entry - otherwise the standard format string will be used.

The text finally added is formatted according to the format string and the current values of the form - the format strings should contain placholders to combine them.

Nomally (1) the GuestBook simply outputs the content of the guestbook file.

When activated by a form (2) it processes the form content and may add an entry or display an error message - of course it displays the content of the guestbook file as well.