RecordTypes
Folder: Content
name: example/my-record-type
table: tx_vendor_my_record_type
labelField: title
fields:
- identifier: title
type: Text
Learn more about Record Types.
Options
Here you can find all common root options.
| Name | Type | Default | Required |
|---|---|---|---|
| string | true | ||
| string | |||
| string|array | true | ||
| array | |||
| string | |||
| string |
automatically generated from
name
|
||
| boolean | true | ||
| boolean | true | ||
| boolean | true | ||
| array | true (for all sub properties) | ||
| boolean | true | ||
| boolean | true | ||
| boolean | true | ||
| boolean | true | ||
| string|array | |||
| boolean | false | ||
| string | onlyOnPages | ||
| array | |||
| boolean | false | ||
| boolean | false | ||
| boolean | false | ||
| string |
table
-
- Type
- string
- Required
true
The custom table name to be used for the new Record Type.
Warning
Avoid using dashes "-" inside your table names. They are not guaranteed to be escaped in the database. We recommend to always use snake case.
table: tx_vendor_my_custom_table_nameCopied!
group
-
- Type
- string
The group is used for the grouping of the record type selector in the edit view of records. By default records are not grouped.
Note
Grouping only makes sense, if you define multiple types for one
table. Otherwise, the record type selector is not displayed.Note
The group needs to be registered first, before you can use it here. See this guide on how to do it.
group: my_groupCopied!
labelField
-
- Type
- string|array
- Required
true
Defines which field should be used as the title of the record. If not defined, the first valid child field will be used as the label. It is possible to define an array of fields, which will be displayed comma-separated in the backend.
# a single field for the label labelField: title # multiple fields will be displayed comma-separated labelField: - title - textCopied!
fallbackLabelFields
-
- Type
- array
Defines which fields should be used as fallback, if
labelis not filled. The first filled field which is found will be used. Can only be used if there is only oneField labelfield defined.Field # fallback fields will be used, if title from labelField is empty labelField: title fallbackLabelFields: - text1 - text2Copied!
typeField
-
- Type
- string
The field identifier to use as the type switch. This field will be automatically generated and prepended as the very first field. The item list is filled automatically as well. There is no need to define this field manually in your fields list. Useful, if you want to define multiple types for a single table (single table inheritance).
typeField: typeCopied!
typeName
-
- Type
- string
- Default
- automatically generated from
name
The identifier of the new Record Type. It is automatically generated from the name, if not defined manually.
typeName: type1Copied!
languageAware
-
- Type
- boolean
- Default
- true
If set to
false, language related fields are not created. Namelysys_,language_ uid l10n_,parent l10n_andsource l10n_.diffsource # disable language support languageAware: falseCopied!
workspaceAware
-
- Type
- boolean
- Default
- true
Creates workspace related fields. Namely
t3ver_,oid t3ver_,wsid t3ver_andstate t3ver_. If EXT:workspaces is not installed, these fields won't be created.stage # disable workspaces support workspaceAware: falseCopied!
editLocking
-
- Type
- boolean
- Default
- true
If set to
false, the functionality to lock the editing for editors is removed. This refers to theeditlockfield.# disable edit lock field editLocking: falseCopied!
restriction
-
- Type
- array
- Default
- true (for all sub properties)
There are several restrictions in TYPO3, which filter records by certain constraints.
disabled- Adds a checkbox to hide the record in the frontend.
startTime - Adds a date picker to set the start time when to display the record.
endTime - Adds a date picker to set the end time when to stop displaying the record.
userGroup - Adds a selection to choose user groups, which are allowed to view the record.
restriction: disabled: false startTime: true endTime: true userGroup: falseCopied!
softDelete
-
- Type
- boolean
- Default
- true
When deleting records in the TYPO3 backend, they are not really deleted in the database. They are merely flagged as deleted. Disabling this option, removes this safety net.
# records will be really deleted in the backend softDelete: falseCopied!
trackCreationDate
-
- Type
- boolean
- Default
- true
Tracks the timestamp of the creation date. Disabling this option removes this information.
trackCreationDate: falseCopied!
trackUpdateDate
-
- Type
- boolean
- Default
- true
Tracks the timestamp of the last update. Disabling this option removes this information.
trackUpdateDate: falseCopied!
sortable
-
- Type
- boolean
- Default
- true
Tracks the order of records. Arrows will appear to sort records explicitly. Disabling this option removes this functionality. This corresponds to the TCA option
sortby.sortable: falseCopied!
sortField
-
- Type
- string|array
The field identifier to use for sorting records. If set, this will disable the
sortableoption automatically. This corresponds to the TCA optiondefault_. It is possible to define multiple sorting fields with an array.sortby # simple sort by one field in ascending order sortField: title # sorting by multiple fields with different orders sortField: - identifier: title order: desc - identifier: text order: ascCopied!
internalDescription
-
- Type
- boolean
- Default
- false
If enabled, this adds a new tab
Noteswith a description field. When filled with text, a record information will be displayed in the editing view. This corresponds with the TCA ctrl optiondescription. This field is supposed to be used only for the backend.Column internalDescription: trueCopied!
rootLevelType
-
- Type
- string
- Default
- onlyOnPages
Restricts the place, where the record can be created. Possible values are
only(default),On Pages onlyandOn Root Level both. This corresponds to the TCA ctrl optionroot.Level rootLevelType: 'onlyOnRootLevel'Copied!
security
-
- Type
- array
ignoreWeb Mount Restriction - default false, Allows users to access records that are not in their defined web-mount, thus bypassing this restriction.
ignoreRoot Level Restriction - default false, Allows non-admin users to access records that are on the root-level (page ID 0), thus bypassing this usual restriction.
ignorePage Type Restriction - default false (but true if table is used as
foreign_), Allows to use the record on any kind of page type.table
security: ignoreWebMountRestriction: true ignoreRootLevelRestriction: true ignorePageTypeRestriction: trueCopied!
readOnly
-
- Type
- boolean
- Default
- false
If enabled, the record can not be edited in the TYPO3 backend anymore.
readOnly: trueCopied!
adminOnly
-
- Type
- boolean
- Default
- false
If enabled, only admins can edit the record.
adminOnly: trueCopied!
hideAtCopy
-
- Type
- boolean
- Default
- false
If enabled, the record will be disabled, when copied. Only works, if
restriction.is set todisabled true.hideAtCopy: trueCopied!
appendLabelAtCopy
-
- Type
- string
If set, the label field
labelwill be appended with this string, when copied.Field appendLabelAtCopy: append meCopied!