Mercurial > libervia-web

annotate doc/user/chat.rst @ 1634:6c6ab1a96b34

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
browser (meta): integrate Quill editor. Quill will be used for rich editing for chat, blog, and probably other parts. rel 461
author Goffi <goffi@goffi.org>
date Fri, 04 Jul 2025 17:40:18 +0200
parents 7a97408f32bb
children 691f6c8afb31
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1621
d7c8a986f4fb doc (chat): chat documentation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
1 =================
d7c8a986f4fb doc (chat): chat documentation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
2 Instant Messaging
d7c8a986f4fb doc (chat): chat documentation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
3 =================
d7c8a986f4fb doc (chat): chat documentation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
4
d7c8a986f4fb doc (chat): chat documentation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
5 You can find the instant messaging feature on the **Chat** tab. Libervia's chat
d7c8a986f4fb doc (chat): chat documentation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
6 functionality supports a wide range of use cases, from professional collaboration to
d7c8a986f4fb doc (chat): chat documentation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
7 personal communication.
d7c8a986f4fb doc (chat): chat documentation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
8
d7c8a986f4fb doc (chat): chat documentation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
9 Accessing the Chat Feature
d7c8a986f4fb doc (chat): chat documentation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
10 --------------------------
d7c8a986f4fb doc (chat): chat documentation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
11
d7c8a986f4fb doc (chat): chat documentation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
12 1. Navigate to the main menu.
d7c8a986f4fb doc (chat): chat documentation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
13 2. Select the **Chat** option.
d7c8a986f4fb doc (chat): chat documentation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
14
d7c8a986f4fb doc (chat): chat documentation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
15 Panels
d7c8a986f4fb doc (chat): chat documentation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
16 ------
d7c8a986f4fb doc (chat): chat documentation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
17
d7c8a986f4fb doc (chat): chat documentation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
18 There are three main panels for managing chats (not all may be visible simultaneously):
d7c8a986f4fb doc (chat): chat documentation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
19
d7c8a986f4fb doc (chat): chat documentation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
20 - **Left panel**: Displays current group chats and direct conversations. You can also
d7c8a986f4fb doc (chat): chat documentation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
21 start a new chat from this panel.
d7c8a986f4fb doc (chat): chat documentation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
22 - **Main panel**: Shows the active conversation.
d7c8a986f4fb doc (chat): chat documentation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
23 - **Right panel**: Provides information about the current discussion, such as participants
d7c8a986f4fb doc (chat): chat documentation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
24 in a chat room.
d7c8a986f4fb doc (chat): chat documentation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
25
1633
7a97408f32bb doc (user/chat): Document header and data policy:
Goffi <goffi@goffi.org>
parents: 1629
diff changeset
26
7a97408f32bb doc (user/chat): Document header and data policy:
Goffi <goffi@goffi.org>
parents: 1629
diff changeset
27 Main Panel Header
7a97408f32bb doc (user/chat): Document header and data policy:
Goffi <goffi@goffi.org>
parents: 1629
diff changeset
28 -----------------
7a97408f32bb doc (user/chat): Document header and data policy:
Goffi <goffi@goffi.org>
parents: 1629
diff changeset
29
7a97408f32bb doc (user/chat): Document header and data policy:
Goffi <goffi@goffi.org>
parents: 1629
diff changeset
30 The main panel header displays information about the current conversation.
7a97408f32bb doc (user/chat): Document header and data policy:
Goffi <goffi@goffi.org>
parents: 1629
diff changeset
31
7a97408f32bb doc (user/chat): Document header and data policy:
Goffi <goffi@goffi.org>
parents: 1629
diff changeset
32 On the left side of the header, you'll find a button to toggle the visibility of the left
7a97408f32bb doc (user/chat): Document header and data policy:
Goffi <goffi@goffi.org>
parents: 1629
diff changeset
33 panel. Next to this button is the identifier (JID) of the conversation recipient. This
7a97408f32bb doc (user/chat): Document header and data policy:
Goffi <goffi@goffi.org>
parents: 1629
diff changeset
34 recipient can be a single user or a group chat room.
7a97408f32bb doc (user/chat): Document header and data policy:
Goffi <goffi@goffi.org>
parents: 1629
diff changeset
35
7a97408f32bb doc (user/chat): Document header and data policy:
Goffi <goffi@goffi.org>
parents: 1629
diff changeset
36 When available, a "Data Policy" badge may appear next to the JID. This badge indicates the
7a97408f32bb doc (user/chat): Document header and data policy:
Goffi <goffi@goffi.org>
parents: 1629
diff changeset
37 privacy and data practices of the service associated with the recipient. The badge is
7a97408f32bb doc (user/chat): Document header and data policy:
Goffi <goffi@goffi.org>
parents: 1629
diff changeset
38 scored on a scale of ten and uses the following color scheme:
7a97408f32bb doc (user/chat): Document header and data policy:
Goffi <goffi@goffi.org>
parents: 1629
diff changeset
39
7a97408f32bb doc (user/chat): Document header and data policy:
Goffi <goffi@goffi.org>
parents: 1629
diff changeset
40 - **Green:** Indicates good data practices and respect for privacy.
7a97408f32bb doc (user/chat): Document header and data policy:
Goffi <goffi@goffi.org>
parents: 1629
diff changeset
41 - **Yellow:** Indicates a moderate score – data practices are neither good nor bad.
7a97408f32bb doc (user/chat): Document header and data policy:
Goffi <goffi@goffi.org>
parents: 1629
diff changeset
42 - **Red:** Indicates poor data practices and potential privacy concerns.
7a97408f32bb doc (user/chat): Document header and data policy:
Goffi <goffi@goffi.org>
parents: 1629
diff changeset
43
7a97408f32bb doc (user/chat): Document header and data policy:
Goffi <goffi@goffi.org>
parents: 1629
diff changeset
44 Hovering or touching the Data Policy badge will open a report panel with more detailed
7a97408f32bb doc (user/chat): Document header and data policy:
Goffi <goffi@goffi.org>
parents: 1629
diff changeset
45 information about the service's data handling.
7a97408f32bb doc (user/chat): Document header and data policy:
Goffi <goffi@goffi.org>
parents: 1629
diff changeset
46
7a97408f32bb doc (user/chat): Document header and data policy:
Goffi <goffi@goffi.org>
parents: 1629
diff changeset
47
1621
d7c8a986f4fb doc (chat): chat documentation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
48 Threads and Replies
d7c8a986f4fb doc (chat): chat documentation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
49 -------------------
d7c8a986f4fb doc (chat): chat documentation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
50
1626
00abe08875f5 doc (user/chat): Add documentation for keywords handling:
Goffi <goffi@goffi.org>
parents: 1621
diff changeset
51 In a message, you'll see a "Reply" button represented by a left-pointing arrow. Click
1621
d7c8a986f4fb doc (chat): chat documentation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
52 it to reply to a specific message. This action creates a thread, which functions as a
d7c8a986f4fb doc (chat): chat documentation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
53 focused discussion within the main conversation or a series of replies on the same topic.
d7c8a986f4fb doc (chat): chat documentation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
54
d7c8a986f4fb doc (chat): chat documentation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
55 When a thread exists, a chat bubble icon with three dots will appear in the message
d7c8a986f4fb doc (chat): chat documentation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
56 header, next to the timestamp. Hovering over this icon highlights all messages in the
1626
00abe08875f5 doc (user/chat): Add documentation for keywords handling:
Goffi <goffi@goffi.org>
parents: 1621
diff changeset
57 thread. Clicking it opens a submessage panel containing all messages from that thread.
1621
d7c8a986f4fb doc (chat): chat documentation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
58 Messages written in this panel will be posted as replies to the thread.
1626
00abe08875f5 doc (user/chat): Add documentation for keywords handling:
Goffi <goffi@goffi.org>
parents: 1621
diff changeset
59
00abe08875f5 doc (user/chat): Add documentation for keywords handling:
Goffi <goffi@goffi.org>
parents: 1621
diff changeset
60 Keywords
00abe08875f5 doc (user/chat): Add documentation for keywords handling:
Goffi <goffi@goffi.org>
parents: 1621
diff changeset
61 --------
00abe08875f5 doc (user/chat): Add documentation for keywords handling:
Goffi <goffi@goffi.org>
parents: 1621
diff changeset
62
00abe08875f5 doc (user/chat): Add documentation for keywords handling:
Goffi <goffi@goffi.org>
parents: 1621
diff changeset
63 Chat messages can have "keywords", which may help to categorize them. They can, for
00abe08875f5 doc (user/chat): Add documentation for keywords handling:
Goffi <goffi@goffi.org>
parents: 1621
diff changeset
64 instance, be added by an email gateway or a bot.
00abe08875f5 doc (user/chat): Add documentation for keywords handling:
Goffi <goffi@goffi.org>
parents: 1621
diff changeset
65
00abe08875f5 doc (user/chat): Add documentation for keywords handling:
Goffi <goffi@goffi.org>
parents: 1621
diff changeset
66 When present, these keywords will appear under the message. Clicking on one of these
00abe08875f5 doc (user/chat): Add documentation for keywords handling:
Goffi <goffi@goffi.org>
parents: 1621
diff changeset
67 keywords will show a submessage panel on the right side, where you'll see only messages
00abe08875f5 doc (user/chat): Add documentation for keywords handling:
Goffi <goffi@goffi.org>
parents: 1621
diff changeset
68 with this keyword. If you write a message in this panel, the keyword will be automatically
00abe08875f5 doc (user/chat): Add documentation for keywords handling:
Goffi <goffi@goffi.org>
parents: 1621
diff changeset
69 added to the message.
1629
961468588131 doc (chat): Add documentation for message origin:
Goffi <goffi@goffi.org>
parents: 1626
diff changeset
70
961468588131 doc (chat): Add documentation for message origin:
Goffi <goffi@goffi.org>
parents: 1626
diff changeset
71 Origin
961468588131 doc (chat): Add documentation for message origin:
Goffi <goffi@goffi.org>
parents: 1626
diff changeset
72 ------
961468588131 doc (chat): Add documentation for message origin:
Goffi <goffi@goffi.org>
parents: 1626
diff changeset
73
961468588131 doc (chat): Add documentation for message origin:
Goffi <goffi@goffi.org>
parents: 1626
diff changeset
74 If a message originates from a gateway to another protocol (e.g., email, SMS,
961468588131 doc (chat): Add documentation for message origin:
Goffi <goffi@goffi.org>
parents: 1626
diff changeset
75 ActivityPub), a label will indicate its origin. Clicking this label displays a submessage
961468588131 doc (chat): Add documentation for message origin:
Goffi <goffi@goffi.org>
parents: 1626
diff changeset
76 panel showing only messages from this source. If a message was generated by a bot (i.e.,
961468588131 doc (chat): Add documentation for message origin:
Goffi <goffi@goffi.org>
parents: 1626
diff changeset
77 an automated program), a corresponding label will appear.