DEPRECATION WARNING

This documentation is not using the current rendering mechanism and will be deleted by December 31st, 2020. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.

Checkboxes

What does it do?

  • General: Checkboxes are made for a multiselecting of options. The user can check one or more options.
  • Mandatory: This field could be marked as mandatory, so the user must fill min 1 checkbox, otherwise the form can not be submitted.
  • Prefill: The field can be preselected from FlexForm, TypoScript, GET/Post-Params or from FE_User table.
  • Special: Options could also filled by TypoScript in powermail 2.1 and higher (static or dynamic)

Frontend Output Example

example_field_checkbox

Backend Configuration Example

record_field_check_tab1

record_field_check_tab2

Explanation

Field Description Explanation Tab
Title Add a label for this field. The label is shown in the frontend near to this field. General
Type Choose a fieldtype. See explanation below for a special fieldtype. Different fields are related to some fieldtypes – not all fields are shown on every type. General
Options Options to check Separate each with a new line. Note: see following table for examples, how to precheck or clean a value General
Email of sender Check this if this field contains the email of the sender. This is needed to set the correct sender-email-address. If there is no field marked as Senderemail within the current form, powermail will use a default value for the Senderemail. General
Name of sender Check this if this field contains the name (or a part of the name) of the sender. This is needed to set the correct sender-name. If there is no field marked as Sendername within the current form, powermail will use a default value for the Sendername. General
Mandatory Field This field must contain input. Check this if the field must contain input, otherwise submitting the form is not possible. Extended
Value from logged in Frontend User Check if field should be filled from the FE_Users table of a logged in fe_user. This value overwrites a static value, if set. Extended
Create from TypoScript Fill Options from TypoScript If you want to create your options (see above) from TypoScript, you can use this field. Please split each line in your TypoScript with [n] Extended
Layout Choose a layout. This adds a CSS-Class to the frontend output. Administrator can add, remove or rename some of the entries. Extended
Description Add a description for this field. Per default a description will be rendered as title-attribute in the labels in frontend. Extended
Variables – Individual Fieldname This is a marker of this field. Use a field variable with {marker} in any RTE or HTML-Template. The marker name is equal in any language. Extended
Add own Variable Check this, if you want to set your own marker (see row before). After checking this button, TYPO3 ask you to reload. After a reload, you see a new field for setting an own marker. Extended
Language Choose a language. Choose in which frontend language this record should be rendered. Access
Hide Disable the form Enable or disable this record. Access
Start Startdate for this record. Same function as known from default content elements or pages in TYPO3. Access
Stop Stopdate for this record. Same function as known from default content elements or pages in TYPO3. Access

Option examples for checkbox

Example option Generated HTML code in Frontend
Red <label>Red</label><input type=”checkbox” value=”Red” />
Yellow | 1 <label>Yellow</label><input type=”checkbox” value=”1” />
Blue | <label>Blue</label><input type=”checkbox” value=”” />
Black Shoes | black | * <label>Black Shoes</label><input type=”checkbox” value=”black” checked=”checked” />
White | | * <label>White</label><input type=”checkbox” value=”” checked=”checked” />
Red Shoes | red | *
Yellow Shoes | yellow | *
<label>Red Shoes</label><input type=”checkbox” value=”red” checked=”checked” />
<label>Yellow Shoes</label><input type=”checkbox” value=”yellow” checked=”checked” />