Paramètres
Cette section décrit la page de configuration du plugin.
Conditions d’utilisation du tchat de la chaîne
Vous pouvez configurer un message de “conditions d’utilisation” qui sera affiché aux utilisateur⋅rices qui rejoignent vos salons de discussion.
Pour plus d’informations sur cette fonctionnalité, veuillez vous référer à la documentation des conditions d’utilisations de la chaîne.
La modification de ce paramètre redémarre le serveur de tchat et tous les utilisateur⋅rices seront déconnecté⋅es pendant une courte période.
Lister les salons de tchat existants
Lorsque vous appuyez sur le bouton “Lister les salles”, toutes les salles de chat existantes sont listées. Vous pouvez alors les trouver et les modérer.
Fédération
Les paramètres suivants concernent la fédération avec d’autres instances Peertube et d’autres logiciels du fediverse.
Ne pas afficher les tchats distants
En cochant ce paramètre, votre instance n’affichera jamais les tchats sur les vidéos distantes.
Ne pas publier les informations de tchats
En cochant ce paramètre, votre instance ne publiera pas les informations de tchat sur le fédivers.
Les instances Peertube distantes ne sauront pas qu’un tchat est associé aux vidéos.
Attention : si vous aviez déjà des tchats en cours, il est possible que les informations aient déjà été publiées.
Il faudra attendre la prochaine mise à jour des vidéos pour que les informations soient dépubliées.
De même, si vous désactivé ce paramètre, il faudra attendre que les vidéos soient mises à jour pour à nouveau
publier les informations. Cette mise à jour intervient entre autre quand un live reprend ou s’arrête.
Attention : ce paramètre ne joue que sur la publication d’informations via le protocole ActivityPub. Il n’empêchera
pas une application distante de détecter autrement la présence de tchat, et de tenter de s’y connecter.
Authentification
Désactiver les jetons livechat
Si vous avez des problèmes avec les jetons d’authentification à long terme, vous pouvez désactiver cette fonctionnalité ici.
Authentification externe
Voir la page de documentation détaillée :
Configuration avancée de la chaîne
Les paramètres suivants concernent les options de chaîne avancées : les utilisateur⋅rices pourront personnaliser leurs chaînes, activer le bot de modération, …
Désactiver la configuration avancée des chaînes et le bot de modération
Si vous rencontrez un problème avec cette fonctionnalité, vous pouvez la désactiver.
Comportement en chat
Type de salon
Vous pouvez choisir d’avoir des salons séparés pour chaque vidéo, ou de les grouper par chaîne.
Ouvrir automatiquement le tchat
Quand on regarde une vidéo, le tchat va automatiquement s’ouvrir.
Montrer le bouton «ouvrir dans une nouvelle fenêtre»
Il y aura un bouton pour ouvrir le tchat dans une nouvelle fenêtre.
Montrer le bouton «partager le lien du salon»
Cette fonctionnalité permet d’activer une fenêtre modale “partager le lien du chat”. Avec cette modale, vous pouvez générer des URL pour rejoindre le tchat. Le tchat peut être personnalisé (mode lecture seule, utilisation du thème actuel, …).
Vous pouvez par exemple générer une URL en lecture seule et l’utiliser dans OBS pour intégrer le chat dans votre flux en direct !
Ce paramètre vous permet de choisir qui peut accéder à cette fenêtre modale.
Les utilisateur⋅rices peuvent activer le tchat pour leurs directs
Si coché, il y aura pour tous les directs une case à cocher dans les propriétés qui permettra d’activer/désactiver le tchat.
Le⋅a propriétaire de la vidéo pourra activer le tchat en ligne.
Activer le tchat pour tous les directs
Si coché, il y aura un tchat pour tous les directs.
Activer le tchat pour toutes les vidéos «non-direct»
Activer le tchat pour toutes les vidéos «non-direct»
Activer le tchat pour ces vidéos
Activer le tchat pour ces vidéos
Masquer les tchats pour les utilisateur⋅rices anonymes
Si coché, les utilisteur⋅rices non connecté⋅es ne verront pas les tchats. Cette fonctionnalité est encore expérimentale. Si vous l’avez activée, il est hautement recommandé d’également cocher «Ne pas publier les informations de tchats». Sinon certains outils tierces ne pourraient tenter d’ouvrir le tchat, et auraient des résultats imprédictibles.
Note : pour l’instant, c’est fonctionnalité masque simplement le tchat. Dans une future version, le tchat sera remplacé par un message précisant «merci de vous connecter […]». Voir les notes de publication de la version 5.7.0 pour plus d’informations.
Bannir l’IP des utilisateur⋅rices anonymes, quand iels sont banni⋅es des salons
En activant cette option, à chaque fois qu’un⋅e utilisateur⋅rice anonyme est banni⋅e d’un salon, son IP sera également bannie du serveur de tchat. Attention : si votre instance est ouverte aux inscriptions, un⋅e utilisateur⋅rice pourrait créer un salon piégé, y inviter des personnes, et automatiquement bannir les IPs des utilisateur⋅rices anonymes. La liste des IPs bannie n’est pas enregistrée, et sera effacée au redémarrage du serveur, ou si vous changez certains paramètres du plugin. Les IPs bannies sont journalisées dans les journaux du serveur Prosody, donc les admins du serveur peuvent éventuellement utiliser des outils externes (comme par exemple fail2ban) pour bannir les IPs plus largement.
Note importante : Si vous activez cette fonctionnalité, et que vous utilisez un reverse proxy personnalisé devant Peertube, merci de vous assurer que vous avez correctement configuré celui-ci pour faire suivre les IPs réelles des utilisateur⋅rices à Peertube. Sinon cela pourrait bloquer tous les utilisateur⋅rices anonymes d’un coup.
Personnalisation de l’apparence
Jeu d’avatars
Vous pouvez choisir parmi plusieurs jeux différents les avatars par défaut qui seront utilisés pour les utilisateurs du tchat.
Sepia (mascotte Peertube) : Générateur d’avatars Peertube de David Revoy, Licence CC-By
Chats : Générateur d’avatar de chat de David Revoy, Licence CC-By
Oiseaux : Générateur d’avatar d’oiseaux de David Revoy, Licence CC-By
Fennecs (mascotte Mobilizon) : Générateur d’avatar fénnec/mobilizon de David Revoy, licence CC-By
Abstrait : Générateur d’avatar abstrait de David Revoy, licence CC-By
Anciens avatars Sepia (ceux inclus dans les versions précédentes du plugin) : Basé sur le travail de David Revoy, licence AGPL-v3
Si vous ne voyez pas le changement immédiatement, cela peut être dû au cache de votre navigateur. Effacez le stockage de session de votre navigateur ou redémarrez-le.
Thème ConverseJS
Vous pouvez choisir le thème à utiliser pour ConverseJS :
- Thème Peertube : il s’agit d’un thème spécial, conçu spécialement pour l’intégration dans Peertube.
- Thème ConverseJS par défaut : c’est le thème ConverseJS par défaut.
- Thème ConverseJS cyberpunk : il s’agit d’un thème fourni par ConverseJS.
Détection automatique des couleurs
Essaie de détecter automatiquement les couleurs du thème courant de l’utilisateur⋅rice.
Quand ce paramètre est activé, le plugin essaie de détecter automatiquement les couleurs à appliquer au thème du tchat.
Si cela ne fonctionne pas correctement pour certains de vos thèmes Peertube, vous pouvez désactiver cette option.
Vous pouvez rapporter les bugs sur le
gestionnaire de ticket
. N’oubliez pas de préciser pour quel thème cela ne fonctionne pas.
Attribut de style de l’iframe du tchat
Styles additionnels à appliquer sur l’iframe du tchat.
Exemple : height:400px;
Paramètres avancés du tchat
Utiliser le serveur Prosody installé sur le système
Le plugin est livré avec une AppImage qui est utilisée pour exécuter le
serveur XMPP Prosody. Si cet AppImage ne fonctionne
pas, vous pouvez vous rabattre sur la version de Prosody qui est packagé
pour votre serveur. Installez simplement le paquet prosody
.
Ce paramètre ne devrait être utilisé que si le plugin est cassé et en attente d’un correctif.
Désactiver Websocket
Avec Peertube >= 5.0.0, ce plugin va essayer d’utiliser Websocket pour les connexions au tchat.
Si le navigateur de l’utilisateur⋅rice ou sa connexion n’est pas compatible, le navigateur va automatiquement passer au protocole BOSH.
Mais, dans de rare cas, cela pourrait échouer. Par exemple si vous avez un reverse proxy devant votre Peertube
qui ne permettrait pas les connexions Websocket.
Dans ce cas, vous pouvez cocher cette option pour désactiver les connexions Websocket.
Port Prosody
Le port qui va être utilisé par le serveur Prosody.
Changez-le si ce port est déjà utilisé sur votre serveur.
Vous pouvez fermer ce port sur votre pare-feu, il ne sera pas accédé par le monde extérieur.
Note : cela pourrait changer dans un futur proche, car il est prévu d’ajouter des paramètres pour autoriser les connexions externes.
Url Peertube pour les appels d’API
Merci de ne pas toucher à ce paramètre si vous ne savez pas ce que vous faites.
Dans de rare cas, le serveur Prosody ne peut appeler l’API de Peertube en utilisant l’url publique.
Vous pouvez utiliser ce paramètre pour personnaliser l’url que les modules Prosody utiliseront pour
les API Peertube (par exemple, en mettant «http://localhost:9000» ou «http://127.0.0.1:9000»).
Si ce paramètre est laissé vide, et que vous utilisez Peertube >= 5.1, le plugin va utiliser les valeurs de votre fichier de configuration Peertube pour devenir sur quelle interface et quel port les requêtes doivent être faites.
En dernier recours, cela utilisera l’URI publique de votre instance. Donc
les appels d’API passeront à traver Nginx. Cela peut échouer dans certains
cas : par exemple si vous êtes dans un conteneur Docker pour lequel le
hostname publique ne résoud pas sur la bonne IP. Dans ce cas, essayez de
changer le paramètre “Url Peertube pour les appels d’API”, en
mettant http ://127.0.0.1 :9000
(si c’est bien le port 9000 qui est
utilisé par votre Peertube, demandez aux administrateur⋅rices de votre
instance si vous ne savez pas).
Enregistrer les salons par défaut
Si coché, le contenu des salons sera enregistré par défaut.
Quand un⋅e utilisateur⋅rice rejoint un salon, iel pourra voir ce qui a été dit avant.
À noter qu’il est toujours possible d’activer/désactiver cette fonctionnalité
pour un salon spécifique, en changeant ses paramètres.
Expiration des journaux de salon
Vous pouvez choisir combien de temps le contenu des salons est gardé sur le serveur. La valeur peut être :
- 60 : le contenu sera sauvegardé pour 60 secondes. Vous pouvez remplacer 60 par n'importe quelle valeur entière.
- 1d : le contenu sera sauvegardé pour 1 jour. Vous pouvez remplacer 1 par n'importe quelle valeur entière.
- 1w : le contenu sera sauvegardé pour 1 semaine. Vous pouvez remplacer 1 par n'importe quelle valeur entière.
- 1m : le contenu sera sauvegardé pour 1 mois. Vous pouvez remplacer 1 par n'importe quelle valeur entière.
- 1y : le contenu sera sauvegardé pour 1 année. Vous pouvez remplacer 1 par n'importe quelle valeur entière.
- never : le contenu ne sera jamais effacé.
Autoriser les connexions aux salons via des comptes XMPP externes
En activant cette option, il sera possible de se connecter aux salons en utilisant des comptes XMPP externes via des clients XMPP.
Attention, activer cette option peut demander une configuration au niveau du serveur et des enregistrements DNS.
Pour en savoir plus, merci de vous référer à la documentation:
Autoriser les connexions avec des comptes XMPP externes.
Port Prosody serveur vers serveur
Le port à utiliser pour les connexions XMPP s2s (server to server).
Il est recommandé d’utiliser le port standard 5269.
Sinon vous devrez configurer un enregistrement DNS spécifique
.
Interfaces réseau pour les connexions serveur vers serveur
Les interfaces réseau sur lesquelles écouter pour les connexions s2s (server to server).
Une liste d’IP séparées par des virgules (les espaces seront retirés).
On pourra utiliser «*» pour écouter sur toutes les IPv4, et «::» pour toutes les IPv6.
Exemples de configuration possible:
- *, ::
- *
- 127.0.0.1, ::1
- 172.18.0.42
Dossiers des certificats
Si ce champ est vide, le plugin va générer et utiliser des certificats auto-signés.
Si vous voulez utiliser d’autres certificats, vous avez juste à spécifier ici le dossier où
Prosody peut les trouver. Note : l’utilisateur «peertube» doit avoir un accès en lecture à ce dossier.
Activer les connexions client vers serveur
Autoriser les clients XMPP à se connecter au serveur Prosody.
Cette option seule n’autorise que les connexions de clients sur le localhost.
Ce paramètre permet aux clients XMPP de se connecter au serveur Prosody intégré. Pour l’instant, cette option n’autorise que les connexions des clients sur le localhost.
Par exemple, cette option peut permettre à une instance Matterbridge (une fois qu’elle pourra utiliser une connexion anonyme) sur la même machine de faire le lien entre votre tchat et d’autres services tels qu’une salle Matrix.
Port Prosody client vers serveur
Le port à utiliser pour les connexions XMPP c2s (client to server).
Les clients XMPP devront utiliser ce port pour se connecter.
Changez ce port si le port est déjà utilisé sur votre serveur.
Pour l’instant, vous pouvez garder ce port fermé sur votre pare-feu, il sera inaccessible depuis l’extérieur (Prosody n’écoute que le localhost).
Note : cela pourrait prochainement changer, car il est prévu d’ajouter une fonction permettant d’activer les connexions externes.
Interfaces réseau client vers serveur
Les interfaces réseau sur lesquelles écouter pour les connexions c2s (client to server).
Ce paramètre est fourni pour les utilisateur⋅ices avancé⋅es. Ne changez pas ce paramètre si vous ne comprenez pas entièrement ce que cela signifie.<br<
Une liste d’IP séparées par des virgules (les espaces seront retirés).
On pourra utiliser «*» pour écouter sur toutes les IPv4, et «::» pour toutes les IPv6.
Exemples de configuration possible:
- *, ::
- *
- 127.0.0.1, ::1
- 127.0.0.1, ::1, 172.18.0.42
Activer les composants externes personnalisés Prosody
Ce paramètre permet aux composants externes XMPP de se connecter au serveur. Par défaut cette option n’autorise que les connexions des composants sur localhost. Vous devez changer la valeur du paramètre «Interfaces réseau pour les composants Prosody externes» pour écouter sur d’autres interfaces réseau.
Cette fonction pourrait être utilisée pour connecter des ponts ou des robots.
Plus d’informations sur les composants externes de Prosody [ici] (https://prosody.im/doc/components).
Activer les composants externes personnalisés Prosody
Pour permettre l’utilisation de composants XMPP externes.
Cette option seule n’autorise que les connexions depuis le localhost.
Vous devez configurer les interfaces sur lesquelles écouter et ouvrir les ports sur votre pare-feu pour rendre cela disponible à des serveurs distants.
Cette fonctionnalité peut, par exemple, être utilisée pour connecter des bots aux salons.
Port pour les composants externe Prosody
Le port à utiliser pour les XMPP components.
Changez ce port s’il est déjà utilisé sur votre serveur.
Vous pouvez garder ce port fermé sur votre pare-feu si vous n’autorisez pas l’accès sur les interfaces autre que localhost.
Interfaces réseau pour les composants Prosody externes
Les interfaces réseau sur lesquelles écouter pour les composants externes.
Une liste d’IP séparées par des virgules (les espaces seront retirés).
On pourra utiliser «*» pour écouter sur toutes les IPv4, et «::» pour toutes les IPv6.
Exemples :
- *,::
- *
- 127.0.0.1,::1
- 172.18.0.42
Composants externes
Les composants externes à déclarer :
- Un par ligne.
- Utilisez le format «nom_du_composant:passphrase_secrete» (les espaces seront retirés).
- Vous pouvez ajouter des commentaires: tout ce qui se trouve après un caractère # sera retiré, et les lignes vides ignorées.
- Le nom ne peut contenir que des caractères alphanumériques latins et des points.
- Si le nom ne contient que des caractères alphanumériques, il sera suffixé avec le domaine XMPP. Par exemple, «bridge» deviendra «bridge.votre_domaine.tld». Vous pouvez aussi spécifier un nom de domaine complet, mais vous devrez vous assurer que votre configuration DNS est correcte.
- N'utilisez que des caractères alphanumériques dans la passphrase secrète (utilisez au moins 15 caractères).
Activer mod_firewall pour Prosody
You can enable mod_firewall on your Prosody server.
For more information, please check the documentation.