diff --git a/user_manual/files/access_webgui.rst b/user_manual/files/access_webgui.rst index 25271edbf36..ba9ab916911 100644 --- a/user_manual/files/access_webgui.rst +++ b/user_manual/files/access_webgui.rst @@ -8,176 +8,183 @@ has the option to disable these features, so if any of them are missing on your system ask your server administrator. .. figure:: ../images/users-files.png - :alt: The Files view screen. + :alt: The Files app showing a list of files and folders. -Tagging files -------------- +Navigating your files +--------------------- -You can assign tags to files. To create tags, open a file to the Details view. -Then type your tags. To enter more than one tag press the return key after -creating each tag. All tags are system tags, and are shared by all users on your -Nextcloud server. +The left sidebar lets you switch between different views of your files. Click a +folder name in the file list to open it, and use your browser's back button or +the breadcrumb bar at the top of the file list to return to a previous level. -.. figure:: ../images/files_page-7.png - :alt: Creating file tags. +.. figure:: ../images/files_page-5.png + :alt: The Files app left navigation panel. -Then use the Tags filter on the left sidebar to filter files by tags: +The sidebar contains the following entries: -.. figure:: ../images/files_page-8.png - :alt: Viewing file tags. +All files + The default view, showing every file and folder you have access to. -Comments --------- +Recent + Files you have viewed or modified recently. -Use the Details view to add and read comments on any file or folder. Comments -are visible to everyone who has access to the file: +Favorites + Files and folders you have starred. -.. figure:: ../images/file_menu_comments_2.png - :alt: Creating and viewing comments. +Shares + Files shared with you, by you, or via a public link — all in one view. -Video player ------------- +Tags + Browse files by system tag. -You can play videos in Nextcloud with the Video Player app by simply clicking on -the file. Video streaming by the native Nextcloud video player depends on your Web browser -and the video format. If your Nextcloud administrator has enabled video -streaming, and it doesn't work in your Web browser, it may be a browser issue. See https://developer.mozilla.org/en-US/docs/Web/HTML/Supported_media_formats#Browser_compatibility for supported multimedia formats in Web browsers. +Deleted files + Files you have deleted that are still recoverable from the trash bin. -.. figure:: ../images/video_player_2.png - :alt: Watching a movie. +When you navigate into a folder, a breadcrumb trail appears at the top of the +file list so you can jump back to any parent folder with a single click: + +.. figure:: ../images/files_page-6.png + :alt: Breadcrumb navigation inside a subfolder. File controls ------------- -Nextcloud can display thumbnail previews for various file types, such as images, audio files, and text files. -The specific types supported are up to the server administrator. -Hover your cursor over a file or folder to expose the controls for the following operations: +Nextcloud displays thumbnail previews for images, text files, and other +supported types — the exact list depends on your server configuration. -Favorites - Click the star to the left of the file icon to mark it as a favorite: +Each file and folder row has a three-dot action menu button. Click it to +rename, move, copy, download, delete, or mark the item as a favorite. +Files that have been marked as a favorite display a star icon: - .. figure:: ../images/files_page-1.png - :alt: Marking Favorite files. +.. figure:: ../images/files_page-3.png + :alt: A file row with the actions menu open. - You can also quickly find all of your favorites with the Favorites filter on the left - sidebar. +.. note:: You can quickly find all your favorites using the **Favorites** + entry in the left sidebar. -Overflow Menu - The Overflow menu (three dots) displays file details, and allows you to - rename, download, or delete files: +Details sidebar +--------------- - .. figure:: ../images/files_page-3.png - :alt: Overflow menu. - - The Details view shows Activities, Sharing, and Versions information: +Select **Details** from the three-dot action menu to open the details sidebar. The sidebar +shows information about the selected file and provides tabbed access to its +activity history, sharing options, and version history: .. figure:: ../images/files_page-4.png - :alt: Details screen. + :alt: The details sidebar showing file information and tabs. -The **Settings** gear icon at the lower left allows you to show or hide hidden -files in your Nextcloud Web interface. These are also called dotfiles, because -they are prefixed with a dot, e.g. ``.mailfile``. The dot tells your operating -system to hide these files in your file browsers, unless you choose to display -them. Usually these are configuration files, so having the option to hide them -reduces clutter. +Activity and comments +--------------------- -.. figure:: ../images/hidden_files.png - :alt: Hiding or displaying hidden files. +The **Activity** tab in the details sidebar shows a chronological log of +changes to the file — uploads, edits, shares, and comments. You can leave +a comment directly in this tab; comments are visible to everyone who has +access to the file: -Previewing files ----------------- +.. figure:: ../images/file_menu_comments_2.png + :alt: The Activity tab showing file history and a comment field. -You can display uncompressed text files, OpenDocument files, videos, and image -files in the Nextcloud embedded viewers by clicking on the file name. There may -be other file types you can preview if your Nextcloud administrator has enabled -them. If Nextcloud cannot display a file, it starts a download process and -downloads the file to your computer. +Searching and filtering +----------------------- -Navigating inside your Nextcloud --------------------------------- +Use the search bar at the top of the page to find files by name across all your +files, or type in the search field inside the left sidebar to filter the current +view: -Navigating through folders in Nextcloud is as simple as clicking on a folder to -open it and using the back button on your browser to move to a previous level. -Nextcloud also provides a navigation bar at the top of the Files page for quick -navigation. +.. figure:: ../images/files_page-7.png + :alt: The search field with a search term entered. -Sharing status icons --------------------- +Grid view +--------- -Any folder that has been shared is marked with the ``Shared`` overlay icon. -Public link shares are marked with a chain link. Unshared folders are not marked: +The Files app defaults to a list view. Click the grid toggle button at the +top-right of the file list to switch to a thumbnail grid, which is useful for +browsing image folders: -.. figure:: ../images/files_page-5.png - :alt: Share status icons. +.. figure:: ../images/files_page-8.png + :alt: Files displayed in thumbnail grid view. -Creating or uploading files and directories -------------------------------------------- +Click the button again to return to the list view. -Upload or create new files or folders directly in a Nextcloud folder by clicking -on the *New* button in the Files app: +Uploading and creating files +---------------------------- -.. figure:: ../images/files_page-6.png - :alt: The New file/folder/upload menu. +Click the **+** button near the top of the file list to upload files from your +computer or create new items in the current folder: + +.. figure:: ../images/files_page-1.png + :alt: The New file and upload menu. -The *New* button provides the following options: +The menu offers the following options: -Up arrow - Upload files from your computer into Nextcloud. You can also upload files by - dragging and dropping them from your file manager. +Upload file + Opens a file picker to upload one or more files from your computer. You can + also drag and drop files directly from your file manager onto the file list. -Text file - Creates a new text file and adds the file to your current folder. +Upload folder + Uploads an entire folder, preserving its structure. -Folder - Creates a new folder in the current folder. +New folder + Creates a new empty folder in the current location. + +New document / New spreadsheet / New presentation + Creates a new file using the built-in Nextcloud Text or Office editor, + if enabled by your administrator. Selecting files or folders -------------------------- -You can select one or more files or folders by clicking on their checkboxes. To -select all files in the current directory, click on the checkbox located at the -top of the files listing. +Click the checkbox to the left of a file or folder to select it. To select all +items in the current folder, click the checkbox in the column header. + +With one or more items selected, action buttons appear at the top of the list. +You can delete or download all selected items at once. Downloading multiple items +produces a ZIP archive. -When you select multiple files, you can delete all of them, or download them as -a ZIP file by using the ``Delete`` or ``Download`` buttons that appear at the -top. +.. figure:: ../images/files_page-9.png + :alt: Multiple files selected with the bulk action bar visible. -.. note:: If the ``Download`` button is not visible, the administrator has +.. note:: If the **Download** button is not visible, your administrator has disabled this feature. -Filtering the files view ------------------------- +Sharing status icons +-------------------- -The left sidebar on the Files page contains several filters for quickly sorting -and managing your files. +Folders and files that have been shared display a **Shared** badge on their +thumbnail or icon. Items shared via a public link also show a chain-link icon. +Items that are not shared have no additional indicator. -All files - The default view; displays all files that you have access to. +.. figure:: ../images/files_sharing_status.png + :alt: File list showing a shared folder, a public-link-shared file, and unshared items. -Favorites - Files or folders marked with the yellow star. +See :doc:`sharing` for instructions on creating and managing shares. -Shared with you - Displays all files shared with you by another user or group. +Moving files +------------ -Shared with others - Displays all files that you have shared with other users or groups. +Drag any file or folder and drop it onto a destination folder to move it. +You can also use **Move or copy** from the three-dot action menu to move or copy +items to a folder you choose from a picker dialog. -Shared by link - Displays all files that are shared by you via public link. +Previewing files +---------------- -External Storage (optional) - Files that you have access to on external storage devices and services such - as Amazon S3, SMB/CIFS, FTP… +Click a file name to open a preview directly in Nextcloud. Supported formats +include images, plain text, PDF, and — depending on your server — office +documents and audio files. If Nextcloud cannot preview a file format, it +downloads the file to your computer instead. -Moving files +Video player ------------ -You can move files and folders by dragging and dropping them into any directory. +You can play videos directly in Nextcloud by clicking the file. Playback +depends on your browser and the video codec. See +`MDN: Supported media formats `_ +for a compatibility reference. -Creating or connecting to a Federation Share link -------------------------------------------------- +Connecting to a Federation Share +--------------------------------- -Federated Cloud Sharing allows you to mount file shares from remote Nextcloud -servers, and manage them just like a local share. See :doc:`federated_cloud_sharing` -to learn to how to create and connect to new Federated Cloud shares. +Federated Cloud Sharing lets you mount file shares from remote Nextcloud +servers and manage them just like local shares. See +:doc:`federated_cloud_sharing` to learn how to create and connect to +Federated Cloud shares. diff --git a/user_manual/images/file_menu_comments_2.png b/user_manual/images/file_menu_comments_2.png index 9a5de708d64..56101aef383 100644 Binary files a/user_manual/images/file_menu_comments_2.png and b/user_manual/images/file_menu_comments_2.png differ diff --git a/user_manual/images/files_page-1.png b/user_manual/images/files_page-1.png index a07c7b58077..92945c88fdd 100644 Binary files a/user_manual/images/files_page-1.png and b/user_manual/images/files_page-1.png differ diff --git a/user_manual/images/files_page-3.png b/user_manual/images/files_page-3.png index e7c8e987655..fafcf41cd1f 100644 Binary files a/user_manual/images/files_page-3.png and b/user_manual/images/files_page-3.png differ diff --git a/user_manual/images/files_page-4.png b/user_manual/images/files_page-4.png index dd86072ff76..3189b3d7447 100644 Binary files a/user_manual/images/files_page-4.png and b/user_manual/images/files_page-4.png differ diff --git a/user_manual/images/files_page-5.png b/user_manual/images/files_page-5.png index 923c7cdfafa..cfb0015066a 100644 Binary files a/user_manual/images/files_page-5.png and b/user_manual/images/files_page-5.png differ diff --git a/user_manual/images/files_page-6.png b/user_manual/images/files_page-6.png index b72bc2745f5..43782d4db78 100644 Binary files a/user_manual/images/files_page-6.png and b/user_manual/images/files_page-6.png differ diff --git a/user_manual/images/files_page-7.png b/user_manual/images/files_page-7.png index 9e6ad1658cf..635d123b2fc 100644 Binary files a/user_manual/images/files_page-7.png and b/user_manual/images/files_page-7.png differ diff --git a/user_manual/images/files_page-8.png b/user_manual/images/files_page-8.png index 01733f6e4fe..0f26fcb1bd9 100644 Binary files a/user_manual/images/files_page-8.png and b/user_manual/images/files_page-8.png differ diff --git a/user_manual/images/files_page-9.png b/user_manual/images/files_page-9.png new file mode 100644 index 00000000000..9359f807dc7 Binary files /dev/null and b/user_manual/images/files_page-9.png differ diff --git a/user_manual/images/files_sharing_status.png b/user_manual/images/files_sharing_status.png new file mode 100644 index 00000000000..0ad59e47840 Binary files /dev/null and b/user_manual/images/files_sharing_status.png differ diff --git a/user_manual/images/users-files.png b/user_manual/images/users-files.png index 1d528a10d25..0ad59e47840 100644 Binary files a/user_manual/images/users-files.png and b/user_manual/images/users-files.png differ