.. include:: /Includes.rst.txt .. index:: mod; web_list Modules; List .. _pageweblist: ======== web_list ======== Configuration options of the "Web > List" module. .. contents:: :local: .. index:: allowedNewTables Buttons; Create new .. _pageTsConfigWebListAllowedNewTables: allowedNewTables ================ .. confval:: allowedNewTables :name: mod-web-list-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 :ref:`deniedNewTables property `. .. note:: Technically records can be created (e.g. by copying/moving), so this is not a security feature. The point is to reduce the number of options for new records visually. .. _pageTsConfigWebListAllowedNewTable-example: Example: Only allow records of type pages or sys_category in the new record wizard ---------------------------------------------------------------------------------- .. code-block:: typoscript :caption: 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 } .. figure:: /Images/ManualScreenshots/List/PageTsModWebListAllowedNewTables.png :alt: The New record screen after modifying the allowed elements The New record screen after modifying the allowed elements .. index:: clickTitleMode .. _pageTsConfigWebList-clickTitleMode: clickTitleMode ============== .. confval:: clickTitleMode :name: mod-web-list-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 .. index:: csvDelimiter CSV Exports; Delimiter .. _pageTsConfigWebList-csvDelimiter: csvDelimiter ============ .. confval:: csvDelimiter :name: mod-web-list-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 ------------------------------------------------- .. include:: /CodeSnippets/PageTSconfig/Mod/CsvExport.rst.txt .. include:: /Images/AutomaticScreenshots/WebList/ExportDialog.rst.txt .. index:: csvQuote CSV Downloads; Quoting character .. _pageTsConfigWebList-csvQuote: csvQuote ======== .. confval:: csvQuote :name: mod-web-list-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. .. _pageTsConfigWebList-csvQuote-example: Example: Use single quotes as quoting character for CSV downloads ----------------------------------------------------------------- .. include:: /CodeSnippets/PageTSconfig/Mod/CsvExport.rst.txt .. include:: /Images/AutomaticScreenshots/WebList/ExportDialog.rst.txt .. index:: deniedNewTables Buttons; Create new .. _pageTsConfigWebListDeniedNewTables: deniedNewTables =============== .. confval:: deniedNewTables :name: mod-web-list-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 :ref:`allowedNewTables property `. If `allowedNewTables` and `deniedNewTables` contain a common subset, `deniedNewTables` takes precedence. Hide "Create new record" links in tables sys_category and tt_content -------------------------------------------------------------------- .. code-block:: typoscript :caption: EXT:site_package/Configuration/page.tsconfig mod.web_list { deniedNewTables = sys_category, tt_content } .. index:: disableSingleTableView .. _pageTsConfigWebList-disableSingleTableView: disableSingleTableView ====================== .. confval:: disableSingleTableView :name: mod-web-list-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. .. index:: displayColumnSelector .. _pageTsConfigWebList-displayColumnSelector: displayColumnSelector ===================== .. confval:: displayColumnSelector :name: mod-web-list-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 :guilabel:`List` module. It can be used to compare different fields of the listed records. .. _pageTsConfigWebList-displayColumnSelector-example: Example: Hide the column selector --------------------------------- .. code-block:: typoscript :caption: EXT:site_package/Configuration/page.tsconfig mod.web_list.displayColumnSelector = 0 .. index:: enableClipBoard Buttons; Show clipboard Clipboard; Enable .. _pageTsConfigWebList-enableClipBoard: enableClipBoard =============== .. confval:: enableClipBoard :name: mod-web-list-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. .. index:: enableDisplayBigControlPanel List module; Extended view .. _pageTsConfigWebList-enableDisplayBigControlPanel: enableDisplayBigControlPanel ============================ .. versionchanged:: 11.3 The checkbox :guilabel:`Extended view` was removed with TYPO3 v11.3. Therefore the option :typoscript:`mod.web_list.enableDisplayBigControlPanel` has no effect anymore. .. index:: hideTables List module; Hide tables .. _pageTsConfigWebList-hideTables: hideTables ========== .. confval:: hideTables :name: mod-web-list-hideTables :type: list of table names, or * Hide these tables in record listings (comma-separated) If `*` is used, all tables will be hidden .. index:: hideTranslations List module; Hide translations Localization; Hide translations in List module .. _pageTsConfigWebList-hideTranslations: hideTranslations ================ .. confval:: hideTranslations :name: mod-web-list-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. .. _pageTsConfigWebList-hideTranslations-example-all: Example: Hide all translated records ------------------------------------ .. code-block:: typoscript :caption: EXT:site_package/Configuration/page.tsconfig mod.web_list.hideTranslations = * .. _pageTsConfigWebList-hideTranslations-example: Example: Hide translated records in tables tt_content and tt_news ----------------------------------------------------------------- .. code-block:: typoscript :caption: EXT:site_package/Configuration/page.tsconfig mod.web_list.hideTranslations = tt_content, tt_news .. index:: itemsLimitPerTable List module; Items per table .. _pageTsConfigWebList-itemsLimitPerTable: itemsLimitPerTable ================== .. confval:: itemsLimitPerTable :name: mod-web-list-itemsLimitPerTable :type: positive integer :Default: 20 ` Set the default maximum number of items to show per table. The number must be between `5` and `10000`. If below or above this range, the nearest valid number will be used. .. _pageTsConfigWebList-itemsLimitPerTable-example: Example: Limit items per table in overview to 10 ------------------------------------------------ .. code-block:: typoscript :caption: EXT:site_package/Configuration/page.tsconfig mod.web_list { itemsLimitPerTable = 10 } .. index:: itemsLimitSingleTable List module; Items per table in single table view .. _pageTsConfigWebList-itemsLimitSingleTable: itemsLimitSingleTable ===================== .. confval:: itemsLimitSingleTable :name: mod-web-list-itemsLimitSingleTable :type: positive integer :Default: 100 Set the default maximum number of items to show in single table view. The number must be between `5` and `10000`. If below or above this range, the nearest valid number will be used. .. _pageTsConfigWebList-itemsLimitSingleTable-example: Example: Limit items in single table view to 10 ----------------------------------------------- .. code-block:: typoscript :caption: EXT:site_package/Configuration/page.tsconfig mod.web_list { itemsLimitSingleTable = 10 } .. index:: listOnlyInSingleTableView List module; Records in single table view only .. _pageTsConfigWebList-listOnlyInSingleTableView: listOnlyInSingleTableView ========================= .. confval:: listOnlyInSingleTableView :name: mod-web-list-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! .. _pageTsConfigWebList-listOnlyInSingleTableView-example: Example: Only list records of tables in single-table mode --------------------------------------------------------- .. code-block:: typoscript :caption: 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: .. figure:: /Images/ManualScreenshots/List/PageTsModWebListListOnlyInSingleTableView.png :alt: The list module after activating the single-table mode The list module after activating the single-table mode .. index:: newPageWizard.override Pages; New wizard .. _pageTsConfigWebList-newPageWizard-override: newPageWizard.override ====================== .. confval:: newPageWizard.override :name: mod-web-list-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. .. index:: noCreateRecordsLink Buttons; Create new record .. _pageTsConfigWebList-noCreateRecordsLink: noCreateRecordsLink =================== .. confval:: noCreateRecordsLink :name: mod-web-list-noCreateRecordsLink :type: boolean :Default: 0 If set, the link "Create new record" is hidden. .. _pageTsConfigWebList-noCreateRecordsLink-example: Example: Hide the "Create new record" link. ------------------------------------------- .. code-block:: typoscript :caption: EXT:site_package/Configuration/page.tsconfig mod.web_list { noCreateRecordsLink = 1 } .. index:: noExportRecordsLinks Buttons; Export Buttons; Download .. _pageTsConfigWebList-noExportRecordsLinks: noExportRecordsLinks ==================== .. confval:: noExportRecordsLinks :name: mod-web-list-noExportRecordsLinks :type: boolean :Default: 0 If set, the :guilabel:`Download` and :guilabel:`Export` buttons are hidden in the list module. This applies to the :guilabel:`Export` button located at the top left for t3d exports, the :guilabel:`Download` button directly on the table listing for csv download and the :guilabel:`Download` button in the tables single view. This option is for example important to disable batch download of sensitive data via CSV or t3d exports. .. include:: /Images/AutomaticScreenshots/WebList/WithExportButtons.rst.txt .. include:: /Images/AutomaticScreenshots/WebList/NoExportButtons.rst.txt .. note:: This option only hides the buttons in the list module. Bulk export of data is still possible via the context menu of the page tree. .. _pageTsConfigWebList-noExportRecordsLinks-example: Example: Hide the "Download" and "Export" links ----------------------------------------------- .. include:: /CodeSnippets/PageTSconfig/Mod/noExportRecordsLinks.rst.txt .. index:: noViewWithDokTypes Buttons; View page .. _pageTsConfigWebList-noViewWithDokTypes: noViewWithDokTypes ================== .. confval:: noViewWithDokTypes :name: mod-web-list-noViewWithDokTypes :type: string (comma-separated list of integers) :Default: `254,255` Hide view icon for the defined :ref:`doktypes `. .. index:: table.[tableName].hideTable List module; Hide tables .. _pageTsConfigWebList-table-tableName-hideTable: table.[tableName].hideTable =========================== .. confval:: table.[tableName].hideTable :name: mod-web-list-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. .. _pageTsConfigWebList-table-tableName-hideTable-example: Example: Hide table tt_content ------------------------------ .. code-block:: typoscript :caption: EXT:site_package/Configuration/page.tsconfig mod.web_list.table.tt_content.hideTable = 1 .. index:: table.[tableName].displayColumnSelector List module; columns selector .. _pageTsConfigWebList-table-tableName-displayColumnSelector: table.[tableName].displayColumnSelector ======================================= .. confval:: table.[tableName].displayColumnSelector :name: mod-web-list-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. .. _pageTsConfigWebList-table-tableName-displayColumnSelector-example-disable: Example: Hide the column selector for tt_content ------------------------------------------------ .. code-block:: typoscript :caption: EXT:site_package/Configuration/page.tsconfig mod.web_list.table.tt_content.displayColumnSelector = 0 .. _pageTsConfigWebList-table-tableName-displayColumnSelector-example-enable: Example: Hide the column selector for all tables but sys_category ----------------------------------------------------------------- .. code-block:: typoscript :caption: EXT:site_package/Configuration/page.tsconfig mod.web_list.displayColumnSelector = 0 mod.web_list.table.sys_category.displayColumnSelector = 1 .. index:: tableDisplayOrder List module; Order tables .. _pageTsConfigWebList-tableDisplayOrder: tableDisplayOrder ================= .. confval:: tableDisplayOrder.[tableName] :name: mod-web-list-tableDisplayOrder :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. .. code-block:: typoscript mod.web_list.tableDisplayOrder. { before = , , ... after = , , ... } .. index:: searchLevel.items Items; Search level .. _pageTsConfigWebList-searchLevel-items: searchLevel.items ================= .. confval:: searchLevel.items :name: mod-web-list-searchLevel-items :type: array Sets labels for each level label in the search level select box .. code-block:: typoscript :caption: 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 }