Merge f852193d73 into 75e44c124a

pages/02.administer/15.admin_guide/40.xmpp/xmpp.fr.md

@@ -23,6 +23,30 @@ Sous YunoHost, un compte XMPP est créé automatiquement pour chaque utilisateur
 
 Si vous souhaitez en savoir plus sur l'utilisation de XMPP, référez-vous au [Guide de l'utilisateur](/XMPP).
 
+## Configuration manuelle
+### Configurer le service BOSH
+BOSH est une fonctionnalité requise pour que d'autres logiciels comme Conversejs ou JSXC (le client XMPP client pour NextCloud), puissent accéder à votre serveur XMPP.
+
+Le module Metronome est déjà activé par défaut. Vous avez simplement besoin d'installer une application vide pour rendre le service BOSH accessible depuis l'extérieur, ceci en installant l'application Redirect : `yunohost app install redirect -a "domain=your.domain&path=/http-bind&redirect_path=http://localhost:5290/http-bind&redirect_type=public_proxy" -l BOSH`
+
+Sources : 
+- https://forum.yunohost.org/t/unable-to-set-up-bosh-conf-nginx/12995 (anglais)
+- https://forum.yunohost.org/t/configure-xmpp-in-nextcloud-addon-javascript-xmpp-client/2934/4?u=ashledombos (anglais)
+
+### Configurer le service TURN/STUN
+Ce service est nécessaire pour être capable de prendre part à des appels audio ou vidéo, par exemple dans l'application Android Conversations.
+Des [instructions pour sa configuration](https://github.com/YunoHost/issues/issues/1607) sont disponibles (anglais).
+
+### Étendre la compatibilité à davantage de types de fichiers (MIME).  
+Par défaut, beaucoup de types de fichiers ne peuvent pas être transférés en utilisant ce serveur.
+Pour être en mesure d'en utiliser d'autres, il faut ajouter au fichier de configuration XMPP pour votre domaine situé dans `/etc/metronome/conf.d/` la ligne suivante:
+```
+http_file_add_mime_types = { ["txt"] = "text/plain", ["png"] = "image/png",["jpg"] = "image/jpg", ["pdf"] = "application/pdf", ["doc"] = "application/msword", ["htm"] = "text/html",  ["html"] = "text/html", ["mp3"] = "audio/mpeg3", ["gif"] = "image/gif", ["mp4"] = "video/mp4", ["mpeg"] = "video/mpeg", ["m4a"] = "audio/m4a", ["ogg"] = "application/ogg", ["gpx"] = "application/gpx+xml", ["vcf"] = "text/vcard", ["ics"] = "text/calendar", ["sxw"] = "application/vnd.sun.xml.writer", ["stw"] = "application/vnd.sun.xml.writer.template", ["sxg"] = "application/vnd.sun.xml.writer.global", ["sdw"] = "application/vnd.stardivision.writer", ["vor"] = "application/vnd.stardivision.writer", ["sgl"] = "application/vnd.stardivision.writer-global", ["sxc"] = "application/vnd.sun.xml.calc", ["stc"] = "application/vnd.sun.xml.calc.template", ["sdc"] = "application/vnd.stardivision.calc", ["sxi"] = "application/vnd.sun.xml.impress", ["sti"] = "application/vnd.sun.xml.impress.template", ["sdd"] = "application/vnd.stardivision.impress", ["sdp"] = "application/vnd.stardivision.impress", ["sxd"] = "application/vnd.sun.xml.draw", ["std"] = "application/vnd.sun.xml.draw.template", ["sda"] = "application/vnd.stardivision.draw", ["sxm"] = "application/vnd.sun.xml.math", ["smf"] = "application/vnd.stardivision.math", ["odt"] = "application/vnd.oasis.opendocument.text", ["ott"] = "application/vnd.oasis.opendocument.text-template", ["oth"] = "application/vnd.oasis.opendocument.text-web", ["odm"] = "application/vnd.oasis.opendocument.text-master", ["odg"] = "application/vnd.oasis.opendocument.graphics", ["otg"] = "application/vnd.oasis.opendocument.graphics-template", ["odp"] = "application/vnd.oasis.opendocument.presentation", ["otp"] = "application/vnd.oasis.opendocument.presentation-template", ["ods"] = "application/vnd.oasis.opendocument.spreadsheet", ["ots"] = "application/vnd.oasis.opendocument.spreadsheet-template", ["odc"] = "application/vnd.oasis.opendocument.chart", ["odf"] = "application/vnd.oasis.opendocument.formula", ["odb"] = "application/vnd.oasis.opendocument.database", ["odi"] = "application/vnd.oasis.opendocument.image" }
+```
+
+## Les limites de Metronome dans Yunohost
+- https://github.com/maranda/metronome/issues/549 (anglais)
+
 ## Incompatibilité avec Prosody
 
 Prosody, un serveur XMPP alternatif, est packagé pour YunoHost.
@@ -30,3 +54,4 @@ Prosody, un serveur XMPP alternatif, est packagé pour YunoHost.
 Il est notamment utilisé par le plugin de chat de Peertube, et Jitsi pour des vidéoconférences. Installer ces apps installera Prosody, qui nécessite de désactiver Metronome pour fonctionner.
 
 ! En résumé, installer Prosody ou une app en dépendant désactivera le serveur XMPP.
+! Un essai visant à remplacer Metronome par Prosody [a été documenté](https://sebseb01.net/blog/2023-poc-yunohost-metronome-prosody); ceci est toutefois communiqué à titre expérimental, et donc à utiliser à vos risques et périls!