web_list

Configuration options of the "Web > List" module.

allowedNewTables

allowedNewTables

allowedNewTables
Type
list of table names

If this list is set, then only tables listed here will have a link to "create new" in the page and sub pages. This also affects the "Create new record" content element wizard.

This is the opposite of deniedNewTables property.

Example: Only allow records of type pages or sys_category in the new record wizard

EXT:site_package/Configuration/page.tsconfig
mod.web_list {
    # Only pages and sys_category table elements will be linked to in the new record wizard
    allowedNewTables = pages, sys_category
}
Copied!
The New record screen after modifying the allowed elements

The New record screen after modifying the allowed elements

clickTitleMode

clickTitleMode

clickTitleMode
Type
string
Default
edit

Keyword which defines what happens when a user clicks a record title in the list.

The following values are possible:

edit
Edits record
info
Shows information
show
Shows page in the frontend

csvDelimiter

csvDelimiter

csvDelimiter
Type
string
Default
,

Defines the default delimiter for CSV downloads (Microsoft Excel expects ; to be set). The value set will be displayed as default delimiter in the download dialog in the list module.

Example: Use semicolon as delimiter CSV downloads

EXT:examples/Configuration/TsConfig/Page/Mod/csvExport.tsconfig
mod.web_list {
   csvDelimiter = ;
   csvQuote = '
}
Copied!

csvQuote

csvQuote

csvQuote
Type
string
Default
"

Defines the default quoting character for CSV downloads. The value set will be displayed as default quoting in the download dialog in the list module.

Example: Use single quotes as quoting character for CSV downloads

EXT:examples/Configuration/TsConfig/Page/Mod/csvExport.tsconfig
mod.web_list {
   csvDelimiter = ;
   csvQuote = '
}
Copied!

deniedNewTables

deniedNewTables

deniedNewTables
Type
list of table names

If this list is set, then the tables listed here won't have a link to "create new record" in the page and sub pages. This also affects the "Create new record" content element wizard.

This is the opposite of allowedNewTables property.

If allowedNewTables and deniedNewTables contain a common subset, deniedNewTables takes precedence.

disableSingleTableView

disableSingleTableView

disableSingleTableView
Type
boolean

If set, then the links on the table titles which shows a single table listing will not be available - including sorting links on columns titles, because these links jumps to the table-only view.

displayColumnSelector

displayColumnSelector

displayColumnSelector
Type
boolean
Default
true

The column selector is enabled by default and can be disabled with this option. The column selector is displayed at the top of each record list in the List module. It can be used to compare different fields of the listed records.

Example: Hide the column selector

EXT:site_package/Configuration/page.tsconfig
mod.web_list.displayColumnSelector = 0
Copied!

downloadPresets

downloadPresets.[table]

downloadPresets.[table]
Type
array of presets

New in version 13.2

A new function has been introduced that makes it possible to select the data columns to be exported from a list of configurable presets.

This property adds presets of preselected fields to the download area in the Web > List backend module.

Those presets can be configured via page TSconfig, and can also be overridden via user TSconfig (for example, to expand certain presets only to specific users).

Each entry of mod.web_list.downloadPresets defines the table name on the first level, followed by any number of presets.

Each preset contains a label (the displayed name of the preset, which can be a locallang key), a comma-separated list of each column that should be included in the export as columns and optionally an identifier. In case identifier is not provided, the identifier is generated as hash of the label and columns.

Since any table can be configured for a preset, any extension can deliver a defined set of presets through the EXT:my_extension/Configuration/page.tsconfig file and their table name(s).

Additionally, the list of presets can be manipulated via the PSR-14 event TYPO3CMSBackendRecordListEventBeforeRecordDownloadPresetsAreDisplayedEvent.

Example: Create download presets for table page

EXT:my_extension/Configuration/page.tsconfig
mod.web_list.downloadPresets {
    pages {
        minimum {
            label = Quick overview
            columns = uid, title, crdate, slug
        }

        fullExport {
            identifier = uid-title
            label = LLL:EXT:myext/Resources/Private/Language/locallang.xlf:preset2.label
            columns = uid, title
        }
    }
}
Copied!

This can be manipulated with user TSconfig by adding the page. prefix. User TSconfig is loaded after page TSconfig, so you can overwrite the existing default settings using the same TypoScript path.

EXT:my_extension/Configuration/user.tsconfig
mod.web_list.downloadPresets {
    pages {
        minimum {
            label = Quick overview
            columns = uid, title, crdate, slug
        }

        fullExport {
            identifier = uid-title
            label = LLL:EXT:myext/Resources/Private/Language/locallang.xlf:preset2.label
            columns = uid, title
        }
    }
}
Copied!

enableClipBoard

enableClipBoard

enableClipBoard
Type
list of keywords
Default
selectable

Determines whether the checkbox "Show clipboard" in the list module is shown or hidden. If it is hidden, you can predefine it to be always activated or always deactivated.

The following values are possible:

activated
The option is activated and the checkbox is hidden.
deactivated
The option is deactivated and the checkbox is hidden.
selectable
The checkbox is shown so that the option can be selected by the user.

enableDisplayBigControlPanel

Changed in version 11.3

The checkbox Extended view was removed with TYPO3 v11.3. Therefore the option mod.web_list.enableDisplayBigControlPanel has no effect anymore.

hideTables

hideTables

hideTables
Type
list of table names, or *

Hide these tables in record listings (comma-separated)

If * is used, all tables will be hidden

hideTranslations

hideTranslations

hideTranslations
Type
list of table names, or *

For tables in this list all their translated records in additional website languages will be hidden in the List module.

Use * to hide all records of additional website languages in all tables or set single table names as comma-separated list.

Example: Hide all translated records

EXT:site_package/Configuration/page.tsconfig
mod.web_list.hideTranslations = *
Copied!

Example: Hide translated records in tables tt_content and tt_news

EXT:site_package/Configuration/page.tsconfig
mod.web_list.hideTranslations = tt_content, tt_news
Copied!

itemsLimitPerTable

itemsLimitPerTable

itemsLimitPerTable
Type
positive integer
Default
20 Set the default maximum number of items to show per table. The number must be between 0 and 10000`. If below or above this range, the nearest valid number will be used.

If a value is defined in the $TCA[<table>]['interface']['maxDBListItems'] of the table, it will override this TSconfig option. For example, the maxDBListItems for the pages table is 30 by default.

Example: Limit items per table in overview to 10

EXT:site_package/Configuration/page.tsconfig
mod.web_list {
    itemsLimitPerTable = 10
}
Copied!

itemsLimitSingleTable

itemsLimitSingleTable

itemsLimitSingleTable
Type
positive integer
Default
100

Set the default maximum number of items to show in single table view. The number must be between 0 and 10000. If below or above this range, the nearest valid number will be used.

If a value is defined in the $TCA[<table>]['interface']['maxSingleDBListItems'] of the table, it will override this TSconfig option. For example, the maxSingleDBListItems for the pages table is 50 by default.

Example: Limit items in single table view to 10

EXT:site_package/Configuration/page.tsconfig
mod.web_list {
    itemsLimitSingleTable = 10
}
Copied!

listOnlyInSingleTableView

listOnlyInSingleTableView

listOnlyInSingleTableView
Type
boolean
Default
0

If set, the default view will not show the single records inside a table anymore, but only the available tables and the number of records in these tables. The individual records will only be listed in the single table view, that means when a table has been clicked. This is very practical for pages containing many records from many tables!

Example: Only list records of tables in single-table mode

EXT:site_package/Configuration/page.tsconfig
mod.web_list {
    listOnlyInSingleTableView = 1
}

The result will be that records from tables are only listed in the single-table mode:
Copied!
The list module after activating the single-table mode

The list module after activating the single-table mode

newPageWizard.override

newPageWizard.override

newPageWizard.override
Type
string

If set to an extension key, then the specified module or route will be used for creating new elements on the page.

noViewWithDokTypes

noViewWithDokTypes

noViewWithDokTypes
Type
string (comma-separated list of integers)
Default
254,255

Hide view icon for the defined doktypes.

table.[tableName].hideTable

table.[tableName].hideTable

table.[tableName].hideTable
Type
boolean
Default
0

If set to non-zero, the table is hidden. If it is zero, table is shown even if table name is listed in "hideTables" list.

Example: Hide table tt_content

EXT:site_package/Configuration/page.tsconfig
mod.web_list.table.tt_content.hideTable = 1
Copied!

table.[tableName].displayColumnSelector

table.[tableName].displayColumnSelector

table.[tableName].displayColumnSelector
Type
boolean

If set to false, the column selector in the title row of the specified table gets hidden. If the column selctors have been disabled globally this option can be used to enable it for a specific table.

Example: Hide the column selector for tt_content

EXT:site_package/Configuration/page.tsconfig
mod.web_list.table.tt_content.displayColumnSelector = 0
Copied!

Example: Hide the column selector for all tables but sys_category

EXT:site_package/Configuration/page.tsconfig
mod.web_list.displayColumnSelector = 0
mod.web_list.table.sys_category.displayColumnSelector = 1
Copied!

tableDisplayOrder

tableDisplayOrder.[tableName]

tableDisplayOrder.[tableName]
Type
array

Flexible configuration of the order in which tables are displayed.

The keywords before and after can be used to specify an order relative to other table names.

mod.web_list.tableDisplayOrder.<tableName> {
    before = <tableA>, <tableB>, ...
    after = <tableA>, <tableB>, ...
}
Copied!

searchLevel.items

searchLevel.items

searchLevel.items
Type
array

Sets labels for each level label in the search level select box

EXT:site_package/Configuration/page.tsconfig
mod.web_list.searchLevel.items {
    -1 = EXT:core/Resources/Private/Language/locallang_core.xlf:labels.searchLevel.infinite
    0 = EXT:core/Resources/Private/Language/locallang_core.xlf:labels.searchLevel.0
    1 = EXT:core/Resources/Private/Language/locallang_core.xlf:labels.searchLevel.1
    2 = EXT:core/Resources/Private/Language/locallang_core.xlf:labels.searchLevel.2
    3 = EXT:core/Resources/Private/Language/locallang_core.xlf:labels.searchLevel.3
    4 = EXT:core/Resources/Private/Language/locallang_core.xlf:labels.searchLevel.4
}
Copied!

searchLevel.default

searchLevel.default

searchLevel.default
Type
integer

New in version 13.2

This option allows to define one of the available level options as the default level to use.

When searching for records in the Web > List module as well as the database browser, it is possible to select the search levels (page tree levels to respect in the search).

An editor is therefore able to select between the current page, a couple of defined levels (e.g. 1, 2, 3) as well as the special "infinite levels".

Those options can already be extended using the TSconfig option searchLevel.items.

Example: Set the default search level to "infinite levels"

EXT:my_sitepackage/Configuration/page.tsconfig
mod.web_list.searchLevel.default = -1
Copied!