Attention

TYPO3 v7 has reached its end-of-life November 30th, 2018 and is not maintained by the community anymore. Looking for a stable version? Use the version switch on the top left.

There is no further ELTS support. It is recommended that you upgrade your project and use a supported version of TYPO3.

TYPE: "check"¶

This type creates checkbox(es).

There can be between 1 and 31 checkboxes. The corresponding database field must be of type integer. Each checkbox corresponds to a single bit of the integer value, even if there is only one checkbox.

Tip

This means that you should theoretically check the bit-0 of values from single-checkbox fields and not just whether it is true or false!.

Properties
Properties details
Examples

Properties ¶

Property	Data Type
cols	integer
default	integer
eval	string
items	array
itemsProcFunc	string
showIfRTE	boolean
type	string
validation	array

type ¶

Key

type

Datatype

string

Description

[Must be set to "check"]

Scope

Display / Proc.

items ¶

Key

items

Datatype

array

Description

If set, this array will create an array of checkboxes instead of just a single "on/off" checkbox.

Notice: You can have a maximum of 31 checkboxes in such an array and each element is represented by a single bit in the integer value which ultimately goes into the database.

In this array each entry is itself an array where the first entry is the label (string or LLL reference) and the second entry is a blank value. The value sent to the database will be an integer where each bit represents the state of a checkbox in this array.

Example:

'items' => array(
    array('Green tomatoes', ''),
    array('Red peppers', '')
),

Scope

Display

cols ¶

Key

cols

Datatype

integer/string

Description

In how many columns the checkboxes will be shown.

Allowed values are 1, 2, 3, 4, 6 or inline, 1 being default.

Range is 1-31, 1 being default.

(Makes sense only if the 'array' key is defining a checkbox array)

Scope

Display

showIfRTE ¶

Key

showIfRTE

Datatype

boolean

Description

If set, this field will show only if the RTE editor is enabled (which includes correct browser version and user-rights altogether.)

Scope

Display

default ¶

Key

default

Datatype

integer

Description

Setting the default value of the checkbox(es).

Notice: Each bit corresponds to a check box (even if only one checkbox which maps to bit-0).

Scope

Display / Proc.

itemsProcFunc ¶

Key

itemsProcFunc

Datatype

string

(function reference)

Description

PHP function which is called to fill / manipulate the array with elements.

The function/method will have an array of parameters passed to it (where the item-array is passed by reference in the key 'items'). By modifying the array of items, you alter the list of items. Since TYPO3 CMS 6.2, your function/method may throw an exception which will be displayed as a proper error message.

For more information, see how user-functions are specified in the section about 'wizards' some pages below here.

Scope

Display

eval ¶

Key

eval

Datatype

list of keywords

Description

Configuration of field evaluation.

Keywords:

maximumRecordsChecked

If this evaluation is defined, the maximum number of records from the same table that can have this box checked will be limited. If someone tries to check the box of a record beyond the allowed maximum, the box will be unchecked automatically upon saving.

The actual limit is defined with the validation property.

maximumRecordsCheckedInPid

Similar to maximumRecordsChecked but with the validation scope limited to records stored in the same page.

Scope

Proc.

validation ¶

Key

validation

Datatype

array

Description

Values for the eval rules. The keys of the array must correspond to the keyword of the related evaluation rule. The value will generally a number or whatever else is approppriate for the evaluation rule.

For maximumRecordsChecked and maximumRecordsCheckedInPid the value is expected to be an integer.

Example:

'eval' => 'maximumRecordsChecked',
'validation' => array(
    'maximumRecordsChecked' => 5
)

In this example, only five records from the same table will be allowed to have that particular box checked.

Scope

Proc.

Examples ¶

A single checkbox¶

A plain vanilla checkbox (the "Disable" checkbox from the "sys_template" table).

'hidden' => array(
        'label' => 'LLL:EXT:lang/locallang_general.xlf:LGL.disable',
        'exclude' => 1,
        'config' => array(
                'type' => 'check',
                'default' => '0'
        )
),

which results in:

The simplest possible form of checkbox¶

A checkbox array¶

This is an example of a checkbox array with two checkboxes in it. The first checkbox will have bit-0 and the second bit-1. The example is taken from the "pages" table.

'l18n_cfg' => array(
        'exclude' => 1,
        'label' => 'LLL:EXT:cms/locallang_tca.xlf:pages.l18n_cfg',
        'config' => array(
                'type' => 'check',
                'items' => array(
                        array(
                                'LLL:EXT:cms/locallang_tca.xlf:pages.l18n_cfg.I.1',
                                ''
                        ),
                        array(
                                $GLOBALS['TYPO3_CONF_VARS']['FE']['hidePagesIfNotTranslatedByDefault'] ? 'LLL:EXT:cms/locallang_tca.xlf:pages.l18n_cfg.I.2a' : 'LLL:EXT:cms/locallang_tca.xlf:pages.l18n_cfg.I.2',
                                ''
                        )
                )
        )
),

If we wanted both checkboxes to be checked by default, we would set the default property to 3 (since this contains both bit-0 and bit-1).

And this is the result in the backend:

Checkbox with array of options¶