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 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].[propertyName] to configure a field for a specific type, see the 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.

Applying properties to FlexForm fields

Other properties also apply to FlexForm fields, in this case the full property path including the data structure key has to be set:

# 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 $GLOBALS['TCA'][<tableName>]['columns'][<field>]['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 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

addItems

addItems

Type: localized string

Change the list of items in 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 icon will allow to add your own icons to new values.

New in version 12.1

The subkey 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 Applying properties to FlexForm fields 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 Core APIs for details.

Example: Add header layout option

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.

altLabels

altLabels

Type: localized string

This property applies to TCA type=select, TCA type=check and 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 Applying properties to FlexForm fields on this page.

Example: Override labels for document types

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
}

Note

If the item has an empty value, the syntax is slightly different and an additional dot must be provided, like on this example:

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

Type: integer

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 foreign_table_where and for the addWhere part of the suggest wizard.

Example: Substitute a marker in a plugin FlexForm

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.

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

Type: list of integers

See above.

Example: Substitute a list of IDs in a plugin FlexForm

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.

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

Type: string

See above.

Example: Substitute a string in a plugin FlexForm

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.

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.

config

config

This setting allows to override TCA field configuration. This will influence configuration settings in $GLOBALS['TCA'][<tableName>]['columns'][<fieldName>]['config'][<key>], see TCA reference for details.

Not all configuration options can be overridden, the properties are restricted and depend on the field type. The array typo3/sysext/backend/Classes/Form/Utility/FormEngineUtility.php->$allowOverrideMatrix within FormEngine code defines details:

'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'],

The reason that not all properties can be changed is that internally, the DataHandler performs database operations which require finalized TCA definitions that are accessed without this TSconfig getting interpreted. This mismatch would then lead to inconsistencies.

An input or text TCA field can not enable the RTE via the config.enableRichtext option due to similar reasons in respect to the DataHandler.

Also, if for example the max definition of a field is made larger than the TCA definition of that field, you may need to to change the file ext_tables.sql (see ext_tables.sql) to adjust column definitions, especially when using the Auto-generated structure.

The property config is available for these levels:

table level, example:: TCEFORM.tt_content.header.config.max
table and record type level, example:: TCEFORM.tt_content.header.types.textpic.config.max
Flex form field level, example:: No current TYPO3 version allows to override the configuration of Flex form fields, even though this was previously documented here. This may change in future versions.

config.treeConfig

config.treeConfig

Type: int

The treeConfig sub properties of TCEFORM.config are dedicated to the TCA config type select with renderType=selectTree. A couple of treeConfig properties can be overriden on page TSconfig level, see their detailed description in the TCA reference:

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:: No current TYPO3 version allows to override the configuration of Flex form fields, even though this was previously documented here. This may change in future versions.

description

description

Type: string

This property sets or overrides the TCA property TCA description, which allows to define a description for a TCA field, next to its label.

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.

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.

EXT:site_package/Configuration/page.tsconfig

TCEFORM.tt_content.header.types.textpic.description = override description for textpic

Also referencing language labels is supported.

EXT:site_package/Configuration/page.tsconfig

TCEFORM.tt_content.header.description = LLL:EXT:my_ext/Resources/Private/Language/locallang.xlf:override_description

disabled

disabled

Type: boolean

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: TCEFORM.tt_content.colPos.disabled = 1 the 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 colPos. Fields with the TSconfig property TCEFORM.<table>.<field>.disabled therefore show the same behaviour as fields of the TCA type 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 Applying properties to FlexForm fields 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 Applying properties to FlexForm fields on this page.

Example: Disable editing of the page title

EXT:site_package/Configuration/page.tsconfig

TCEFORM.pages.title {
    # The title field of the pages table is not editable
    disabled = 1
}

disableNoMatchingValueElement

disableNoMatchingValueElement

Type: boolean

This property applies only to items in 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:

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 Applying properties to FlexForm fields on this page.

Example: Disable "INVALID VALUE ..." label

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:

Instead of show a warning message the system choose the first element in the selector box

fileFolderConfig

fileFolderConfig

Type: array

The special fileFolder configuration options for TCA columns of type 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:

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 Applying properties to FlexForm fields on this page.

itemsProcFunc

itemsProcFunc

Type: custom

This property applies only to items in TCA type=select fields. The properties of this key is passed on to the 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 Applying properties to FlexForm fields on this page.

keepItems

keepItems

Type: list of values

Change the list of items in 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 Applying properties to FlexForm fields on this page.

Example: Show only standard and spacer pages

EXT:site_package/Configuration/page.tsconfig

TCEFORM.pages.doktype {
    # Show only standard and "Spacer" page types
    keepItems = 1, 199
}

label

label

Type: localized string

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 Applying properties to FlexForm fields on this page.

Example: Override the label of a field

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
}

noMatchingValue_label

noMatchingValue_label

Type: localized string

This property applies only to items in TCA type=select fields, it allows defining a different label of the 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 Applying properties to FlexForm fields on this page.

Example: Replace "INVALID VALUE ..." label with another string

EXT:site_package/Configuration/page.tsconfig

TCEFORM.pages.doktype {
    # Different "INVALID VALUE ..." label:
    noMatchingValue_label = VALUE "%s" was not available!
}

An invalid selector box value is indicated by a warning message

removeItems

removeItems

Type: list of values

Change the list of items in 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 Applying properties to FlexForm fields on this page.

Example: Remove "Recycler" and "Spacer" page types

EXT:site_package/Configuration/page.tsconfig

TCEFORM.pages.doktype {
    # Remove "Recycler" and "Spacer" page types
    removeItems = 199, 255
}

sheetDescription

sheetDescription

Type: localized string

Specifies a description for the sheet shown in the FlexForm.

This property is only available on flex form sheet level, for example TCEFORM.tt_content.pi_flexform.myext_pi1.sDEF.sheetDescription.

Where sDEF is the sheet name. For a description see the section Applying properties to FlexForm fields on this page.

sheetShortDescr

sheetShortDescr

Type: localized string

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 Applying properties to FlexForm fields on this page.

sheetTitle

sheetTitle

Type: localized string

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 Applying properties to FlexForm fields on this page.

Example: Rename the first tab of the FlexForm plugin

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
}

suggest

Configuration of the suggest wizard that is available and often enabled for TCA type=group fields.

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]

suggest.additionalSearchFields

suggest.additionalSearchFields

Type: string

Comma-separated list of fields the suggest wizard should also search in. By default the wizard looks only in the fields listed in the label and label_alt of TCA ctrl properties.

suggest.addWhere

suggest.addWhere

Type: string

Additional WHERE clause (with AND at the beginning).

Markers possible for replacement:

###THIS_UID###
###CURRENT_PID###
###PAGE_TSCONFIG_ID###
###PAGE_TSCONFIG_IDLIST###
###PAGE_TSCONFIG_STR###

Example: limit storage_pid to the children of a certain page

EXT:site_package/Configuration/page.tsconfig

TCEFORM.pages.storage_pid.suggest.default {
    addWhere = AND pages.pid=###PAGE_TSCONFIG_ID###
}

suggest.cssClass

suggest.cssClass

Type: string

Add a CSS class to every list item of the result list.

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
}

suggest.hide

suggest.hide

Type: boolean

Hide the suggest field. Works only for single fields.

Example: Hide the suggest field for the storage_pid

EXT:site_package/Configuration/page.tsconfig

TCEFORM.pages.storage_pid.suggest.default {
    hide = 1
}

suggest.maxPathTitleLength

suggest.maxPathTitleLength

Type: positive integer

Maximum number of characters to display when a path element is too long.

Example: Limit the suggest field to 30 characters

EXT:site_package/Configuration/page.tsconfig

TCEFORM.suggest.default {
    maxPathTitleLength = 30
}

suggest.minimumCharacters

suggest.minimumCharacters

Type: positive integer
Default: 2

Minimum number of characters needed to start the search. Works only for single fields.

Example: Start the suggest search after 3 characters

EXT:site_package/Configuration/page.tsconfig

TCEFORM.pages.storage_pid.suggest.default {
    minimumCharacters = 3
}

suggest.pidDepth

suggest.pidDepth

Type: positive integer

Expand pidList by this number of levels. Only has an effect, if pidList has a value.

Example: Set search depth for suggest field

EXT:site_package/Configuration/page.tsconfig

TCEFORM.suggest.default {
    pidList = 6,7
    pidDepth = 4
}

suggest.pidList

suggest.pidList

Type: list of values

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.

Example: Limit suggest search to records on certain pages

EXT:site_package/Configuration/page.tsconfig

TCEFORM.suggest.default {
    # sets the pidList for a suggest fields in all tables
    pidList = 1,2,3,45
}

suggest.receiverClass

suggest.receiverClass

Type: Fully Qualified PHP class name
Default: \TYPO3\CMS\Backend\Form\Element\SuggestDefaultReceiver

PHP class alternative receiver class - the file that holds the class should be derived from \TYPO3\CMS\Backend\Form\Element\SuggestDefaultReceiver.

suggest.renderFunc

suggest.renderFunc

Type: string

User function to manipulate the displayed records in the result.

suggest.searchCondition

suggest.searchCondition

Type: string

Additional WHERE clause (no AND needed to prepend).

Example: Only search on pages with doktype=1

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
}

suggest.searchWholePhrase

suggest.searchWholePhrase

Type: boolean
Default: 0

Whether to do a LIKE=%mystring% (searchWholePhrase = 1) or a LIKE=mystring% (to do a real find as you type).

Example: Search only for whole phrases

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
}