[TASK] Document proper file_list.primaryActions TS settings (#542)

* [TASK] Document proper file_list.primaryActions TS settings Reported in https://forge.typo3.org/issues/104630 a few items were missing here, which are available to be set. Also minor rephrasing to make things clearer. * Add image for file_list.primaryActions * Update Options.rst Co-authored-by: Garvin Hicking <[email protected]> * Update Options.rst Co-authored-by: Garvin Hicking <[email protected]> * Update Options.rst Co-authored-by: Garvin Hicking <[email protected]> --------- Co-authored-by: Stefan Froemken <[email protected]>
TYPO3-Documentation · Aug 16, 2024 · 7ea27ae · 7ea27ae
1 parent 3a864c2
commit 7ea27ae
Show file tree

Hide file tree

Showing 2 changed files with 34 additions and 6 deletions.
diff --git a/Documentation/Images/ManualScreenshots/List/FileListPrimaryActions.png b/Documentation/Images/ManualScreenshots/List/FileListPrimaryActions.png
diff --git a/Documentation/UserTsconfig/Options.rst b/Documentation/UserTsconfig/Options.rst
@@ -535,18 +535,46 @@ file_list.primaryActions
     :type: string
     :Default: :typoscript:`view,metadata,translations,delete`
 
-    Option to add more primary actions to the list view.
+    Option to add more primary actions to the list view,
+    which are otherwise only accessible through the "..." menu in the file list
+    module.
+
     The list of actions to be displayed can be given in the TSConfig of
-    the backend user. The actions that can be added are
+    the backend user. The actions that can be set are
 
-    *   :typoscript:`view`
-    *   :typoscript:`metadata`
-    *   :typoscript:`delete`
     *   :typoscript:`copy`
     *   :typoscript:`cut`
+    *   :typoscript:`delete`
+    *   :typoscript:`download`
+    *   :typoscript:`edit`
+    *   :typoscript:`info`
+    *   :typoscript:`metadata`
+    *   :typoscript:`paste`
+    *   :typoscript:`rename`
+    *   :typoscript:`replace`
+    *   :typoscript:`translations` (always active)
+    *   :typoscript:`updateOnlineMedia`
+    *   :typoscript:`upload`
+    *   :typoscript:`view`
+
+    Example:
 
-    :typoscript:`translations` is always active.
+    ..  code-block:: tsconfig
+        :caption: EXT:site_package/Configuration/user.tsconfig
+
+        # This will add "copy", "cut" and "replace" buttons in addition to the three default
+        # buttons. "translations" can be omitted, as it will be added by default,
+        # if a TYPO3 site is set up multilingual.
+        options.file_list.primaryActions = view,metadata,delete,copy,cut,replace
+
+    ..  figure:: /Images/ManualScreenshots/List/FileListPrimaryActions.png
+        :alt: Show primary action with additional copy, cut and replace buttons
+        :class: with-shadow
 
+        See option `primaryActions` with three default buttons and the three
+        additional buttons "copy", "cut" and "replace". As there is no TYPO3
+        site set up multilingual the button "translations" is not rendered in
+        that TYPO3 environment.
 
 ..  index:: File list; Thumbnails height
 ..  _useroptions-file_list-thumbnail-height: