appearance¶
Changed in version 12.0: The following properties have been remove:
[appearance][headerThumbnail]
[appearance][fileUploadAllowed]
[appearance][fileByUrlAllowed]
Use the TCA column type file to handle files.
- appearance (type => inline)¶
- Path
$GLOBALS['TCA'][$table]['columns'][$field]['config']
- Type
array
- 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 localised 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'
- 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 FlashMessage 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 ], ],
- 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