appearance¶

appearance ('type' => 'link')¶

Path: $GLOBALS['TCA'][$table]['columns'][$field]['config']
Type: array
Scope: Display

Has information about the appearance, namely:

allowedOptions (array)

New in version 12.0: Formerly known as blindLinkFields of linkPopup.options, which was a deny-list. Now this is an include-list.

Display certain options in the link browser. To allow all options in the Link Browser, skip this configuration or set it to ['*']. To deny all options in the Link Browser, set this configuration to [] (empty array).

class: Custom CSS classes for the link
params: Additional link parameters
target: Either empty, _top or _blank
title: The title attribute of the link
rel: The link relationship. Only available for RTE enabled fields and if buttons.link.relAttribute.enabled is enabled in the RTE YAML configuration.

// Display only 'class' and 'params'
'appearance' => [
    'allowedOptions' => ['class', 'params'],
],

// Allow all options (or skip this option).
'appearance' => [
    'allowedOptions' => ['*'],
],

// Deny all options
'appearance' => [
    'allowedOptions' => [],
],

New in version 12.3.

For custom email links, the options can be restricted:

body: The body of an email can be pre-filled.
cc: The "cc" field can be pre-filled.
bcc:: The "bcc" field can be pre-filled.
subject:: The subject of an email can be pre-filled.

'appearance' => [
    'allowedOptions' => ['body', 'cc'],
],

allowedExtensions (array)

New in version 12.0: Formerly known as allowedExtensions of linkPopup.options.

An array of allowed file extensions. To allow all extensions, skip this configuration or set it to ['*']. It's not possible to deny all extensions.

// Allow only jpg and png file extensions
'appearance' => [
    'allowedExtensions' => ['jpg', 'png'],
],

// Allow all file extensions (or skip this option).
'appearance' => [
    'allowedExtensions' => ['*'],
],

browserTitle (string, LLL)

New in version 12.0: Formerly known as title of linkPopup.options.

Allows to set a different title attribute for the Link Browser icon, defaults to Link.

// Either provide a LLL-reference (recommended)
'appearance' => [
    'browserTitle' => 'LLL:EXT:Resources/Private/Language/locallang.xlf:my_custom_title',
],

// Or a simple string value
'appearance' => [
    'browserTitle' => 'My custom title',
],

enableBrowser (boolean)

New in version 12.0: Formerly known as disabled of linkPopup.

The Link Browser is enabled by default. To disable the Link Browser altogether, set this option to false.

// Disable the link browser
'appearance' => [
    'enableBrowser' => false,
],