diff --git a/user_manual/talk/attachments.rst b/user_manual/talk/attachments.rst index 3d7680eb7c7..fffa15fd8da 100644 --- a/user_manual/talk/attachments.rst +++ b/user_manual/talk/attachments.rst @@ -23,13 +23,27 @@ Second, you can select a file from your Nextcloud Files or a file manager by cho :alt: Talk file selection panel showing available files to share in chat :width: 600px -You can add more files until you are done and decide to share the files. You can also add a text caption to your shared files, providing a brief description or context. +You can add more files until you are done and decide to share the files. You can also add a text caption to your shared files, providing a brief description or context. When you share several files at once, they are combined into a single message in the chat instead of one message per file, keeping the conversation easier to follow. +.. TODO: needs a new screenshot showing several files combined into one message, current image is the old single-file upload queue .. image:: images/talk-upload-files.png - :alt: Talk file upload queue before sending files in chat + :alt: Talk file upload queue with several files combined into one message before sending :width: 500px -All users will be able to click the files to view, edit or download them, regardless of whether they have a Nextcloud account. Users with an account will have the file automatically shared with them while external guest users will get them shared as a public link. +Before you send the files, this staging area also lets you set options that apply to the upload. When you share +images, they use ``Standard image quality`` by default, which resizes and compresses them to save bandwidth and +storage; switch to ``Original image quality`` if you need to share the full-quality file. GIF, SVG and HEIC images +are always sent in original quality. Depending on your instance, you can also choose ``View-only for others`` +(the default) or ``Editable by others`` for the shared files. + +If you delete a message with several files, all files of that message are deleted. + +.. TODO: feature is live in 25.0.0, needs a real screenshot of the compression and view-only/can-edit menus opened in the staging area +.. image:: images/talk-upload-files.png + :alt: Talk staging area showing the image compression and view-only/can-edit options + :width: 500px + +All users will be able to click the files to view or download them, regardless of whether they have a Nextcloud account, and edit them if you allowed it. Users with an account will have the file automatically shared with them while external guest users will get them shared as a public link. .. image:: images/editing-document-in-chat-room.png :alt: Talk chat with a shared document that participants can open and edit diff --git a/user_manual/talk/call.rst b/user_manual/talk/call.rst index d3c0b1b53dd..71e82e178f9 100644 --- a/user_manual/talk/call.rst +++ b/user_manual/talk/call.rst @@ -21,6 +21,7 @@ When a call is already in progress, join it by clicking the green ``Join call`` You will see the ``Check devices`` dialog, where you can customise your call experience: +.. TODO: update screenshot to show the notify all participants checkbox next to the Start call button .. image:: images/calls/media-settings-initial.png :alt: Talk Check devices dialog before joining a call :width: 600px @@ -81,12 +82,28 @@ and whether you have ``Moderator`` permission for the conversation. If you are joining and the call is being recorded, you might be required to consent before being allowed to join. For more information, see :ref:`Call recording `. +Restricting who can start a call (moderator) +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +An administrator can limit who is allowed to start a call server-wide, to one of: everyone, users and moderators, +moderators only, or nobody (calls disabled). An administrator can additionally restrict starting a call to +members of specific groups; when such groups are configured, only their members can start a call, and this also +applies to moderators, while guests and federated users can never be part of a group. + +If you are not allowed to start a call, the ``Start call`` button is disabled until somebody else starts the call. +You can then join the call in progress. For conversations hosted on a federated server, the configuration of that +server applies instead. Ask your administrator to check the Talk admin settings if you need to start calls yourself. + Start the call ^^^^^^^^^^^^^^ Click the ``Start call`` button at the bottom of the ``Check devices`` dialog to notify all conversation participants of the call. -If you do not want to notify the other participants, start a silent call by opening the three-dot menu to the left of the ``Start call`` button -and choosing ``Start call silently``. +If you do not want to notify the other participants, start a silent call: clear the +``Notify all participants about this call`` checkbox, then click ``Start call silently``. +In the conversation top bar, open the ``More actions`` menu next to the ``Start call`` button and choose +``Start call silently``. + +.. TODO: screenshots below show the old three-dot menu, replace them with the notify checkbox and the top bar menu .. image:: images/calls/media-settings-silent-call.png :alt: Talk Start call silently option in the Check devices dialog @@ -173,6 +190,7 @@ Controlling audio and video Bottom bar of the call view offers media controls, layout settings and other features you can use during a call. +.. TODO: update screenshot to show the new layout menu with multi-speaker view in the bottom bar .. image:: images/calls/during-a-call-controls.png :alt: Talk active call bottom bar showing media controls and layout settings :width: 400px diff --git a/user_manual/talk/call_views.rst b/user_manual/talk/call_views.rst index 4e2d04a824f..6d4a7704d68 100644 --- a/user_manual/talk/call_views.rst +++ b/user_manual/talk/call_views.rst @@ -2,10 +2,12 @@ Call layout =========== -You can switch between grid view and speaker view using the toggle icon in the three-dot menu or the bottom bar. +You can switch between ``Grid view``, ``Speaker view`` and ``Multi-speaker view`` using the layout menu in the +bottom bar. Talk remembers your choice for each conversation. +.. TODO: update screenshot to show the layout menu with grid, speaker and multi-speaker view .. image:: images/call-view-toggle-button.png - :alt: Talk call view toggle button to switch between grid and speaker view + :alt: Talk call layout menu to switch between grid, speaker and multi-speaker view :width: 300px Grid view @@ -26,3 +28,17 @@ Use the navigation buttons on the left and right to scroll through participants .. image:: images/talk-promoted-view.png :alt: Talk call in promoted (speaker) view with the active speaker highlighted :width: 700px + +Multi-speaker view +------------------- + +Multi-speaker view works like speaker view, but shows up to three active speakers in large tiles instead of just +one, so you can follow a discussion between several people at once. A participant moves to a large tile after +speaking for a few seconds, and goes back to the row after about 30 seconds of silence. + +Multi-speaker view is not available when the call is shown in the sidebar. + +.. TODO: feature is live in 25.0.0, mock screenshot below needs to be replaced with a real capture +.. image:: images/talk-promoted-view.png + :alt: Talk call in multi-speaker view with several active speakers highlighted + :width: 700px diff --git a/user_manual/talk/conversation_organization.rst b/user_manual/talk/conversation_organization.rst index 16b5c9aa21c..d5b533a0f00 100644 --- a/user_manual/talk/conversation_organization.rst +++ b/user_manual/talk/conversation_organization.rst @@ -13,6 +13,7 @@ Tags Create custom tags to categorize your conversations and keep them organized. Tags help you group conversations by project, team, topic, or any other criteria that makes sense for your workflow. +.. TODO: update screenshot to show the last message time next to each conversation .. image:: images/conversations-tag-overview.png :alt: Talk conversations tag appearance :width: 400px @@ -23,6 +24,13 @@ Tags help you group conversations by project, team, topic, or any other criteria You can later manage existing tags by renaming, reordering or deleting them. +When you collapse a tag, Talk can still show its unread conversations. In the Talk settings, choose an option for +``Show unread conversations under collapsed tags``: + +- **Off**: Hide all conversations of a collapsed tag +- **@-mentions only**: Show conversations with unread mentions +- **All messages**: Show conversations with any unread message (default) + .. image:: images/conversations-tag-actions.png :alt: Talk conversations tag actions :width: 400px @@ -42,6 +50,10 @@ Similar types can also be grouped together: - **Show private ones first**: Show private conversations before groups/public - **Show group ones first**: Show groups/public conversations before private +Each conversation in the list shows the time of its last message: the time for today, the weekday for the last +seven days, and the date for older messages. The time is hidden in the compact view of the conversation list. + +.. TODO: update screenshot to show the last message time next to each conversation .. image:: images/conversations-sorting.png :alt: Talk conversations sorting and grouping options :width: 400px diff --git a/user_manual/talk/conversation_presets.rst b/user_manual/talk/conversation_presets.rst index f4a6f1c6ec7..14e575b0c3b 100644 --- a/user_manual/talk/conversation_presets.rst +++ b/user_manual/talk/conversation_presets.rst @@ -13,6 +13,7 @@ Available presets Depending on your instance configuration, you may see presets when creating a new conversation. Each preset applies a specific set of defaults suited to a particular use case. +.. TODO: update screenshot to show the Conversation type field with the classified, channel and announcement presets .. image:: images/new-conversation-presets.png :alt: Talk new conversation dialog with presets selection :width: 400px @@ -40,6 +41,54 @@ Presentation Presentation preset is useful for internal meetings, where it is expected to have more listeners than speakers. Participant permissions are optimized to ensure the best performance and moderation experience, allowing presenters to speak uninterrupted. +Classified conversation +------------------------ + +A locked-down conversation preset for confidential topics. A classified conversation cannot be made public or open +to other users on the server, so there is no public link and no guest access. Federation, SIP dial-in and dial-out, +invitations by email or phone, call recording, live transcription, bots, bridges, breakout rooms and AI summaries +are disabled. Messages expire after one hour by default. + +The conversation is always marked as sensitive: notifications and activities show ``Private conversation`` instead +of its name and do not reveal message content. Message translation and private replies from other conversations are +not available. + +After a call ends, the whole conversation is deleted for everyone after a period of inactivity (one hour by default). +A notice in the chat shows when the deletion happens. Moderators can click ``Delete now`` to delete it immediately, +or ``Keep`` to keep the conversation. + +.. TODO: feature is live in 25.0.0, mock screenshot below needs to be replaced with a real capture +.. image:: images/new-conversation-presets.png + :alt: Talk new conversation dialog with the classified conversation preset selected + :width: 400px + +Channel +------- + +A broadcast conversation preset for a large audience. Only moderators can post messages; everyone else can only +react, unless a moderator grants individual participants more permissions. Calls are disabled for everyone, including +moderators. The conversation is visible to and can be joined by other users on the server. Only moderators can see +the participant list and system messages. + +.. TODO: feature is live in 25.0.0, mock screenshot below needs to be replaced with a real capture +.. image:: images/new-conversation-presets.png + :alt: Talk new conversation dialog with the channel preset selected + :width: 400px + +Announcement +------------ + +An announcement preset works like a channel, with the same posting and call restrictions, but the conversation is +not open for other users to join, and participants who are added to it cannot leave. Participants get a notification +for every message by default, and they can change this in the notification settings. + +.. note:: Only administrators can create announcements. + +.. TODO: feature is live in 25.0.0, mock screenshot below needs to be replaced with a real capture +.. image:: images/new-conversation-presets.png + :alt: Talk new conversation dialog with the announcement preset selected + :width: 400px + See also: - :doc:`conversations` diff --git a/user_manual/talk/conversations.rst b/user_manual/talk/conversations.rst index 2c5ddfc088c..2502e6e8094 100644 --- a/user_manual/talk/conversations.rst +++ b/user_manual/talk/conversations.rst @@ -72,9 +72,11 @@ The Talk Dashboard is your central hub for managing and accessing your conversat - Unread mentions and messages in private chats; - Message reminders, scheduled to be tackled on later; -- Scheduled meetings, with event details and shortcut buttons to join them; -- Shortcut actions to create new conversations, join open ones, or quickly check your media devices. +- Upcoming meetings, with event details and shortcut buttons to join them; +- Shortcut actions to start a meeting now, create new conversations, join open ones, call a phone number, + or check your media devices. +.. TODO: update screenshot to reflect the redesigned Talk dashboard panel .. image:: images/talk-dashboard.png :alt: Talk dashboard showing recent conversations and shortcut actions :width: 600px @@ -96,6 +98,7 @@ If you want to create a custom group conversation, click the button next to the You can then pick a name for the conversation, put a description, and set up an avatar for it (with uploaded photo or emoji), and select if the conversation should be open to external users and if other users on the server can see and join the conversation. +.. TODO: update screenshot to show the Conversation type field in the new conversation dialog .. image:: images/creating-open-conversation.png :alt: Talk new conversation setup dialog for name, description, and access type :width: 500px @@ -120,12 +123,14 @@ You can filter your conversations using the filter button next to the search fie 2. **Unread messages**: view unread messages in all conversations you are a part of. 3. **Meeting conversations**: view all conversations, created for upcoming or past events. +.. TODO: update screenshot to show the last message time next to each conversation .. image:: images/filters-menu.png :alt: Talk conversation list filter menu :width: 400px You can then clear the filter from the filters menu. +.. TODO: update screenshot to show the last message time next to each conversation .. image:: images/clear-filter.png :alt: Talk conversation list with active filter and clear filter option :width: 400px @@ -135,6 +140,7 @@ Archive conversations You can archive conversations that you no longer need to see in your main conversation list. When a conversation is archived, it will be moved to the ``Archived conversations`` section. An archived conversation will not appear in your main conversation list, but it will still align with notification level set in its settings. +.. TODO: update screenshot to show the last message time next to each conversation .. image:: images/archived-conversations-list.png :alt: Talk list of archived conversations :width: 400px @@ -145,6 +151,15 @@ The list is accessible from the button at the bottom of the navigation bar. :alt: Talk navigation bar showing the archived conversations button :width: 400px +To unarchive conversations automatically when new messages arrive, open the Talk settings and choose an option +for ``Unarchive conversation when new messages are received``: + +- **Off**: Keep conversations archived (default) +- **@-mentions only**: Unarchive on a mention or a reply to your message, and on any message in private chats +- **All messages**: Unarchive on any new message + +Your own messages never unarchive a conversation. + Managing a conversation ----------------------- @@ -152,6 +167,7 @@ You are always moderator in your new conversation. In the participant list you c Changing permissions of a user that joined a public conversation will also permanently add them to the conversation. +.. TODO: update screenshot to show the owner badge and owner actions in the participant menu .. image:: images/participant-menu.png :alt: Talk participant menu showing permission and moderation options :width: 400px @@ -164,10 +180,47 @@ Moderators can configure the conversation. Select ``Conversation settings`` from Here you can configure the description, guest access, if the conversation is visible to others on the server and more. +.. TODO: update screenshot to show the Danger zone section with the Preserve conversation setting .. image:: images/conversation-settings-dialog.png :alt: Talk conversation settings dialog showing description and access configuration :width: 600px +Owner role +---------- + +The person who created a group conversation is its owner. Owners are marked with the ``Owner`` badge in the +participant list. An owner can promote other users to owners with ``Promote to owner`` in the participant list +``...`` menu. To demote an owner, choose ``Demote from owner to moderator`` or ``Demote from owner to participant``. +Guests, federated users and phone participants cannot become owners. + +.. TODO: feature is live in 25.0.0, mock screenshot below needs to be replaced with a real capture +.. image:: images/participant-menu.png + :alt: Talk participant menu with promote/demote owner options + :width: 400px + +Only owners can promote or demote owners. An owner cannot be removed from the conversation, so demote them first. +You can step down from the owner role yourself, but only to moderator. The last owner or moderator of a conversation +cannot be demoted to participant. + +Preserved conversations +------------------------ + +An owner can mark a conversation as preserved, for conversations that must be kept for record-keeping or compliance +reasons. While a conversation is preserved, nobody can delete it, clear its chat history, or change its guest access +and whether other users on the server can see and join it. + +To preserve a conversation, open ``Conversation settings`` and turn on ``Preserve conversation`` in the +``Danger zone`` section. Moderators can see this setting, but only owners can change it. To stop preserving the +conversation, turn the setting off and confirm by typing the conversation token. + +.. note:: Preserving does not stop the automatic deletion of a classified conversation after a call. + See :doc:`conversation_presets`. + +.. TODO: feature is live in 25.0.0, mock screenshot below needs to be replaced with a real capture +.. image:: images/conversation-settings-dialog.png + :alt: Talk conversation settings showing the preserve conversation option + :width: 600px + Ban participants ---------------- diff --git a/user_manual/talk/federation_index.rst b/user_manual/talk/federation_index.rst index 8f1a91eba04..1060369e29c 100644 --- a/user_manual/talk/federation_index.rst +++ b/user_manual/talk/federation_index.rst @@ -33,6 +33,7 @@ Upon clicking it, more information will be provided about the inviting party, an By accepting the invite, the conversation will appear in the list as any other one. +.. TODO: update screenshot to show the last message time next to each conversation .. image:: images/federation-conversations-list.png :alt: Talk conversation list showing a federated conversation from another server :width: 400px diff --git a/user_manual/talk/messages.rst b/user_manual/talk/messages.rst index 6dd1fd79ead..d90d961b2df 100644 --- a/user_manual/talk/messages.rst +++ b/user_manual/talk/messages.rst @@ -43,16 +43,32 @@ In the submenu, you can select an appropriate time to receive a notification lat You can also forward a message to another conversation using the ``...`` menu, or send it to your **Note to self** conversation for personal reference. +Global message search +---------------------- + +You can search for messages across all your conversations at once from the conversation list search field, without +opening each conversation individually. When you start typing, select the ``Messages`` filter below the search field +to show matching messages in addition to conversations. Talk remembers your choice. + +Results show a preview of the matching message and its conversation, so you can jump straight to it. The list shows +up to 10 results, so make your search term more specific if you do not find the message. + +.. TODO: feature is live in 25.0.0, mock screenshot below needs to be replaced with a real capture +.. image:: images/chat-search-messages.png + :alt: Talk global search results showing matching messages across conversations + :width: 500px + Messages search in a conversation --------------------------------- -In addition to global unified search, you can search for messages within a specific conversation. In the content sidebar of a conversation, click the search icon to open the search tab. +In addition to the global message search, you can search for messages within a specific conversation. In the content sidebar of a conversation, click the search icon to open the search tab. .. image:: images/chat-search-messages.png :alt: Talk in-conversation message search field :width: 500px -You can narrow down your search by using filters such as date range, and sender. +You can narrow down your search by using filters such as date range, and sender. To see all messages from one +participant, select them in the ``From User`` filter and leave the search field empty. .. image:: images/chat-search-messages-tab.png :alt: Talk message search with date range and sender filter options diff --git a/user_manual/talk/open_conversations.rst b/user_manual/talk/open_conversations.rst index 2726722e3a3..69ee09c8ace 100644 --- a/user_manual/talk/open_conversations.rst +++ b/user_manual/talk/open_conversations.rst @@ -7,6 +7,7 @@ Creating an open conversation You can create an open conversation that any registered user on this server can discover and join. +.. TODO: update screenshot to show the Conversation type field in the new conversation dialog .. image:: images/creating-open-conversation.png :alt: Talk new conversation setup dialog for name, description, and access type :width: 500px