default

default (type => check)
Path

$GLOBALS['TCA'][$table]['columns'][$field]['config']

Type

integer

Scope

Display / Proc.

The default value of the checkbox(es).

Each bit of the decimal value corresponds to a checkbox. As an example, the value 5 enables the first and third checkbox.

This is true even if there is only one checkbox, which then maps to the first bit (reading from right to left).

decimal value

binary representation

selected checkboxes

0

0000 0000

none

1

0000 0001

first

2

0000 0010

second

5

0000 0101

first, third

127

0111 1111

the first seven

To find out the right default decimal value, first start off by writing down the binary representation and set the desired bits at the appropriate position to 1. Then convert the binary number to decimal. You can either use a calculator with programmer mode or search online for "binary to decimal".

Examples

Multiple checkboxes with a default value

../../../../_images/Checkbox16.png

Here "Tu", the second bit, is active by default.

'columns' => [
    'checkbox_16' => [
        'exclude' => 1,
        'label' => 'checkbox_16',
        'description' => 'cols=inline',
        'config' => [
            'type' => 'check',
            'default' => 2,
            'items' => [
                ['label' => 'Mo'],
                ['label' => 'Tu'],
                ['label' => 'We'],
                ['label' => 'Th'],
                ['label' => 'Fr'],
                ['label' => 'Sa'],
                ['label' => 'Su'],
            ],
            'cols' => 'inline',
        ],
    ],
]