.. ================================================== .. FOR YOUR INFORMATION .. -------------------------------------------------- .. -*- coding: utf-8 -*- with BOM. .. include:: ../Includes.txt .. _user-manual: Users Manual ============ You have the possibility to disable all buttons/actions/clip-icons of a row in Web>List by adding the “key” of the action/button to a comma separated list of those icons which shall get hidden/disabled. The possible keys for the buttons/actions are: +-------------------+-----------+-----------------------------------------------------------------------------+ | Button | Key | Description | +===================+===========+=============================================================================+ | View Element/Page | view | Opens up a new window showing the clicked page/content-element. | +-------------------+-----------+-----------------------------------------------------------------------------+ | Edit record | edit | Allows to edit the selected record. | +-------------------+-----------+-----------------------------------------------------------------------------+ | Hide record | hide | When clicked the selected record changes its hidden/visible status | +-------------------+-----------+-----------------------------------------------------------------------------+ | Delete record | delete | Deletes the record. | +-------------------+-----------+-----------------------------------------------------------------------------+ | View Big | viewBig | Opens up a new window showing information about the reocrd (The info icon) | +-------------------+-----------+-----------------------------------------------------------------------------+ | History | history | Shows the history of the record and allows to perform rollback operations. | +-------------------+-----------+-----------------------------------------------------------------------------+ | Create new record | new | When clicked a new record gets created after the selected one. | +-------------------+-----------+-----------------------------------------------------------------------------+ | Move record | move | Opens a dialog in which you can move the record around. | +-------------------+-----------+-----------------------------------------------------------------------------+ | Move record up | moveUp | Moves the selected record up in the listing. | +-------------------+-----------+-----------------------------------------------------------------------------+ | Move record down | moveDown | Moves the selected record down in the listing. | +-------------------+-----------+-----------------------------------------------------------------------------+ | Move left | moveLeft | Moves the clicked page below the currently viewed page. | +-------------------+-----------+-----------------------------------------------------------------------------+ | Move right | moveRight | Moves the clicked page into the page above it in list-view. | +-------------------+-----------+-----------------------------------------------------------------------------+ | Versions | version | Allows to view all created versions of the record and switch the active one | +-------------------+-----------+-----------------------------------------------------------------------------+ | Permissions | perms | Allows to modify the permissions of the pages | +-------------------+-----------+-----------------------------------------------------------------------------+ | Record locked | locked | Just a info-icon. Shown when the record is locked. | +-------------------+-----------+-----------------------------------------------------------------------------+ [mod.web_list.disable_action.(user/group/table/table_user/table_group)] The possible keys for clip-icons are: +------------------------+------------+------------------------------------------------------------------------------------------+ | Button | Key | Description | +========================+============+==========================================================================================+ | Copy to clipboard | copy | Transfers clicked record to the active clipboard and sets the clipboard mode to copy. | +------------------------+------------+------------------------------------------------------------------------------------------+ | Transfer to clipboard | cut | Transfers clicked record to the active clipboard and sets the clipboard mode to move. | +------------------------+------------+------------------------------------------------------------------------------------------+ | Select record checkbox | select | Checkbox shown when an extended clipboard is selected – allows to mark multiple records. | +------------------------+------------+------------------------------------------------------------------------------------------+ | Paste records after | pasteAfter | Paste records which are on the clipboard currently after the clicked record. | +------------------------+------------+------------------------------------------------------------------------------------------+ | Paste records into | pasteInto | Paste records which are on the clipboard currently into the clicked page. | +------------------------+------------+------------------------------------------------------------------------------------------+ [mod.web_list.disable_action.(user/group/table/table_user/table_group)] If you want to know which keys are available you can use the configuration option “enableDebug” (set from within ExtensionManager) to produce log output in typo3temp/logs/. The log messages will contain the available keys for every row in the list view. Be aware that enabling this option can produce a lot of debug output and should only get used during determining the current situation. You have to define which of those buttons shall get disabled/hidden for specific tables/users/groups or combinations of those. You can do so by setting the appropriate value in TSConfig: +------------------------------------+----------+----------------------------------------------------------------------------------------------------+ | Property | Datatype | Description | +====================================+==========+====================================================================================================+ | user.[userUID] | list | A list of above action keys which shall get disabled/hidden for BE-User “userUID” | +------------------------------------+----------+----------------------------------------------------------------------------------------------------+ | group.[groupUID] | list | A list of above action keys which shall get disabled/hidden for BE-Group “groupUID” | +------------------------------------+----------+----------------------------------------------------------------------------------------------------+ | table.[tableName] | list | A list of above action keys which shall get disabled for table “tableName” | +------------------------------------+----------+----------------------------------------------------------------------------------------------------+ | table_user.[tableName].[userUID] | list | A list of above action keys which shall get disabled for table “tableName” and BE-User “userUID” | +------------------------------------+----------+----------------------------------------------------------------------------------------------------+ | table_group.[tableName].[groupUID] | list | A list of above action keys which shall get disabled for table “tableName” and BE-Group “groupUID” | +------------------------------------+----------+----------------------------------------------------------------------------------------------------+ [mod.web_list.disable_action] Examples -------- Here are some examples how you can hide delete, hide, history or cut/copy buttons/actions by setting the value in Page-TS-Config. Please note that with all those configuration you do not take the user the “permission” to perform the appropriate actions – but rather only remove the icons in the Web>List module. So if you disable “edit” for a tt_content element the user will still be able to edit it via the Web>Page module if enabled (or by supplying an appropriate link to the Web-Browsers :) :typoscript:`mod.web_list.disable_action.user.1 = delete,hide` Removes the “delete” and “hide” icon for User with UID 1 :typoscript:`mod.web_list.disable_action.group.2 = cut,copy,pasteAfter,pasteInto` Removes the “cut”, “copy”, “pasteAfter” and “pasteInto” icons for all users in group with UID 2 :typoscript:`mod.web_list.disable_action.group.0 = cut,copy` Removes the “cut” and “copy” icons for all users in ALL groups (0=all) :typoscript:`mod.web_list.disable_action.table.tt_content = history,version` Removes the “history” and “version” icons for all tt_content records :typoscript:`mod.web_list.disable_action.table._all_ = delete,hide` Removes the “delete” and “hide” buttons from all tables. In the file “README.txt” included in the extension directory are more examples. The following examples do not get described – try to find out what they do yourself: :typoscript:`mod.web_list.disable_action.table_user.tt_news.3 = delete,hide` :typoscript:`mod.web_list.disable_action.table_group.tt_content.2 = version,history` :typoscript:`mod.web_list.disable_action.table_group._all_.2 = version,history` :typoscript:`mod.web_list.disable_action.table_group.tt_content.0 = version,history` Hide "New record" button ------------------------ It is also possible to hide the "new record" button on the top of every table listing. For this use can use the following TS-Config which uses only default features of TYPO3: # Disable "New record" header buttons in list module mod.web_list { noCreateRecordsLink = 1 allowedNewTables = x } If you want to show the "New record" button for specific tables you can add the name of the tables to the comma separated list "allowedNewTables". The "x" in above example simply tells to show the "New record" button for a table named x.