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

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: Overview

Title:

Explanation:

Example Output:

Category:

Textfield

Simple text fields (one line)

<input type=”text” />

STANDARD

Textarea

Text fields with more lines

<textarea>text</textarea>

STANDARD

Select box

Selector box (dropdown)

<select><option>1</option></select>

STANDARD

Checkbox

Checkbox

<input type=”checkbox” />

STANDARD

Radio Button

Radio buttons

<input type=”radio” />

STANDARD

Submit Button

Submit button

<input type=”submit” />

STANDARD

Captcha Request

Captcha picture with input field to validate a human entry (captcha or sr_freecap needed)

<img src=”captcha.php” /><input type=”text” />

EXTRA

Reset Button

Reset buttons

<input type=”reset” />

EXTRA

Show some text

Enter a text and show it in the frontend

Text blabla

EXTRA

TYPO3 page content

Show any TYPO3 page content

<p class=”bodytext”>blabla</p>

EXTRA

Enter your own html code

Enter your html code

<span style=”color: red”>bla</span>

EXTRA

Password field

Password field

<input type=”password” />

EXTRA

File upload

Standard upload field for files

<input type=”file” />

EXTRA

Hidden field

Hidden value

<input type=”hidden” />

EXTRA

Date and time field

Text field with a javascript calendar

<input type=”text” /><script ...>...</script>

EXTRA

Date field

Text field with a javascript calendar

<input type=”text” /><script ...>...</script>

EXTRA

Button

Simple a button without a function (maybe usefull for a javascript)

<input type=”button” />

EXTRA

Graphic as submit

Submit Image

<input type=”image” />

EXTRA

Country selection

Selector box with countries (static_info_tables needed)

<select><option>Germany</option>...</select>

EXTRA

Add typoscript object

Output any value from your typoscript

Any value from typoscript

EXTRA

Multiple upload

Multiple upload fields are part of the extension powermail_mul (enables upload of more files)

<input type=”file” />...

EXTENSIONS

Fields: Explanation

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!

    6. NOTE: Maybe removeXSS disables all features – you can disable this function via constants

    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. Country shortage for preselect: Select one country to be preselected in frontend

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

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

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

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

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

    2. NOTE2: If you want a localized version, you can use (e.g.) static_info_tables_de (or fr etc...) - (TS example: config.language = de for staticinfo_tables_de)

    3. NOTE3: You can use utf8_encode or utf8_decode via constants

    Fields: Typoscript field

    1. Typoscript object: enter an typoscript element for your output (define this element via typoscript setup)

    2. Field example: Example for a typoscript setup

    3. NOTE: You can use every object from typoscript for this kind of fields (maybe it's interesting to add a userfunc for some special fields, etc...)

    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)