Compare commits
3 Commits
master
...
XMPP_Updat
Author | SHA1 | Date |
---|---|---|
Fede.- | e540febabb | |
Fede.- | 36521b183b | |
Fede.- | 4bfbbc9056 |
|
@ -14,10 +14,8 @@ content:
|
|||
|
||||
The main goal of this site is to help you find your way around the various **Disroot** services.
|
||||
|
||||
We aim to cover all the services, with all its **Disroot**'s provided features, for all platforms and/or Operating Systems as well as the largest possible number of clients for the most widely used devices.
|
||||
To cover all the services, with all its **Disroot**'s provided features, for all platforms and/or Operating Systems it's a very ambitious and time consuming project that requires a lot of work. And because we think it could be beneficial not only for our users (disrooters) but the entire **Free Software** and **Open Source** communities running the same or similar software, any help from disrooters is always needed and welcome.<br>
|
||||
So, if you think there's a missing tutorial, the information is not accurate or could be improved, please contact us and (even better) start writing a how-to yourself.<br>
|
||||
|
||||
It is a very ambitious and time consuming project that requires a lot of work. But since we think it could be beneficial not only for our users (disrooters) but for all **Free Software** and **Open Source** communities running the same or similar software, we also think it is worthwhile. Because of that, any help is always needed and welcome.
|
||||
To know the different ways you can contribute, please check this [section](/contribute).
|
||||
|
||||
So, if you think there's a missing tutorial, the information is not accurate or could be improved, please contact us and (even better) start writing a how-to yourself.
|
||||
|
||||
To know the different ways you can contribute, please check this [**section**](/contribute).
|
||||
|
|
|
@ -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)
|
||||
|
||||
|
|
After Width: | Height: | Size: 45 KiB |
Before Width: | Height: | Size: 10 KiB After Width: | Height: | Size: 6.3 KiB |
After Width: | Height: | Size: 3.8 KiB |
After Width: | Height: | Size: 583 B |
After Width: | Height: | Size: 603 B |
After Width: | Height: | Size: 368 B |
After Width: | Height: | Size: 25 KiB |
After Width: | Height: | Size: 14 KiB |
After Width: | Height: | Size: 531 B |
After Width: | Height: | Size: 20 KiB |
After Width: | Height: | Size: 88 KiB |
After Width: | Height: | Size: 86 KiB |
After Width: | Height: | Size: 239 KiB |
After Width: | Height: | Size: 9.4 KiB |
After Width: | Height: | Size: 44 KiB |
|
@ -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.
|
|
@ -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.
|
Before Width: | Height: | Size: 333 KiB After Width: | Height: | Size: 333 KiB |
Before Width: | Height: | Size: 70 KiB After Width: | Height: | Size: 70 KiB |
Before Width: | Height: | Size: 76 KiB After Width: | Height: | Size: 76 KiB |
Before Width: | Height: | Size: 102 KiB After Width: | Height: | Size: 102 KiB |
Before Width: | Height: | Size: 359 KiB After Width: | Height: | Size: 359 KiB |
Before Width: | Height: | Size: 30 KiB After Width: | Height: | Size: 30 KiB |
Before Width: | Height: | Size: 72 KiB After Width: | Height: | Size: 72 KiB |
Before Width: | Height: | Size: 283 KiB After Width: | Height: | Size: 283 KiB |
Before Width: | Height: | Size: 200 KiB After Width: | Height: | Size: 200 KiB |
Before Width: | Height: | Size: 789 B After Width: | Height: | Size: 789 B |
Before Width: | Height: | Size: 24 KiB After Width: | Height: | Size: 24 KiB |
Before Width: | Height: | Size: 76 KiB After Width: | Height: | Size: 76 KiB |
Before Width: | Height: | Size: 8.8 KiB After Width: | Height: | Size: 8.8 KiB |
Before Width: | Height: | Size: 8.2 KiB After Width: | Height: | Size: 8.2 KiB |
Before Width: | Height: | Size: 2.9 KiB After Width: | Height: | Size: 2.9 KiB |
Before Width: | Height: | Size: 54 KiB After Width: | Height: | Size: 54 KiB |
Before Width: | Height: | Size: 95 KiB After Width: | Height: | Size: 95 KiB |
Before Width: | Height: | Size: 4.2 KiB After Width: | Height: | Size: 4.2 KiB |
Before Width: | Height: | Size: 770 B After Width: | Height: | Size: 770 B |
Before Width: | Height: | Size: 533 B After Width: | Height: | Size: 533 B |
Before Width: | Height: | Size: 822 B After Width: | Height: | Size: 822 B |
Before Width: | Height: | Size: 573 B After Width: | Height: | Size: 573 B |
Before Width: | Height: | Size: 785 B After Width: | Height: | Size: 785 B |
Before Width: | Height: | Size: 4.6 KiB After Width: | Height: | Size: 4.6 KiB |
Before Width: | Height: | Size: 67 KiB After Width: | Height: | Size: 67 KiB |
Before Width: | Height: | Size: 74 KiB After Width: | Height: | Size: 74 KiB |
Before Width: | Height: | Size: 3.3 KiB After Width: | Height: | Size: 3.3 KiB |
Before Width: | Height: | Size: 56 KiB After Width: | Height: | Size: 56 KiB |
Before Width: | Height: | Size: 1.9 KiB After Width: | Height: | Size: 1.9 KiB |
Before Width: | Height: | Size: 15 KiB After Width: | Height: | Size: 15 KiB |
Before Width: | Height: | Size: 9.6 KiB After Width: | Height: | Size: 9.6 KiB |
Before Width: | Height: | Size: 16 KiB After Width: | Height: | Size: 16 KiB |
Before Width: | Height: | Size: 41 KiB After Width: | Height: | Size: 41 KiB |
Before Width: | Height: | Size: 93 KiB After Width: | Height: | Size: 93 KiB |
Before Width: | Height: | Size: 47 KiB After Width: | Height: | Size: 47 KiB |
Before Width: | Height: | Size: 94 KiB After Width: | Height: | Size: 94 KiB |
Before Width: | Height: | Size: 22 KiB After Width: | Height: | Size: 22 KiB |
Before Width: | Height: | Size: 45 KiB After Width: | Height: | Size: 45 KiB |
Before Width: | Height: | Size: 106 KiB After Width: | Height: | Size: 106 KiB |
Before Width: | Height: | Size: 122 KiB After Width: | Height: | Size: 122 KiB |
Before Width: | Height: | Size: 15 KiB After Width: | Height: | Size: 15 KiB |
Before Width: | Height: | Size: 83 KiB After Width: | Height: | Size: 83 KiB |
Before Width: | Height: | Size: 27 KiB After Width: | Height: | Size: 27 KiB |
Before Width: | Height: | Size: 15 KiB After Width: | Height: | Size: 15 KiB |
Before Width: | Height: | Size: 25 KiB After Width: | Height: | Size: 25 KiB |
Before Width: | Height: | Size: 16 KiB After Width: | Height: | Size: 16 KiB |
Before Width: | Height: | Size: 2.9 KiB After Width: | Height: | Size: 2.9 KiB |
Before Width: | Height: | Size: 8.8 KiB After Width: | Height: | Size: 8.8 KiB |
Before Width: | Height: | Size: 14 KiB After Width: | Height: | Size: 14 KiB |
Before Width: | Height: | Size: 9.6 KiB After Width: | Height: | Size: 9.6 KiB |
Before Width: | Height: | Size: 182 KiB After Width: | Height: | Size: 182 KiB |
Before Width: | Height: | Size: 25 KiB After Width: | Height: | Size: 25 KiB |
Before Width: | Height: | Size: 153 KiB After Width: | Height: | Size: 153 KiB |
Before Width: | Height: | Size: 16 KiB After Width: | Height: | Size: 16 KiB |
Before Width: | Height: | Size: 130 KiB After Width: | Height: | Size: 130 KiB |
Before Width: | Height: | Size: 109 KiB After Width: | Height: | Size: 109 KiB |
Before Width: | Height: | Size: 187 KiB After Width: | Height: | Size: 187 KiB |
Before Width: | Height: | Size: 279 KiB After Width: | Height: | Size: 279 KiB |
Before Width: | Height: | Size: 93 KiB After Width: | Height: | Size: 93 KiB |
Before Width: | Height: | Size: 195 KiB After Width: | Height: | Size: 195 KiB |
Before Width: | Height: | Size: 109 KiB After Width: | Height: | Size: 109 KiB |
Before Width: | Height: | Size: 114 KiB After Width: | Height: | Size: 114 KiB |
Before Width: | Height: | Size: 117 KiB After Width: | Height: | Size: 117 KiB |
Before Width: | Height: | Size: 77 KiB After Width: | Height: | Size: 77 KiB |
Before Width: | Height: | Size: 65 KiB After Width: | Height: | Size: 65 KiB |
Before Width: | Height: | Size: 241 KiB After Width: | Height: | Size: 241 KiB |
Before Width: | Height: | Size: 56 KiB After Width: | Height: | Size: 56 KiB |
Before Width: | Height: | Size: 6.0 KiB After Width: | Height: | Size: 6.0 KiB |
Before Width: | Height: | Size: 31 KiB After Width: | Height: | Size: 31 KiB |
Before Width: | Height: | Size: 57 KiB After Width: | Height: | Size: 57 KiB |