appearance¶
Changed in version 12.0
The following properties have been removed:
[appearance][headerThumbnail]
[appearance][fileUploadAllowed]
[appearance][fileByUrlAllowed]
Use the TCA column type file to handle files.
-
appearance
¶ -
- Type
- array
- Path
- $GLOBALS['TCA'][$table]['columns'][$field]['config']
- Scope
- Display
Has information about the appearance of child records, namely:
- collapseAll (boolean)
- Show all child records collapsed (if false, all are expanded)
- expandSingle (boolean)
- Show only one child record expanded each time. If a collapsed record is clicked, the currently open one collapses and the clicked one expands.
- showNewRecordLink (boolean)
- Disables the New record link in TCA
inline
elements without simultaneously disabling the + button in the header of each inline record (using['appearance']['enabledControls']['new']
). - newRecordLinkAddTitle (boolean)
-
Adds the title of the foreign_table to the "New record" link.
- false
- "Create new"
- true
- "Create new <title of foreign_table>", e.g. "Create new address"
- newRecordLinkTitle (string or LLL reference)
-
Overrides the title of the "New record" link with a localized string. This will work only if
newRecordLinkAddTitle
is not set to true.Example:
'newRecordLinkTitle' => 'LLL:EXT:myext/Resources/Private/Language/locallang_db.xlf:my_new_record_label'
Copied! - createNewRelationLinkTitle (string or LLL reference)
- Overrides the link text and title of the "Create new relation" button with a localised string. Only useful, if the element browser is enabled. This is usually used together with FAL relations to change it to "Add file" or similar.
- levelLinksPosition (string)
- Values: 'top' (default), 'bottom', 'both'. Defines where to show the "New record" link in relation
to the child records. Value 'none' is no longer supported, use
showAllLocalizationLink
,showSynchronizationLink
andshowNewRecordLink
with valuefalse
instead. - useCombination (boolean)
- This is only useful on bidirectional relations using an intermediate table with attributes. In a "combination" it is possible to edit the attributes AND the related child record itself. If using a foreign_selector in such a case, the foreign_unique property must be set to the same field as the foreign_selector.
- suppressCombinationWarning (boolean)
-
Suppresses the warning flash message that will be displayed when using useCombination. You can also override the message with your own message using the example below.
Example:
$GLOBALS['TCA']['tx_demo_domain_model_demoinline']['columns']['irre_records']['config'] = [ 'appearance' => [ 'overwriteCombinationWarningMessage' => 'LLL:EXT:demo/Resources/Private/Language/locallang_db.xlf:tx_demo_domain_model_demoinline.irre_records.useCombinationWarning', 'useCombination' => TRUE ], ],
Copied! - useSortable (boolean)
- Activate drag & drop.
- showPossibleLocalizationRecords (boolean)
- Show unlocalized records which are in the original language, but not yet localized.
- showAllLocalizationLink (boolean)
- Defines whether to show the "localize all records" link to fetch untranslated records from the original language.
- showSynchronizationLink (boolean)
- Defines whether to show a "synchronize" link to update to a 1:1 translation with the original language.
- enabledControls (array)
- Associative array with the keys 'info', 'new', 'dragdrop', 'sort', 'hide', 'delete', 'localize'. If the accordant values are set to a boolean value (true or false), the control is shown or hidden in the header of each record.
- showPossibleRecordsSelector (boolean)
- Can be used to hide the foreign record selector from the interface, even if you have a foreign_selector configured. This can be used to keep the technical functionality of the foreign_selector but is useful if you want to replace it with your own implementation using a custom control, see customControls.
- elementBrowserEnabled (boolean)
- Hides or displays the element browser button in inline records