Manual:Extension/BlueSpiceExtendedFilelist: Difference between revisions

Revision as of 08:57, 21 January 2026

The File List is a special page that lists all files uploaded to the wiki by users. It offers an enhanced user interface and other advantages over the standard MediaWiki file list.

Accessing the file list

The "Files" link in the menu Global Actions opens the "Special:File list" page.

In addition to the filterable overview of all files uploaded to the wiki, new files can be uploaded directly from here.

Possible Actions

Filter by file name

Enter a search term in the filter input field (see Annotation 1) to find matching file names.

Click the clear button (x symbol) in the filter field to clear the file name filter. The filter field uses auto-completion. If multiple terms are entered, the file will only be found if the file name exactly contains the entered term. Example:

The file VisualEditor-file-upload-extended.png is found with "VisualEditor-file-upload", but not with "Visual Editor upload" or "VisualEditor file" (missing hyphen).

Batch file upload

Click the "New File" button (Annotation 2) to upload one or more files to the wiki.

Change view

Click the "Tiles" button (Annotation 3) to switch to the simplified image view. Click the "List" button to return to the list view.

Sort and filter

Sort: Click the sort button (up and down arrows icon, Annotation 5) and select one or more sort filters. Open filters have their own button (Annotation 5).

Filter: Click the filter button (funnel icon, Annotation 5) and select one or more column filters. Open filters have their own button.

Actions on a File

The following file-specific actions are available (Annotation 6):

Information: Click the info icon (Annotation 6) to display the file information. From here, you can also navigate to the file description page.

Upload: Click the upload button to upload a new version of the file.

Delete: Click the delete icon to delete the file.

__Force TOC__

Technical Reference: BlueSpiceExtendedFilelist

PDF exclude - start

To submit feedback about this documentation, visit our community forum.

PDF exclude - end

@@ Line 1: / Line 1: @@
-{{DISPLAYTITLE:File list}}
+{{DISPLAYTITLE:Local files}}
-__TOC__
+The File List is a special page that lists all files uploaded to the wiki by users. It offers an enhanced user interface and other advantages over the standard MediaWiki file list.
-The file list provides  a special page that lists all files that have been uploaded to the wiki.
+==Accessing the file list==
+The "Files" link in the menu [[Manual:Extensions/BlueSpiceDiscovery|Global Actions]] opens the "Special:File list" page.<br />
+[[File:Manual:filelist.png|alt=Open "Global Actions" menu with "Files" link highlighted]|centered|mini|650x650px|Link to File List]]
+In addition to the filterable overview of all files uploaded to the wiki, new files can be uploaded directly from here.
+[[File:Manual:Manual File List.png|alt=File list with active example filters and highlighting of individual interaction elements.|centered|mini|650x650px|Annotated view of the file list]]
+== Possible Actions ==
+=== Filter by file name ===
+Enter a search term in the filter input field (see Annotation 1) to find matching file names.
-==Accessing the file list==
+Click the clear button (x symbol) in the filter field to clear the file name filter. The filter field uses auto-completion. If multiple terms are entered, the file will only be found if the file name exactly contains the entered term. Example:
-[[File:Manual:filelist.png|link=link=Special:FilePath/BlueSpiceExtendedFileList.JPG|alt=highlighted link to the File list|thumb|center|650x650px|Global actions menu]]
-The page can be accessed from ''Global actions > Overview> Files''. This link loads the page ''Special:Filelist''.
+The file <code>VisualEditor-file-upload-extended.png</code> is found with "VisualEditor-file-upload", but not with "Visual Editor upload" or "VisualEditor file" (missing hyphen).
+=== Batch file upload ===
+Click the "New File" button (Annotation 2) to upload one or more files to the wiki.
+=== Change view ===
+Click the "Tiles" button (Annotation 3) to switch to the simplified image view. Click the "List" button to return to the list view.
+=== Sort and filter ===
+* '''Sort:''' Click the sort button (up and down arrows icon, Annotation 5) and select one or more sort filters. Open filters have their own button (Annotation 5).
+* '''Filter:''' Click the filter button (funnel icon, Annotation 5) and select one or more column filters. Open filters have their own button.
+=== Actions on a File ===
+The following file-specific actions are available (Annotation 6):
-==View options==
+* '''Information''': Click the info icon (Annotation 6) to display the file information. From here, you can also navigate to the file description page.
-The uploaded files are organized as thumbnails in a ''Tiles'' layout by default. For a detailed file list, you can switch to the ''List'' view.
-[[File:files list view.png|alt=file lis as  "List" layout|center|thumb|650x650px|List view]]
+* '''Upload:''' Click the upload button to upload a new version of the file.
-==Possible actions==
+* '''Delete:''' Click the delete icon to delete the file.
-The following options are available:
-*'''Search field:''' Filters the column ''File name''.
+{{Translation}}
-*''' Upload new files:''' Click on the upload-symbol next to the filter field to add files to the wiki (Multi-upload is possible).
+__Force TOC__
-*'''Column filter:''' Each column has its own filter option in the column header.
-*'''Sort filelist:''' The default sort order is based on the modification date of the files. Click on a column heading to change the sort order (ascending / descending).
-*'''Show / hide columns:''' Hover over any heading and click on the arrow  to open the column filter. Select the columns you want to display.
-*'''File details:''' Click the thumbnail to view more information about the file, such as a larger preview image or its version history.
-*'''View the file description page:''' Click the file name to open the file description page.
-In the last column, additional actions are available when you hover over a grid row:
-* '''File information:''' shows the metadata for the image
+[[Category:Editing]]
-* '''Upload:''' Allows to upload a new version of the file
+{{Translation}}
-* '''Delete:''' Deletes the file from the wiki. Wiki administrators can restore any deleted file via the deletion log.
-{{Box Links-en|Topic1=[[Reference:BlueSpiceExtendedFilelist]]}}{{Translation}}