fieldWizard
-
- Type
- array
- TCA path
- $GLOBALS['TCA'][$table]['columns'][$field]['config']['fieldWizard']
- Scope
- Display
- Types
- category, check, color, country, datetime, email, file, folder, group, imageManipulation, inline, input, json, link, number, radio, select, slug, text
Specifies wizards rendered below the main input area of an element. Single type / renderType elements can register default wizards which are merged with this property.
For example, type='check' comes with this default wizards configuration:
EXT:backend/Classes/Form/Element/CheckboxElement.php (excerpt)protected $defaultFieldWizard = [ 'localizationStateSelector' => [ 'renderType' => 'localizationStateSelector', ], 'otherLanguageContent' => [ 'renderType' => 'otherLanguageContent', 'after' => [ 'localizationStateSelector', ], ], 'defaultLanguageDifferences' => [ 'renderType' => 'defaultLanguageDifferences', 'after' => [ 'otherLanguageContent', ], ], ];Copied!TYPO3 merges this configuration with the configuration from TCA. To switch off a default wizard, set its
disabledkey totrue. To switch on a wizard that is disabled by default, setdisabledtofalse.The render type
selectcomes with the wizardSingle selectdisabled. The location field of a conference switches it on, so it shows the images of the locations:Icons
The images of the locations below the location field of a conference
EXT:my_extension/Configuration/TCA/Overrides/110-tx_myextension_conference-location.php<?php use TYPO3\CMS\Core\Utility\ExtensionManagementUtility; defined('TYPO3') or die(); ExtensionManagementUtility::addTCAcolumns('tx_myextension_conference', [ 'location' => [ 'label' => 'my_extension.db:conference.location', 'config' => [ 'type' => 'select', 'renderType' => 'selectSingle', 'foreign_table' => 'tx_myextension_location', 'items' => [ ['label' => '', 'value' => 0], ], 'fieldWizard' => [ 'selectIcons' => [ 'disabled' => false, ], ], 'relationship' => 'manyToOne', // Venues only, not their halls 'foreign_table_where' => 'AND {#tx_myextension_location}.{#parent} = 0 ORDER BY tx_myextension_location.name', ], ], ]); ExtensionManagementUtility::addToAllTCAtypes( 'tx_myextension_conference', 'location', '', 'after:conference_date', );It is possible to add own wizards by adding them to the TCA of the according field and pointing to a registered renderType, to resort wizards by overriding the
beforeandafterkeys, to hand over additional options in the optionaloptionsarray to specific wizards, and to disable single wizards using thedisabledkey. Developers should have a look at the FormEngine docs for details.