Login / Status
developer.Resource
Home . Documentation . Document Library . Extension Manuals
Sponsors
hosted by punkt.deTYPO3 and Open Source Magazine

1.4. Plugin Configuration

Add a new content item

General: Enter a header

This fields are similar to the standard text plugin (header, start and stop time, frame, language...) (see TYPO3 documentation for more information)

Formdata: Main settings

  1. Formtitle: Enter a title for the whole form

  2. Activate confirmation page: If checked there will be a confirmation page after form-submit (like: are your values ok?)

  3. Multiple steps:

  4. Single step: The whole form is shown on one page (All fieldsets will be shown)

  5. Multiple steps (JS): Each fieldset (see below) is an own page. Switch between pages via Javascript

  6. Multiple steps (PHP): Each fieldset (see below) is an own page. Swich between pages via HTML/PHP

Fields: Create new Fieldsets (pages)

  1. Create new Fieldsets: You can create more pages (fieldsets), if you want to use the moresteps function. Every step is a fieldset. You need to choose min. 1 fieldset for every form.

  2. Preview: This iframe previews the your frontend at once, so you can see your changes /Note: You can deactivate this iframe in the extension manager (maybe faster working possible)

Fields: Add fields (IRRE)

  1. Fieldset Title: Enter a title for your fieldset

  2. Fieldtype: Choose any fieldtype (textfield, textarea, selectbox, checkbox, radiobutton, submit, reset, text, pagecontent, html, password, file upload, hidden, datetime, date, time, button, graphicsubmit, countryselect) /NOTE: See a detailed description below

  3. Create new Fields: You have to enter your fields (like name and email)

  4. Field Title: Enter a title for your field (title is listed as form label)

  5. Settings (Text field) Size: If you want to enter a size. Alternative you can set the width and height via CSS

  6. Settings (Text field) Max. Length: Set max. length for textfiels

  7. Settings (Text field) Read only: Field is set to read only

  8. Settings (Text field) Mandatory field: Field is obsolete

  9. Settings (Text field) Default value: Choose a value to prefill the textfield

  10. Settings (Text field) Validate this field for: You can activate a js validation (see below)

  11. Settings (Text field) Name for Templates: If you want to use this value in any template, use this code

  12. Settings (Text field) Field example: There is an example picture of the current field

  13. Fill out this field with fe_user field: Prefill field (if fe_user is logged in) with any data from fe_user / You can set the allowed fe_user fields via Ext Manager

Note: Different fields have different setting possibilities (see below for details)

Fields: Add fields (without IRRE)

If IRRE is disabled (TYPO3 < 4.1) or manually, you have to add the relation manually:

  1. Add a new content element (powermail) if not yet done

  2. Use “create new record” to add a fieldset manually (enter the relation to the powermail content on the same page)

  3. Use “create new record” to add a field manually (enter the relation to the powermail fieldset on the same page)

Note: Different fields have different setting possibilities (see below for details)

Fields: Add textfield

  1. Size: Set field size (size=””) (we suggest you to use CSS for field width)

  2. Max. Lengh: Set maximum length of signs in this field (maxlength=””)

  3. Read only: Check to be a read only field (readonly=”readonly”)

  4. Mandatory field: This field is a needed field – no db and no email without this field (check with JavaScript and PHP)

  5. Default value: Prefill field with a value (value=””)

  6. Validate this field for: This is a javascript validation

  1. check for email addresses (like test@test.com)

  2. check for URL (like http://www.test.de)

  3. check for digits only (like 3.6)

  4. check for digits without comma and point (like 3)

  5. check for letters only (a-z)

  6. check for letters and digits only (a-z and 0-9)

  1. Name for Templates: If you want to use this value in any template, use this code

  2. Field example: You will see a picture example of the chosen field

Fields: Add textarea

  1. Number of columns: Set columns (cols=””)

  2. Number of rows: Set rows (rows=””)

  3. Read only: Set field to a read only field (readonly=”readonly”)

  4. Mandatory field: This field is a needed field – no db and no email without this field

  5. Default value: Prefill field with a value (<textarea>My value</textarea>)

  6. Name for Templates: If you want to use this value in any template, use this code

  7. Field example: You will see a picture example of the chosen field

Fields: Add selectbox

  1. Enter your options: Every line is a new option for the selececterbox like red, green and blue / - If you want different label and values, you can write: label | value / - If you're going to use the same label and value, you can write: value

  1. Size: Set field size (size=””)

  2. Multiple seletc allowed: Allow more than one value to select (multiple=”multiple”)

  3. Mandatory field: This field is a needed field – no db and no email without this field

  4. Name for Templates: If you want to use this value in any template, use this code

Option examples for selectorbox

Line

Example for options

Explanation of left example (html code in frontend)

1

Red

<option value="red">red</option>

2

Red | 1

<option value="1">Red</option>

3

Blue |

<option value="">Blue</option>

4

Black | black | *

<option value="black" selected="selected">Black</option>

5

White | | *

<option value="" selected="selected">White</option>

Fields: Add checkbox

  1. Enter your options: Every line is a new option for the selececterbox like red, green and blue / - If you want different label and values, you can write: label | value / - If you're going to use the same label and value, you can write: value

  2. Mandatory field: This field is a needed field – no db and no email without this field

  3. Name for Templates: If you want to use this value in any template, use this code

Option examples for checkboxes

Line

Example for options

Explanation of left example (html code in frontend)

1

Red

<label>Red</label><input value="Red" />

2

Red | 1

<label>Red</label><input value="1" />

3

Blue |

<label>Blue</label><input value="" />

4

Black | black | *

<label>Black</label><input value="black" checked="checked" />

5

White | | *

<label>White</label><input value="" checked="checked" />

Fields: Add radiobutton

  1. Enter your options: Every line is a new option for the selececterbox like red, green and blue / - If you want different label and values, you can write: label | value / - If you're going to use the same label and value, you can write: value

  2. Mandatory field: This field is a needed field – no db and no email without this field

  3. Name for Templates: If you want to use this value in any template, use this code

Option examples for radiobuttons

Line

Example for options

Explanation of left example (html code in frontend)

1

Red

<label>Red</label><input value="Red" />

2

Red | 1

<label>Red</label><input value="1" />

3

Blue |

<label>Blue</label><input value="" />

4

Black | black | *

<label>Black</label><input value="black" checked="checked" />

5

White | | *

<label>White</label><input value="" checked="checked" />

    Fields: Captcha request

    1. Description: Write your own description in front of the captcha field

    2. Name for Templates: If you want to use this value in any template, use this code

    3. Field example: You will see a picture example of the chosen field

    4. NOTE: First of all you have to install sr_freecap or captcha and choose (via constants) which one should be used (Standard: sr_freecap)

    Fields: Add submitbutton

    1. Default value: Enter a value for the button

    2. Field example: You will see a picture example of the chosen field

    Fields: Add resetbutton

    1. Default value: Set your value (label) for this field (value=””)

    2. Field example: You will see a picture example of the chosen field

    3. NOTE: Please look at a html reference to know the difference between submit and reset

    Fields: Add text

    1. Default value: Enter your Text here (you can define which html signs are allowed via ts constants)

    2. Send this content via email: If you want to send this content via email, check this

    3. Field example: You will see a picture example of the chosen field

    4. Name for Templates: If you want to use this value in any template, use this code

    5. NOTE: Send this content via email is not yet finished programed at this time!

    Fields: TYPO3 pagecontent

    1. Default value: Choose any tt_content uid to show in frontend

    1. Send this content via email: This is not available at the moment!

    2. Field example: You will see a picture example of the chosen field

    3. Name for Templates: If you want to use this value in any template, use this code

    4. NOTE: Send this content via email is not yet finished programed at this time!

    Fields: HTML code

    1. Default value: Enter your HTML code here

    2. Send this content via email: This is not available at the moment!

    3. Field example: You will see a picture example of the chosen field

    4. Name for Templates: If you want to use this value in any template, use this code

    5. NOTE: Send this content via email is not yet finished programed at this time!

    Fields: Add a password field

    1. Size: Set field size (size=””) (we suggest you to use CSS for field width)

    2. Max. Lengh: Set maximum length of signs in this field (maxlength=””)

    3. Read only: Set field to a read only field (readonly=”readonly”)

    4. Mandatory field: This field is a needed field – no db and no email without this field

    5. Field example: You will see a picture example of the chosen field

    6. Name for Templates: If you want to use this value in any template, use this code

    7. NOTE: Password fields are described in selfhtml.org

    Fields: Upload field

    1. Size: Set field size (size=””) (we suggest you to use CSS for field width)

    1. Mandatory field: This field is a needed field – no db and no email without this field

    2. Name for Templates: If you want to use this value in any template, use this code

    1. Field example: You will see a picture example of the chosen field

    2. NOTE: You can set the upload folder via constants (see below) – only the filename will be written

    Fields: Hidden field

    1. Default value: Set your value for this field (value=””)

    2. Name for Templates: If you want to use this value in any template, use this code

    1. NOTE: Hidden fields are described in selfhtml.org

    Fields: Date, Time and Datetime field

    1. NOTE: This fields are only supported if you have installed the extension date2cal!

    2. Default value: Set a default value (you can use the date2cal icon for better writing in backend and frontend

    3. Size: Set field size (size=””) (we suggest you to use CSS for field width)

    4. Read only: Set field to a read only field (readonly=”readonly”)

    5. Mandatory field: This field is a needed field – no db and no email without this field

    6. Name for Templates: If you want to use this value in any template, use this code

    7. Field example: You will see a picture example of the chosen field

    Fields: Button field

    1. Default value: Set a default value

    2. Note: Button fields are without any function (if you don't use Javascript with this)

    3. Field example: You will see a picture example of the chosen field

    4. Note: JS implementation is not finished programed at this time

    Fields: Graphic submit field

    1. Grafic source: Enter a source for the graphic submit button (like fileadmin/test.jpg)

    2. Alternative Text for image: use the alt tag (alt=””)

    3. Field example: You will see a picture example of the chosen field

    1. NOTE: Imagebuttons are described in selfhtml.org

    Fields: Countryselect field

    1. NOTE: This fields are only supported if you have installed the extension static_info_tables!

    2. Country shortage for preselect: Select one country to be preselected in frontend

    3. Only show this countries: If you chose some countries – ONLY this countries will be shown

    4. Show list without this countries: Show whole list without this selected countries (Don't works with “Only show this countries”)

    5. Name for Templates: If you want to use this value in any template, use this code

    6. Field example: You will see a picture example of the chosen field

    Sender: Sender email and subject

    1. Sender field: Choose any of your fields to mark as sender email (This is needed to send an email to the sender, This field will be checked if the value is really an email address)

    2. Subject for sender's mail: Choose any email subject / NOTE: You can use markers in email subject to get a subject like “Thank you Alex for your mail”

    3. Email-Text for sender: You can use this RTE to write the mail content for the sender

    4. NOTE: This RTE is substituted with tmpl_emails.html / You can use all markers in the RTE and the HTML template!

    Recipients: Receiver email and subject

    1. Subject for recipient's mail: Choose an email subject for the receiver / NOTE: You can use markers in email subject to get a subject like “New mail from Alex”

    2. Recipient: Enter some email receivers (separated with comma, semicolon or with a new line) / - If you want to enter a sender name, just write: name \n email1 \n email2 \n email3 ... /- You can also use markers in this field instead of an email: test@test.de, ###UID3###

    1. Table of recipients: Choose any database table, if you want to send to one or more (e.g. Backend or Frontend) users

    2. Recipients from upper table: If you have chosen any db table, select some email addresses

    3. Alternative SQL-Query: You can enter an own SQL query to get your own email addresses /- Example: SELECT email FROM fe_users WHERE pid = 12 /- You can also use markers in the query like SELECT email FROM fe_users WHERE uid = ###UID5### / - Not allowed strings: UPDATE, TRUNCATE, DELETE, INSERT, REPLACE, DO, HANDLER, LOAD, ALTER, CREATE, DROP, RENAME, DESCRIBE, USE, BEGIN, COMMIT, ROLLBACK, LOCK, SET, REVOKE, GRANT

    1. Email-Text for receiver: You can use this RTE to write the mail content for the receiver

    2. NOTE: This RTE is substituted with tmpl_emails.html / You can use all markers in the RTE and the HTML template!

    3. NOTE2: Priority of recipient fields: Recipient, Table choose, SQL query

    Answerpage: Thx message

    1. Response Text: This text is shown after submit

    2. Auto-redirect after confirmation-page: You can forward the user after submit to any intern or extern URL or file (instead of using the message)

    3. NOTE: This RTE is substituted with tmpl_thx.html / You can use all markers in the RTE and the HTML template!

    Access: Form access

    1. Similar to text: Choose your access an general options (see TYPO3 documentation for more information)