; --------------------------------------------------------------------
; WARNING : BE EXTRA CAREFULL WHILE EDITING THIS CONFIGURATION FILE
;           MAKE SURE THE FOLLOWING RULES ARE STRICTLY FOLLOWED:
; --------------------------------------------------------------------

; 1.  This configuration file is organised in sections.
; 2.  Each section name is specified between square brackets e.g. website, form, etc.
; 3.  Sections names are predefined and cannot be changed.
; 4.  Each section contains one or more parameters, one per line.
; 5.  Parameters are specified as follows : <parameter name> = <parameter value>
; 6.  Parameters names are predefined and cannot be changed (see newsletter section for exceptions).
; 7.  Parameters values and comments cannot contain the following characters :
;     a. left and right square brackets.
;     b. equal sign.
;     c. semi-colon.
;     d. vertical bar (ascii code 124).
; 8.  Sections and parameters are flagged as mandatory or optional.
; 9.  Mandatory sections must be present.
; 10. Mandatory parameters must be defined.
; 11. Parameters' value are flagged as mandatory or optional.
; 12. A mandatory parameter value cannot be empty, e.g. 'name = ' is illegal.
; 13. An optional parameter value can be empty, e.g. 'header = ' is legal.
;     Note that parameter name and equal sign must still be present.
; 14. Some parameters accept only a pre-defined set of values, those
;     values are listed when applicable.

; --------------------------------------------------------------------
; NON COMPLIANCE TO THE ABOVE SPECIFICATION CAN RESULT IN AN INCORRECT
; BEHAVIOUR OF YOUR ALIAS TELL A FRIEND SCRIPT.
; --------------------------------------------------------------------

[website]                                               ; section is mandatory
name       =                                            ; mandatory parameter, mandatory value
abuse      =                                            ; mandatory parameter, mandatory value

[form]                                                  ; section is mandatory 
width      = 380                                        ; mandatory parameter, mandatory value

[redirect]                                              ; section is mandatory 
location   =                                            ; mandatory parameter, optional value
backtopage = true                                       ; mandatory parameter, mandatory value, must be 'true' or 'false'

[logging]                                               ; section is mandatory 
active     = false                                      ; mandatory parameter, mandatory value, must be 'true' or 'false'
path       = ./log/                                     ; mandatory parameter, optional value  
separator  = lf                                         ; mandatory parameter, mandatory value, must be 'lf' or 'crlf' 

[newslayout]                                            ; section is mandatory
layout  = 3                                             ; mandatory parameter, mandatory value, must be '1', '2' or '3'

[titles]                                                ; section is mandatory
details    = Your details                               ; mandatory parameter, optional value
emails     = Your friends' email addresses              ; mandatory parameter, optional value
message    = Your message (optional)                    ; mandatory parameter, optional value
newsletter = Subscribe to newsletters (optional)        ; mandatory parameter, optional value
submit     = Tell your friends                          ; mandatory parameter, optional value

[images]                                                ; section is mandatory
details    =                                            ; mandatory parameter, optional value
emails     = separator.gif                              ; mandatory parameter, optional value
message    = separator.gif                              ; mandatory parameter, optional value
newsletter = separator.gif                              ; mandatory parameter, optional value
submit     = separator.gif                              ; mandatory parameter, optional value
last       =                                            ; mandatory parameter, optional value

[mail]                                                  ; section is mandatory
subject    = Visit this Website                         ; mandatory parameter, optional value
message    = message.txt                                ; mandatory parameter, optional value 

[html]                                                  ; section is mandatory
stylesheet = styles.css                                 ; mandatory parameter, optional value 
header     = header.html                                ; mandatory parameter, optional value 
footer     = footer.html                                ; mandatory parameter, optional value 

[newsletters]
; !!! this section is optional !!!
; Add as many newsletters as required. Each parameters must be defined as follows :
; newsletter<number> = <description> | <newsletter email> | <pre-checked>. Where
; <number> must start at 1 and must be increased by 1 for the next entry, no
; numbering gaps are allowed. The <pre-checked> parameter sub value must be set to
; true or false, it determines whether the corresponding newsletter is pre-checked
; in the form, see the examples below :

newsletter1 = Newsletter #1 Description | email@address1.com | false ; optional parameter, mandatory value
newsletter2 = Newsletter #2 Description | email@address2.com | false ; optional parameter, mandatory value
newsletter3 = Newsletter #3 Description | email@address3.com | false ; optional parameter, mandatory value