You are here: English > The Docu > Articles > Content Parts > Email form generator[OLD]

Content Part "Email form generator [OLD]"

earlier "email form"

Notice:
Since the Release 1.2.6 this Content Part is Renamend to "EMAIL FORM GENERATOR [OLD]".

From the beginnig it was called "Email Form" since the Release 1.1.9 the content part was renamed to "email content form".

subject (optional): Subject of the E-Mail.

recipient: The desired recipient of the E-Mail. Note: This field does not function properly in some systems - further down you find a workaround.

button text (optional): Text of the "Send" button. If this field remains empty, the standard "send" will be used.

send as: Here you can select whether the sent e-mail should contain only plain text or
HTML for formatting.

form fields (optional): Here you can define the form fields in the following format:

CODE|NAME|REQUIRED|LABEL|SIZE,MAXLENGTH|VALUE|CSS-WIDTH

CODE stands for one of these contractions:
IT = Text field (single-line)
IP = Password field
TA = Text field (of several lines)
SM = Pulldown-Menu
SL = Selection list
IC = Checkbox
IR = Radio Button
SC = Pulldown-Menu with standard country list
IH = Hidden field

NAME is the internal designation of the field, which is indicated in the e-mail.
REQUIRED stands for 1 (= necessary field) or 0 (= optional field).
LABEL stands for the title of the field, which the visitor sees.

SIZE stands for one of the following:
1. with selection lists, the number of lines showing
2. with check boxes and radio buttons, the width between options (in pixels)
and the number of options per row
3. with text fields the size of the field in number of characters.
4. with pull-down menus is it without meaning

MAX LENGTH stands for one for the following:
1. with check boxes, the number of columns
2. with text fields, the maximum number of characters which can be entered

VALUE can be used to enter pre-selected text or values into fields :
1. with text fields it is the default text that appears in the field
2. with a pull-down menu of the standard country list, it is the value that is
pre-selected (e.g. US for United States)
3. with pull-down menus, selection lists, check boxes and radio buttons,
VALUE represents the options which can be selected from. These options are entered
in the following format:

Option A#Option B%1%#Option C%1%C#Option D%0%D

The # character separates the individual options. In order to set an option as preselected, you add %1% after the desired option.
To set an alternate description for each option, enter it after %1%. If you want to use an alternate description that is not pre-selected, use %0% instead of %1%. The alternate description will only be used in the e-mail you receive.

CSS WIDTH stands for the width of the text field in pixels.

A set of form field definitions could look similar to the following example:

IT|firstname|1|First Name: |40,100|anon.|300
IT|email|1|Email: |40,100||300
IP|password|0|Password: |12,100||100
TA|info|0|Info: |20,3||300
SM|menu|0|Menu: |20,100|Test#Test2#Test3|300
SL|list|0|List: |3,0|1%Test#2%Test2#3%Test3#4%Test4|200
IC|mark|1|Check: |50,3|mark1%1%DU#mark2#mark3#List#
Again#Selection|0
IR|radio|1|Select: |50,0|mark1%1%DU#mark2#mark3|0
SC|country|0|Country: |10,100|US|300
IN|plz|1|PLZ: |40,100||300
IH|hiddencode|0||10,100|xyz123456|0

These definitions would lead to the following result:

There are five reserved field names, which can be used for special tasks:

1. language: indicates in which language the e-mail is to be written (either DE for
German or EN for English). If this field is not indicated, the e-mail is written in
English.

2. redirect: indicates onto which page the visitor will be re-directed to if the e-mail
was successfully sent. If this field is not indicated, the visitor is redirected to the
top-level page.

3. redirect_error: indicates onto which page the visitor will be re-directed to if the email
form did not function and did not send. If this field is not indicated, the visitor
is redirected to the top-level page.

4. send_copy: it indicates with either 0 (= none) or 1 (= one), whether a carbon copy
of the email is to be sent.

5. email: the address to send an second copy to an second recipient.

Define these reserved field name functions as hidden fields in the following format:
IH|language|0||10,100|EN|0
IH|redirect|0||10,100|http://www.apple.com|0
IH|redirect_error|0||10,100|http://www.microsoft.com|0
IH|send_copy|0||10,100|1|0
IH|email|0||10,100|[email protected]|0

phpwcms-docu - Documentation for the Web Content Management System phpwcms

Content Part "Email form generator [OLD]"

earlier "email form"