.. include:: Images.txt
.. ==================================================
.. FOR YOUR INFORMATION
.. --------------------------------------------------
.. -*- coding: utf-8 -*- with BOM.
.. ==================================================
.. DEFINE SOME TEXTROLES
.. --------------------------------------------------
.. role:: underline
.. role:: typoscript(code)
.. role:: ts(typoscript)
:class: typoscript
.. role:: php(code)
.. _radio:
Radio Buttons
~~~~~~~~~~~~~
What does it do?
''''''''''''''''
- **General:** Radiobuttons are made for a single select of an options in the same layout as checkboxes.
- **Mandatory:** This field could be marked as mandatory, so the user must fill min 1 radiobutton, 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_radio|
Backend Configuration Example
'''''''''''''''''''''''''''''
|record_field_radio_tab1|
|record_field_radio_tab2|
Explanation
'''''''''''
.. t3-field-list-table::
:header-rows: 1
- :Field:
Field
:Description:
Description
:Explanation:
Explanation
:Tab:
Tab
- :Field:
Title
:Description:
Add a label for this field.
:Explanation:
The label is shown in the frontend near to this field.
:Tab:
General
- :Field:
Type
:Description:
Choose a fieldtype.
:Explanation:
See explanation below for a special fieldtype. Different fields are related to some fieldtypes – not all fields are shown on every type.
:Tab:
General
- :Field:
Options
:Description:
Options to check
:Explanation:
Separate each with a new line. **Note: see following
table for examples, how to precheck or clean a value**
:Tab:
General
- :Field:
Email of sender
:Description:
Check this if this field contains the email of the sender.
:Explanation:
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.
:Tab:
General
- :Field:
Name of sender
:Description:
Check this if this field contains the name (or a part of the name) of the sender.
:Explanation:
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.
:Tab:
General
- :Field:
Mandatory Field
:Description:
This field must contain input.
:Explanation:
Check this if the field must contain input, otherwise submitting the form is not possible.
:Tab:
Extended
- :Field:
Value from logged in Frontend User
:Description:
Check if field should be filled from the FE_Users table of a logged in fe_user.
:Explanation:
This value overwrites a static value, if set.
:Tab:
Extended
- :Field:
Create from TypoScript
:Description:
Fill Options from TypoScript
:Explanation:
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]
:Tab:
Extended
- :Field:
Layout
:Description:
Choose a layout.
:Explanation:
This adds a CSS-Class to the frontend output. Administrator can add, remove or rename some of the entries.
:Tab:
Extended
- :Field:
Description
:Description:
Add a description for this field.
:Explanation:
Per default a description will be rendered as title-attribute in the labels in frontend.
:Tab:
Extended
- :Field:
Variables – Individual Fieldname
:Description:
This is a marker of this field.
:Explanation:
Use a field variable with {marker} in any RTE or HTML-Template. The marker name is equal in any language.
:Tab:
Extended
- :Field:
Add own Variable
:Description:
Check this, if you want to set your own marker (see row before).
:Explanation:
After checking this button, TYPO3 ask you to reload. After a reload, you see a new field for setting an own marker.
:Tab:
Extended
- :Field:
Language
:Description:
Choose a language.
:Explanation:
Choose in which frontend language this record should be rendered.
:Tab:
Access
- :Field:
Hide
:Description:
Disable the form
:Explanation:
Enable or disable this record.
:Tab:
Access
- :Field:
Start
:Description:
Startdate for this record.
:Explanation:
Same function as known from default content elements or pages in TYPO3.
:Tab:
Access
- :Field:
Stop
:Description:
Stopdate for this record.
:Explanation:
Same function as known from default content elements or pages in TYPO3.
:Tab:
Access
Option examples for radio buttons
'''''''''''''''''''''''''''''''''
.. t3-field-list-table::
:header-rows: 1
- :Example:
Example option
:HTML:
Generated HTML code in Frontend
- :Example:
Red
:HTML:
- :Example:
Yellow \| 1
:HTML:
- :Example:
Blue \|
:HTML:
- :Example:
Black Shoes \| black \| \*
:HTML:
- :Example:
White \| \| \*
:HTML:
- :Example:
| Red Shoes \| red \| \*
| Yellow Shoes \| yellow \| \*
:HTML:
|
|