.. include:: /Includes.rst.txt .. index:: TCEFORM Records; editing options .. _tceform: .. _pagetceformconfobj: .. _pagetceformflexformsheet: ======= TCEFORM ======= Allows detailed configuration of how editing forms are rendered for a page tree branch and for individual tables if you like. You can enable and disable options, blind options in selector boxes etc. See the core API document section :ref:`FormEngine ` for more details on how records are rendered in the backend. Applying properties =================== The properties listed below apply to various contexts which are explained per property. The full property path thus depends on the property and where it should apply. In general, a more specific property path overrides a less specific one: Some properties apply to single fields, those can be usually set per table or per table and record type. This leads to the property paths `TCEFORM.[tableName].[fieldName].[propertyName]` to configure the field for all types and `TCEFORM.[tableName].[fieldName].types.[typeName]` to configure a field for a specific type, see the :ref:`TCA type section ` for details on types. While all that property path munging looks messy at first, it should become more clear when reading through the single properties below and looking at the examples. .. youtube:: B3IQq7pIJ_o .. _tceformApplyPropertiesFlexForm: Applying properties to FlexForm fields -------------------------------------- Other properties also apply to :ref:`FlexForm ` fields, in this case the full property path including the data structure key has to be set: .. code-block:: typoscript # TCEFORM.[tableName].[fieldName].[dataStructureKey].[flexSheet].[flexFieldName with escaped dots].[propertyName] TCEFORM.tt_content.pi_flexform.sfregister_create.sDEF.settings\.fields\.selected.addItems.ZZZ = ZZZ The sheet name (sDEF) must be given only if the FlexForm has a sheet. The `[dataStructureKey]` represents the key of a FlexForm in :php:`$GLOBALS['TCA'][]['columns'][]['config']['ds']`. This key will be split into up to two parts. By default the first part will be used as identifier of the FlexForm in TSconfig. The second part will override the identifier if it is not empty, `list` or `*`. For example the identifier of the key `myext_pi1,list` will be `myext_pi1` and of the key `*,my_CType` it will be `my_CType`. See section :ref:`Pointing to a data structure ` of the TCA reference for details. The flexFieldName is the name of the property in the FlexForm. If it contains dots ('.'), these must be escaped with backslash. Some properties apply to whole FlexForm sheets, their property path is `TCEFORM.[tableName].[fieldName].[dataStructureKey].[flexSheet].[propertyName]`. Properties ========== .. contents:: :depth: 2 :local: .. index:: Records; select items added addItems -------- :aspect:`Datatype` localized string :aspect:`Description` Change the list of items in :ref:`TCA type=select ` fields. Using this property, items can be added to the list. Note that the added elements might be removed if the selector represents records: If the select box is a relation to another table. In that case only existing records will be preserved. The subkey :typoscript:`icon` will allow to add your own icons to new values. .. versionadded:: 12.1 The subkey :typoscript:`group` can be used to insert a new element into an existing select item group by settings the value to the group identifier. The grouping is usually displayed in select fields with groups available. This property is available for various levels: table level, example: `TCEFORM.tt_content.header_layout.addItems` table and record type level, example: `TCEFORM.tt_content.header_layout.types.textpic.addItems` Flex form field level, example: `TCEFORM.tt_content.pi_flexform.myext_pi1.sDEF.settings\.myfield.addItems` Where `sDEF` is the sheet name. For a description see the section :ref:`tceformApplyPropertiesFlexForm` on this page. .. warning:: Do not add page types this way (using `TCEFORM.pages.doktype.addItems`), instead the proper PHP API should be used to do this, see :ref:`Core APIs ` for details. :aspect:`Example` .. code-block:: typoscript :caption: EXT:site_package/Configuration/page.tsconfig TCEFORM.tt_content.header_layout { # Add another header_layout option: addItems.1525215969 = Another header layout # Add another one with localized label, icon and group addItems.1525216023 = LLL:EXT:my_ext/Resources/Private/Language/locallang.xlf:header_layout addItems.1525216023.icon = EXT:my_ext/icon.png addItems.1525216023.group = special } Instead of adding files by path, icon identifiers should be used. .. index:: Records; labels changed altLabels --------- :aspect:`Datatype` localized string :aspect:`Description` This property applies to :ref:`TCA type=select `, :ref:`TCA type=check ` and :ref:`TCA type=radio `. This property allows you to enter alternative labels for the items in the list. For a single checkbox or radio button, use `default`, for multiple checkboxes and radiobuttons, use an integer for their position starting at 0. This property is available for various levels: table level: `TCEFORM.[tableName].[fieldName].altLabels` table and record type level: `TCEFORM.[tableName].[fieldName].types.[typeName].altLabels` Flex form field level, example: `TCEFORM.tt_content.pi_flexform.myext_pi1.sDEF.settings\.myfield.altLabels` Where `sDEF` is the sheet name. For a description see the section :ref:`tceformApplyPropertiesFlexForm` on this page. :aspect:`Example` .. code-block:: typoscript :caption: EXT:site_package/Configuration/page.tsconfig TCEFORM.pages.doktype { # Set a different item label altLabels.1 = STANDARD Page Type altLabels.254 = Folder (for various elements) # Sets the default label for Recycler via "locallang": altLabels.255 = LLL:EXT:my_ext/Resources/Private/Language/locallang_tca.xlf:recycler } .. figure:: /Images/ManualScreenshots/List/PagesDoktypeDifferentLabels.png :alt: The Page types with modified labels The Page types with modified labels .. note:: If the item has an **empty** value, the syntax is slightly different and an additional dot must be provided, like on this example: .. code-block:: typoscript :caption: EXT:site_package/Configuration/page.tsconfig TCEFORM.tt_content.space_before_class.altLabels.. = foo Note the *double dot* after `altLabels`. .. _page_tsconfig_id: PAGE_TSCONFIG_ID ---------------- :aspect:`Datatype` integer :aspect:`Description` This option allows to provide a value for dynamic SQL-WHERE parameters. The value is defined for a specific field of a table. For usage with flexform fields, the entire path to a sub-field must be provided. .. note:: This value can be used for the TCA property :ref:`foreign_table_where ` and for the `addWhere` part of the :ref:`suggest wizard `. :aspect:`Example` .. code-block:: typoscript :caption: EXT:site_package/Configuration/page.tsconfig TCEFORM.tt_content.pi_flexform.myext_pi1.sDEF.myField.PAGE_TSCONFIG_ID = 22 In this example, the value will substitute the marker in a plugin FlexForm. .. code-block:: typoscript :caption: EXT:site_package/Configuration/page.tsconfig TCEFORM.tx_myext_table.myfield.PAGE_TSCONFIG_ID = 22 This example might be used for a record in an extension. It refers to a table called `tx_myext_table` and the field `myfield`. Here the marker will be substituted by the value `22`. .. _page_tsconfig_idlist: PAGE_TSCONFIG_IDLIST -------------------- :aspect:`Datatype` list of integers :aspect:`Description` See above. :aspect:`Example` .. code-block:: typoscript :caption: EXT:site_package/Configuration/page.tsconfig TCEFORM.tt_content.pi_flexform.myext_pi1.sDEF.myField.PAGE_TSCONFIG_IDLIST = 20,21,22 In this example, the value will substitute the marker in a plugin FlexForm. .. code-block:: typoscript :caption: EXT:site_package/Configuration/page.tsconfig TCEFORM.tx_myext_table.myfield.PAGE_TSCONFIG_IDLIST = 20,21,22 This example might be used for a record in an extension. It refers to a table called `tx_myext_table` and the field `myfield`. Here the marker will be substituted by the list of integers. .. _page_tsconfig_str: PAGE_TSCONFIG_STR ----------------- :aspect:`Datatype` string :aspect:`Description` See above. :aspect:`Example` .. code-block:: typoscript :caption: EXT:site_package/Configuration/page.tsconfig TCEFORM.tt_content.pi_flexform.myext_pi1.sDEF.myField.PAGE_TSCONFIG_STR = %hello% In this example, the value will substitute the marker in a plugin FlexForm. .. code-block:: typoscript :caption: EXT:site_package/Configuration/page.tsconfig TCEFORM.tx_myext_table.myfield.PAGE_TSCONFIG_STR = %hello% This example might be used for a record in an extension. It refers to a table called `tx_myext_table` and the field `myfield`. Here the marker will be substituted by the given value. .. index:: Records; field configuration .. _pageTsConfigTceFormConfig: config ------ :aspect:`Datatype` string / array :aspect:`Description` This setting allows to override TCA field configuration. This will influence configuration settings in :php:`$GLOBALS['TCA'][]['columns'][]['config'][]`, see :ref:`TCA reference ` for details. Not all configuration options can be overriden, the properties are restricted and depend on the :ref:`field type `. The array :code:`typo3/sysext/backend/Classes/Form/Utility/FormEngineUtility.php->$allowOverrideMatrix` within :ref:`FormEngine code ` defines details: .. code-block:: php 'input' => ['size', 'max', 'readOnly'], 'number' => ['size', 'readOnly'], 'email' => ['size', 'readOnly'], 'link' => ['size', 'readOnly'], 'password' => ['size', 'readOnly'], 'datetime' => ['size', 'readOnly'], 'color' => ['size', 'readOnly'], 'uuid' => ['size', 'enableCopyToClipboard'], 'text' => ['cols', 'rows', 'wrap', 'max', 'readOnly'], 'json' => ['cols', 'rows', 'readOnly'], 'check' => ['cols', 'readOnly'], 'select' => ['size', 'autoSizeMax', 'maxitems', 'minitems', 'readOnly', 'treeConfig', 'fileFolderConfig'], 'category' => ['size', 'maxitems', 'minitems', 'readOnly', 'treeConfig'], 'group' => ['size', 'autoSizeMax', 'maxitems', 'minitems', 'readOnly', 'elementBrowserEntryPoints'], 'folder' => ['size', 'autoSizeMax', 'maxitems', 'minitems', 'readOnly', 'elementBrowserEntryPoints'], 'inline' => ['appearance', 'behaviour', 'foreign_label', 'foreign_selector', 'foreign_unique', 'maxitems', 'minitems', 'size', 'autoSizeMax', 'symmetric_label', 'readOnly'], 'file' => ['appearance', 'behaviour', 'maxitems', 'minitems', 'readOnly'], 'imageManipulation' => ['ratios', 'cropVariants'], This property is available for various levels: table level, example: :typoscript:`TCEFORM.tt_content.header.config.max` table and record type level, example: :typoscript:`TCEFORM.tt_content.header.types.textpic.config.max` Flex form field level, example: :typoscript:`TCEFORM.tt_content.pi_flexform.myext_pi1.sDEF.myInputField.config.max` Where :typoscript:`sDEF` is the sheet name. .. index:: Records; tree configuration .. _pageTsConfigTceFormConfigTreeConfig: config.treeConfig ----------------- :aspect:`Datatype` int :aspect:`Description` The `treeConfig` sub properties of :ref:`TCEFORM.config ` are dedicated to the TCA config type `select` with :ref:`renderType=selectTree `. A couple of :ref:`treeConfig ` properties can be overriden on page TSconfig level, see their detailed description in the :ref:`TCA reference `: .. code-block:: typoscript :caption: EXT:site_package/Configuration/page.tsconfig config.treeConfig.startingPoints = 1,42 config.treeConfig.appearance.expandAll = 1 config.treeConfig.appearance.maxLevels = 2 config.treeConfig.appearance.nonSelectableLevels = 1 This property is available for various levels: table level, example: `TCEFORM.tt_content.myField.config.treeConfig.startingPoints` table and record type level, example: `TCEFORM.tt_content.header.types.config.treeConfig.startingPoints` Flex form field level, example: `TCEFORM.tt_content.pi_flexform.myext_pi1.sDEF.settings\.myfield.config.treeConfig.startingPoints` Where `sDEF` is the sheet name. For a description see the section :ref:`tceformApplyPropertiesFlexForm` on this page. .. index:: Records; field description description ----------- .. include:: /Images/AutomaticScreenshots/Input1.rst.txt :aspect:`Datatype` string :aspect:`Description` This property sets or overrides the TCA property :ref:`TCA description `, which allows to define a description for a TCA field, next to its label. .. code-block:: typoscript :caption: EXT:site_package/Configuration/page.tsconfig TCEFORM.tt_content.header.description = override description As already known from other properties, this can also be configured for a specific language. .. code-block:: typoscript :caption: EXT:site_package/Configuration/page.tsconfig TCEFORM.tt_content.header.description.de = override description for DE The option can be used on a per record type basis, too. .. code-block:: typoscript :caption: EXT:site_package/Configuration/page.tsconfig TCEFORM.tt_content.header.types.textpic.description = override description for textpic Also referencing language labels is supported. .. code-block:: typoscript :caption: EXT:site_package/Configuration/page.tsconfig TCEFORM.tt_content.header.description = LLL:EXT:my_ext/Resources/Private/Language/locallang.xlf:override_description .. index:: Records; field disabled disabled -------- :aspect:`Datatype` boolean :aspect:`Description` If set, the field is not displayed in the backend form of the record. However, the field can still be set by other means. For example if this property is set: :typoscript:`TCEFORM.tt_content.colPos.disabled = 1` the :guilabel:`Column` field will not be displayed in the content elements form. The content element can still be moved to another column which internally also sets the field :sql:`colPos`. Fields with the TSconfig property :tsconfig:`TCEFORM...disable` therefore show the same behaviour as fields of the TCA type :ref:`passthrough `. table level, example: `TCEFORM.tt_content.header.disabled` table and record type level, example: `TCEFORM.tt_content.header.types.textpic.disabled` Flex form sheet level. If set, the entire tab is not rendered, example: `TCEFORM.tt_content.pi_flexform.myext_pi1.sDEF.disabled` Where `sDEF` is the sheet name. For a description see the section :ref:`tceformApplyPropertiesFlexForm` on this page. Flex form field level, example: `TCEFORM.tt_content.pi_flexform.myext_pi1.sDEF.settings\.myfield.disabled` Where `sDEF` is the sheet name. For a description see the section :ref:`tceformApplyPropertiesFlexForm` on this page. :aspect:`Example` .. code-block:: typoscript :caption: EXT:site_package/Configuration/page.tsconfig TCEFORM.pages.title { # The title field of the pages table is not editable disabled = 1 } .. index:: Records; select items disable "INVALID VALUE" .. _pageFormEngineDisableNoMatchingElement: disableNoMatchingValueElement ----------------------------- :aspect:`Datatype` boolean :aspect:`Description` This property applies only to items in :ref:`TCA type=select ` fields. If a selector box value is not available among the options in the box, the default behavior of TYPO3 is to preserve the value and to show a label which warns about this special state: .. figure:: /Images/ManualScreenshots/List/SelectInvalidValue.png :alt: A missing selector box value is indicated by a warning message A missing selector box value is indicated by a warning message If disableNoMatchingValueElement is set, the element "INVALID VALUE" will not be added to the list. This property is available for various levels: table level, example: `TCEFORM.tt_content.header_layout.disableNoMatchingValueElement` table and record type level, example: `TCEFORM.tt_content.header_layout.types.textpic.disableNoMatchingValueElement` Flex form field level, example: `TCEFORM.tt_content.pi_flexform.myext_pi1.sDEF.settings\.myfield.disableNoMatchingValueElement` Where `sDEF` is the sheet name. For a description see the section :ref:`tceformApplyPropertiesFlexForm` on this page. :aspect:`Example` .. code-block:: typoscript :caption: EXT:site_package/Configuration/page.tsconfig TCEFORM.pages.doktype { # "INVALID VALUE ..." label will never show up disableNoMatchingValueElement = 1 } Now the selector box will default to the first element in the selector box: .. figure:: /Images/ManualScreenshots/List/SelectNoInvalidValue.png :alt: Instead of show a warning message the system choose the first element in the selector box Instead of show a warning message the system choose the first element in the selector box .. index:: Records; fileFolderConfig .. _fileFolderConfig: fileFolderConfig ---------------- :aspect:`Datatype` array :aspect:`Description` The special :ref:`fileFolder configuration options ` for TCA columns of type :ref:`TCA type=select ` can be used to fill a select field with files (images / icons) from a defined folder. The `fileFolderConfig` TCA configuration can be overridden with page TSconfig, allowing administrators to use different folders or different file extensions, per site. The same sub properties as in the `fileFolderConfig` TCA configuration are available: .. code-block:: typoscript :caption: EXT:site_package/Configuration/page.tsconfig fileFolderConfig { folder = 'EXT:styleguide/Resources/Public/Icons' allowedExtensions = 'svg' depth = 1 } This property is available for various levels: table level: `TCEFORM.[tableName].[fieldName].fileFolderConfig.folder` table and record type level: `TCEFORM.[tableName].[fieldName].types.[typeName].fileFolderConfig.folder` Flex form field level, example: `TCEFORM.tt_content.pi_flexform.myext_pi1.sDEF.settings\.myfield.fileFolderConfig.folder` Where `sDEF` is the sheet name. For a description see the section :ref:`tceformApplyPropertiesFlexForm` on this page. .. index:: Records; select items user function .. _itemsProcFunc: itemsProcFunc ------------- :aspect:`Datatype` custom :aspect:`Description` This property applies only to items in :ref:`TCA type=select ` fields. The properties of this key is passed on to the :ref:`itemsProcFunc ` in the parameter array by the key "TSconfig". This property is available for various levels: table level: `TCEFORM.[tableName].[fieldName].itemsProcFunc` table and record type level: `TCEFORM.[tableName].[fieldName].types.[typeName].itemsProcFunc` Flex form field level, example: `TCEFORM.tt_content.pi_flexform.myext_pi1.sDEF.settings\.myfield.itemsProcFunc` Where `sDEF` is the sheet name. For a description see the section :ref:`tceformApplyPropertiesFlexForm` on this page. .. index:: Records; select items remove keepItems --------- :aspect:`Datatype` list of values :aspect:`Description` Change the list of items in :ref:`TCA type=select ` fields. Using this property, all items except those defined here are removed. This property is available for various levels: table level, example: `TCEFORM.tt_content.header_layout.keepItems` table and record type level, example: `TCEFORM.tt_content.header_layout.types.textpic.keepItems` Flex form field level, example: `TCEFORM.tt_content.pi_flexform.myext_pi1.sDEF.settings\.myfield.keepItems` Where `sDEF` is the sheet name. For a description see the section :ref:`tceformApplyPropertiesFlexForm` on this page. :aspect:`Example` .. code-block:: typoscript :caption: EXT:site_package/Configuration/page.tsconfig TCEFORM.pages.doktype { # Show only standard and "Spacer" page types keepItems = 1, 199 } .. index:: Records; Field label .. _tceform_label: label ----- :aspect:`Datatype` localized string :aspect:`Description` This allows you to enter alternative labels for any field. The value can be a `LLL:` reference to a localization file, the system will then look up the selected backend user language and tries to fetch the localized string if available. However, it is also possible to override these by appending the language key and hard setting a value, for example `label.de = Neuer Feldname`. This property is available for various levels: table level, example: `TCEFORM.[tableName].[fieldName].label` table and record type level, example: `TCEFORM.[tableName].[fieldName].types.[typeName].label` Flex form field level, example: `TCEFORM.tt_content.pi_flexform.myext_pi1.sDEF.settings\.myfield.label` Where `sDEF` is the sheet name. For a description see the section :ref:`tceformApplyPropertiesFlexForm` on this page. :aspect:`Example` .. code-block:: typoscript :caption: EXT:site_package/Configuration/page.tsconfig TCEFORM.pages.title { label = LLL:EXT:my_ext/Resources/Private/Language/locallang.xlf:table.column label.default = New Label label.de = Neuer Feldname } .. index:: Records; label for no matching value noMatchingValue_label --------------------- :aspect:`Datatype` localized string :aspect:`Description` This property applies only to items in :ref:`TCA type=select ` fields, it allows defining a different label of the :ref:`noMatchingValue ` element. It is possible to use the placeholder `%s` to insert the value. If the property is set to empty, the label will be blank. This property is available for various levels: table level, example: `TCEFORM.tt_content.header_layout.noMatchingValue_label` table and record type level, example: `TCEFORM.tt_content.header_layout.types.textpic.noMatchingValue_label` Flex form field level, example: `TCEFORM.tt_content.pi_flexform.myext_pi1.sDEF.settings\.myfield.noMatchingValue_label` Where `sDEF` is the sheet name. For a description see the section :ref:`tceformApplyPropertiesFlexForm` on this page. :aspect:`Example` .. code-block:: typoscript :caption: EXT:site_package/Configuration/page.tsconfig TCEFORM.pages.doktype { # Different "INVALID VALUE ..." label: noMatchingValue_label = VALUE "%s" was not available! } .. figure:: /Images/ManualScreenshots/List/SelectInvalidValueDifferentLabel.png :alt: An invalid selector box value is indicated by a warning message An invalid selector box value is indicated by a warning message .. index:: Records; select items remove removeItems ----------- :aspect:`Datatype` list of values :aspect:`Description` Change the list of items in :ref:`TCA type=select ` fields. Using this property, single items can be removed, leaving all others. This property is available for various levels: table level, example: `TCEFORM.tt_content.header_layout.removeItems` table and record type level, example: `TCEFORM.tt_content.header_layout.types.textpic.removeItems` Flex form field level, example: `TCEFORM.tt_content.pi_flexform.myext_pi1.sDEF.settings\.myfield.removeItems` Where `sDEF` is the sheet name. For a description see the section :ref:`tceformApplyPropertiesFlexForm` on this page. :aspect:`Example` .. code-block:: typoscript :caption: EXT:site_package/Configuration/page.tsconfig TCEFORM.pages.doktype { # Remove "Recycler" and "Spacer" page types removeItems = 199, 255 } .. index:: FlexForm; Sheet description sheetDescription ---------------- :aspect:`Datatype` localized string :aspect:`Description` Specifies a description for the sheet shown in the FlexForm. This property is only available on flex form sheet level, example: `TCEFORM.tt_content.pi_flexform.myext_pi1.sDEF.sheetDescription` Where `sDEF` is the sheet name. For a description see the section :ref:`tceformApplyPropertiesFlexForm` on this page. .. index:: FlexForm; Sheet short description sheetShortDescr --------------- :aspect:`Datatype` localized string :aspect:`Description` Specifies a short description of the sheet used as link title in the tab-menu. This property is only available on flex form sheet level, example: `TCEFORM.tt_content.pi_flexform.myext_pi1.sDEF.sheetShortDescription` Where `sDEF` is the sheet name. For a description see the section :ref:`tceformApplyPropertiesFlexForm` on this page. .. index:: FlexForm; Sheet title sheetTitle ---------- :aspect:`Datatype` localized string :aspect:`Description` Set the title of the sheet / tab in a FlexForm configuration. This property is only available on flex form sheet level, example: `TCEFORM.tt_content.pi_flexform.myext_pi1.sDEF.sheetTitle` Where `sDEF` is the sheet name. For a description see the section :ref:`tceformApplyPropertiesFlexForm` on this page. :aspect:`Example` .. code-block:: typoscript :caption: EXT:site_package/Configuration/page.tsconfig TCEFORM.tt_content.pi_flexform.myext_pi1.sDEF { # Rename the first tab of the FlexForm plug-in configuration sheetTitle = LLL:my_ext/Resource/Private/Language/locallang.xlf:tt_content.pi_flexform.myext_pi1.sDEF } .. index:: Records; Suggest wizard Suggest wizard .. _pagetceformsuggest: suggest ------- Configuration of the suggest wizard that is available and often enabled for :ref:`TCA type=group ` fields. .. figure:: /Images/ManualScreenshots/List/TcaTypeGroupSuggest.png :alt: A configured suggest wizard A configured suggest wizard The properties listed below are available on various levels. A more specific setting overrides a less specific one: Configuration of all suggest wizards in all tables for all target query tables: `TCEFORM.suggest.default` Configuration of all suggest wizards in all tables looking up records from a specific target table: `TCEFORM.suggest.[queryTable]` Configuration of one suggest wizard field in one table for all target query tables: `TCEFORM.[tableName].[fieldName].suggest.default` Configuration of one suggest wizard field in one table for a specific target query table: `TCEFORM.[tableName].[fieldName].suggest.[queryTable]` Configuration of one suggest wizard field in a flex form field of one table for all target query tables: `TCEFORM.[tableName].[fieldName].[dataStructureKey].[sheetName].[flexFieldName].suggest.default` Configuration of one suggest wizard field in a flex form field of one table for a specific target query table: `TCEFORM.[tableName].[fieldName].[dataStructureKey].[sheetName].[flexFieldName].suggest.[queryTable]` .. index:: Suggest wizard; Search fields additional additionalSearchFields ~~~~~~~~~~~~~~~~~~~~~~ :aspect:`Datatype` string :aspect:`Description` Comma-separated list of fields the suggest wizard should also search in. By default the wizard looks only in the fields listed in the :ref:`label ` and :ref:`label_alt ` of TCA :ref:`ctrl properties `. .. index:: Suggest wizard; Where statement addWhere ~~~~~~~~ :aspect:`Datatype` string :aspect:`Description` Additional WHERE clause (with AND at the beginning). Markers possible for replacement: * ###THIS_UID### * ###CURRENT_PID### * :ref:`###PAGE_TSCONFIG_ID### ` * :ref:`###PAGE_TSCONFIG_IDLIST### ` * :ref:`###PAGE_TSCONFIG_STR### ` :aspect:`Example` .. code-block:: typoscript :caption: EXT:site_package/Configuration/page.tsconfig TCEFORM.pages.storage_pid.suggest.default { addWhere = AND pages.pid=###PAGE_TSCONFIG_ID### } .. index:: Suggest wizard; CSS class cssClass ~~~~~~~~ :aspect:`Datatype` string :aspect:`Description` Add a CSS class to every list item of the result list. :aspect:`Example` .. code-block:: typoscript :caption: EXT:site_package/Configuration/page.tsconfig TCEFORM.suggest.pages { # Configure all suggest wizards which list records from table "pages" # to add the CSS class "pages" to every list item of the result list. cssClass = pages } .. index:: Suggest wizard; hide hide ~~~~ :aspect:`Datatype` boolean :aspect:`Description` Hide the suggest field. Works only for single fields. :aspect:`Example` .. code-block:: typoscript :caption: EXT:site_package/Configuration/page.tsconfig TCEFORM.pages.storage_pid.suggest.default { hide = 1 } .. index:: Suggest wizard; Characters max maxPathTitleLength ~~~~~~~~~~~~~~~~~~ :aspect:`Datatype` positive integer :aspect:`Description` Maximum number of characters to display when a path element is too long. :aspect:`Example` .. code-block:: typoscript :caption: EXT:site_package/Configuration/page.tsconfig TCEFORM.suggest.default { maxPathTitleLength = 30 } .. index:: Suggest wizard; Characters min minimumCharacters ~~~~~~~~~~~~~~~~~ :aspect:`Datatype` positive integer :aspect:`Description` Minimum number of characters needed to start the search. Works only for single fields. :aspect:`Default` 2 :aspect:`Example` .. code-block:: typoscript :caption: EXT:site_package/Configuration/page.tsconfig TCEFORM.pages.storage_pid.suggest.default { minimumCharacters = 3 } .. index:: Suggest wizard; pid levels pidDepth ~~~~~~~~ :aspect:`Datatype` positive integer :aspect:`Description` Expand pidList by this number of levels. Only has an effect, if pidList has a value. :aspect:`Example` .. code-block:: typoscript :caption: EXT:site_package/Configuration/page.tsconfig TCEFORM.suggest.default { pidList = 6,7 pidDepth = 4 } .. index:: Suggest wizard; pid list pidList ~~~~~~~ :aspect:`Datatype` list of values :aspect:`Description` Limit the search to certain pages (and their subpages). When pidList is empty all pages will be included in the search as long as the backend user is allowed to see them. :aspect:`Example` .. code-block:: typoscript :caption: EXT:site_package/Configuration/page.tsconfig TCEFORM.suggest.default { # sets the pidList for a suggest fields in all tables pidList = 1,2,3,45 } .. index:: Suggest wizard; receiver php class receiverClass ~~~~~~~~~~~~~ :aspect:`Datatype` PHP class name :aspect:`Description` PHP class alternative receiver class - the file that holds the class should be derived from :code:`\TYPO3\CMS\Backend\Form\Element\SuggestDefaultReceiver`. :aspect:`Default` :php:`\TYPO3\CMS\Backend\Form\Element\SuggestDefaultReceiver` .. index:: Suggest wizard; rendering user function renderFunc ~~~~~~~~~~ :aspect:`Datatype` string :aspect:`Description` User function to manipulate the displayed records in the result. .. index:: Suggest wizard; Where statement searchCondition ~~~~~~~~~~~~~~~ :aspect:`Datatype` string :aspect:`Description` Additional WHERE clause (no AND needed to prepend). :aspect:`Example` .. code-block:: typoscript :caption: EXT:site_package/Configuration/page.tsconfig TCEFORM.pages.storage_pid.suggest.default { # Configure the suggest wizard for the field "storage_pid" in table "pages" # to search only for pages with doktype=1 searchCondition = doktype=1 } .. index:: Suggest wizard; Search whole phrase searchWholePhrase ~~~~~~~~~~~~~~~~~ :aspect:`Datatype` boolean :aspect:`Description` Whether to do a `LIKE=%mystring%` (searchWholePhrase = 1) or a `LIKE=mystring%` (to do a real find as you type). :aspect:`Default` 0 :aspect:`Example` .. code-block:: typoscript :caption: EXT:site_package/Configuration/page.tsconfig TCEFORM.pages.storage_pid.suggest.default { # Configure the suggest wizard for the field "storage_pid" in table "pages" to search only for whole phrases searchWholePhrase = 1 }