Converse Howto

pages/02.tutorials/04.Chat/01.Webchat/docs.en.md

@@ -4,64 +4,93 @@ published: true
 visible: true
 indexed: true
 updated:
-        last_modified: "11 April 2019"
+        last_modified: "September 2021"
         app: Converse.js
-        app_version: 4.2.0
+        app_version: 7.0.3dev
 taxonomy:
     category:
         - docs
     tags:
         - chat
         - xmpp
+        - converse
 page-toc:
     active: true
 ---
 
 ![](en/converse.png)
-Converse is a free and open-source XMPP chat client that runs in a web browser and<br>**[webchat.disroot.org](https:webchat.disroot.org)** provides a way to connect to your XMPP account through it.
+
+**Converse.js** is a free and open-source XMPP chat client that runs in the web browser. You can use your **Disroot** account to connect to XMPP through **[webchat.disroot.org](https:webchat.disroot.org)**.
 
 # Connecting
-Open your favorite web browser and go to **[webchat.disroot.org](https://webchat.disroot.org)**
+Open a web browser and go to **[webchat.disroot.org](https://webchat.disroot.org)**
 
-![](en/01_connexion.png)
-1. **XMPP Address**: *Your_Disroot_email*
-2. **Password:** *Your_super_secret_Disroot_password*
+![](en/connect.png)
+
+1. **XMPP Address**: Enter your **Disroot** email address
+2. **Password:** Type your **Disroot** password
 3. **This is a trusted device**: Uncheck this box if you're not on your own computer.
 
 # User Interface
-Once you've logged in, you may see something like this:
+Once you have logged in, you will see something like this:
 
-![](en/02_ui.png)
-1. Your personnal details
-2. The list of chat rooms you're logged in and your bookmarked rooms
-3. The current room information
-4. The current room participants
-5. The current room features/configuration
-6. The current room on-going discussion
-7. The message editor
+![](en/ui_general.png)
+
+1. **Your personal details**
+
+![](en/ui_user.png)
+
+   - a. **Settings**: here you can check the **Converse.js** version and enter ad-hoc commands
+   - b. **Logout** button
+   - c. **Your online status**: you can select a status and/or write your own personal status message
+
+2. **Groupchats**: The list of chat rooms you're logged in
+3. **Bookmarks**: Your bookmarked rooms
+4. **Contacts**: Your XMPP contacts
+5. **Chat room**: The current room
+   - a. From the three-lines menu at the right you can unbookmark the room, view its general details, invite someone to join, hide the topic or leave the chat.
+
+![](en/ui_options.png)
+
+6. The current ongoing chat
+7. **Participants**: The participants of the room
+8. The message box
+
+![](en/message_box.png)
 
 # Rooms
-You can participate in group discussions, also called groupchats or rooms.
+You can participate in group discussions, also called "groupchats" or "rooms".
 
 ## Entering a room
+To join or create a room, just click on the **+** button, in the **Groupchat** section.
+![](en/rooms_entering.gif)
 
-![](en/03_enter.png)
-1. Click on this button to join or create a room.
-2. **Groupchat address**: Enter the address of the room you want to join. It can be a room from any XMPP server that federates. For example, if you want to join a room on **Disroot** server, add ```chat.disroot.org``` after the room name. In this image, the user is trying to join the room called ```mytestroom``` on *chat.disroot.org* XMPP server.
-3. **Nickname**: you are free to enter whatever username you wish, it doesn't have to be your real **Disroot** username. You can then have a different username on each room you're in if you want.
-4. **Join** the room by clicking here.
+![](en/rooms_add.png)
+
+1. **Groupchat address**: Here goes the address of the room you want to join. It can be the address of any room from any XMPP server that federates.<br>For example: if you want to join a room hosted on the **Disroot** server, you will need to type ```chat.disroot.org```.
+   
+2. **Nickname**: It is the alias you want to use. It doesn't have to be your real **Disroot** username. You can have different usernames for each room you're in if you want.
+
+3. **Join**: Click here to join the room.
 
 ## Sending messages
+To send a message, just type it in the message box and then press Enter.
 
-![](en/05_send.png)
-1. Type your message here.
-2. With two buttons, you can add an emoji or share a file (it can be any type of file, maximum size being 10MB)
-3. Click on **Send** when you're done writing your message.
+![](en/message_sending.gif)
 
-!! ![](/home/icons/note.png)
-!! NOTE: Shift + Enter will allow you to add a line break.
+There are four buttons in the message box:
 
-You can mention people in your message so they get a notification. Just click on their nickname in the participants list, or add it manually if you know it. You can also start to write its first letters and tap on the tab key of your keyboard to have a suggestion list of nicknames.
+![](en/message_options.gif)
+
+||||
+|:---:|:---|:---:|:---|
+|![](en/message_emojis.png)| To insert emojis|![](en/message_spoiler.png)| To write your message as a spoiler|
+|![](en/message_files.png)| To share a file (it can be any type of file, the maximum size is 10MB)|![](en/message_omemo.png)| To enable/disable OMEMO encryption|
+
+!! **TIP:** To insert a line break in a message, press ```Shift``` + ```Enter```.
+
+## Mentions
+You can "mention" people in your message so they get a notification. Start to write the first letters and tap on the tab key of your keyboard to have a suggestion list of nicknames.
 
 ![](en/06_mention.gif)
 

pages/02.tutorials/04.Chat/docsparent.en.md

@@ -11,13 +11,11 @@ page-toc:
     active: false
 ---
 
-## What is XMPP?
-
 ![](en/xmpp_logo.png)
 
-XMPP (Extensible Messaging and Presence Protocol) is: "*a set of open technologies for instant messaging, presence, multi-party chat, voice and video calls, collaboration, lightweight middleware, content syndication, and generalized routing of XML data.*"
+# What is XMPP?
 
-XMPP provides an open and decentralized alternative to closed instant messaging services. XMPP protocol offers a lot of advantages:
+XMPP (Extensible Messaging and Presence Protocol) is: "*a set of open technologies for instant messaging, presence, multi-party chat, voice and video calls, collaboration, lightweight middleware, content syndication, and generalized routing of XML data.*" It provides an open and decentralized alternative to closed instant messaging services and offers a lot of advantages:
 
 * It's **Open** (which means is free, open, public, and easily understandable)
 * It's a **Standard** (approved by the [IETF](http://www.ietf.org/))
@@ -26,3 +24,5 @@ XMPP provides an open and decentralized alternative to closed instant messaging
 * It's **Extensible** (anyone can build custom functionality on top of the core protocols (common extensions are published in the XEP series)
 
 ... among other features.
+
+In the following guides you can find information about how to configure and use your **Disroot** account with different clients and devices.

pages/02.tutorials/04.Chat/docsparent.es.md

@@ -11,13 +11,11 @@ page-toc:
     active: false
 ---
 
-## ¿Qué es XMPP?
-
 ![](en/xmpp_logo.png)
 
-XMPP (*siglas en inglés de* Protocolo extensible de mensajería y comunicación de presencia) es: "*un conjunto de tecnologías abiertas para mensajería instantánea, presencia, chat en grupos, llamadas de voz y video, colaboración, software intermediario liviano, redifusión de contenidos, y ruteo generalizado de datos XML.*"|
+# ¿Qué es XMPP?
 
-XMPP proporciona una alternativa abierta y descentralizada a los servicios cerrados de mensajería instantánea. El protocolo XMPP ofrece un montón de ventajas:
+XMPP (*siglas en inglés para* Protocolo Extensible de Mensajería y comunicación de Presencia) es: "*un conjunto de tecnologías abiertas para mensajería instantánea, presencia, chat en grupos, llamadas de voz y video, colaboración, software intermediario liviano, redifusión de contenidos, y ruteo generalizado de datos XML.*" Proporciona una alternativa abierta y descentralizada a los servicios cerrados de mensajería instantánea y ofrece un montón de ventajas:
 
 * Es **Abierto** (lo que significa que es libre, abierto, público y fácilmente comprensible)
 * Es un **Estándar** (aprobado por la [IETF](http://www.ietf.org/))
@@ -26,3 +24,5 @@ XMPP proporciona una alternativa abierta y descentralizada a los servicios cerra
 * Es **Extensible** (cualquiera puede construir funcionalidades a su medida encima de los protocolos principales (las extensiones más comunes son publicadas en las series XEP)
 
 ... entre otras características.
+
+En las siguientes guías puedes encontrar información sobre cómo configurar y utilizar tu cuenta de **Disroot** con diferentes clientes y dispositivos.