diff --git a/docs/2.modules/24.salons-vocaux-temporaires.md b/docs/2.modules/24.salons-vocaux-temporaires.md index 07f35ae47..00e47cd98 100644 --- a/docs/2.modules/24.salons-vocaux-temporaires.md +++ b/docs/2.modules/24.salons-vocaux-temporaires.md @@ -2,8 +2,8 @@ title: Salons vocaux temporaires description: Les salons vocaux temporaires offrent la possibilité à vos membres de créer des salons qu'ils pourront personnaliser et configurer selon leurs goûts. navigation.icon: 'twemoji:speaker-high-volume' -contributors: ['tellvex', 'kazotka', 'theorik', 'elbaguetto', 'thecreatorn3ant', 'imroxxor', 'ls62', 'rababio4579'] -updatedAt: '2025-02-22' +contributors: ['tellvex', 'kazotka', 'theorik', 'elbaguetto', 'thecreatorn3ant', 'imroxxor', 'ls62', 'rababio4579', 'draftproducts'] +updatedAt: '2026-02-13' --- ## Utiliser des salons temporaires @@ -40,15 +40,23 @@ Lorsque vous créez un salon vocal, un embed apparaît dans le **salon textuel d Lorsqu'un membre ou un rôle est ajouté à la liste noire d'un salon temporaire, les personnes concernées sont automatiquement déconnectées. :: -- **Purge** : La purge permet de déconnecter tous les membres présents dans le salon à l'exception de ceux de la liste blanche, du propriétaire du salon, des modérateurs et administrateurs. +- **Exclure** : Cette fonction permet d'**exclure temporairement** un membre du salon vocal. Le membre exclu est immédiatement déconnecté et ne pourra pas rejoindre le salon jusqu'à la prochaine session. Ce bouton n'est disponible que lorsqu'une **sauvegarde est active**. Voir la section [Sauvegardes de configuration](#sauvegardes-de-configuration) pour plus de détails. + +- **Purge** : La purge permet de déconnecter tous les membres présents dans le salon à l'exception de ceux de la liste blanche, du propriétaire du salon, des modérateurs et administrateurs. Une confirmation avec la liste des membres concernés est affichée avant l'action. - **Micro** : Cette fonction permet d'activer/désactiver le micro de tous les participants du salon vocal. - **Vidéo** : Tout comme la fonction précédente, elle permet d'autoriser/refuser la permission d'utiliser la caméra ou le partage d'écran de tous les participants du salon vocal. - **Soundboard** : Cette fonction permet d'activer/désactiver l'utilisation des soundboards pour tous les participants du salon vocal. +- **Réglages** : Cette fonction ouvre un formulaire permettant de **modifier le nom** du salon vocal et la **limite de membres** (de 0 à 99, où 0 signifie aucune limite). Cela permet aux membres de personnaliser leur salon **sans avoir besoin de la permission "Modifier le salon"** dans les permissions du créateur, ni de l'**A2F** requise par Discord sur les serveurs communautaires. + +::hint{ type="warning" } + Discord limite les modifications de salon à **2 fois toutes les 10 minutes**. **DraftBot** affiche le nombre de modifications restantes et un délai d'attente si la limite est atteinte. +:: + - **Transférer la propriété** : Cette fonction permet de transférer les droits de gestion du salon vocal à quelqu'un d'autre. ::hint{ type="info" } - Si le propriétaire quitte le vocal, n'importe quel utilisateur peut récupérer la propriété en appuyant sur le bouton **Transférer la propriété**. + Si le propriétaire quitte le vocal et que la **réquisition de salon** est activée par un administrateur, n'importe quel utilisateur peut récupérer la propriété en appuyant sur le bouton **Transférer**. :: ::hint{ type="danger" } @@ -56,6 +64,8 @@ Lorsque vous créez un salon vocal, un embed apparaît dans le **salon textuel d Vous perdrez l'accès à l'embed de configuration du **salon vocal**. :: +- **Sauvegardes** <:icon_premium_:1096140508625125417> : Cette fonction permet de **sauvegarder** et **charger** des configurations complètes de salon vocal. Consultez la section [Sauvegardes de configuration](#sauvegardes-de-configuration) pour plus de détails. + ## Configuration du système @@ -415,13 +425,13 @@ Cette option vous permet de décider si les membres de la liste blanche ont la p - <:micro:1146811975280627783> **Micro** - <:video:1146811983870558298> **Vidéo** - <:soundboard:1146811981504970762> **Soundboards** -- <:icon_annonces:1130137007994196000> **Statut** +- <:status:1391998728415477771> **Statut** ::tabs ::tab{ label="Depuis la commande /config" } Exécuter la commande \, puis sélectionner depuis le menu déroulant `Salons vocaux temporaires` ➔ `Modifier un hub` ➔ `Permissions des membres en liste blanche`. - Vous pourrez ajouter ou retirer les trois permissions. + Vous pourrez ajouter ou retirer les quatre permissions. :: ::tab{ label="Depuis le panel" } @@ -435,13 +445,13 @@ Cette option vous permet de décider si les membres de la liste blanche ont la p ### Personnalisation des boutons de réglages -Vous pouvez personnaliser les boutons de réglage de l'embed. Grâce à cela, vous pouvez désactiver des boutons de réglages afin que vos membres ne les utilisent pas. +Vous pouvez personnaliser les boutons de réglage de l'embed. Grâce à cela, vous pouvez désactiver les boutons de réglages afin que vos membres ne les utilisent pas. ::tabs ::tab{ label="Depuis la commande /config" } Exécuter la commande \, puis sélectionner depuis le menu déroulant `Salons vocaux temporaires` ➔ `Modifier un hub` ➔ `Personnalisation des boutons de réglages`. - Vous pourrez ajouter ou supprimer des rôles autorisés ou interdits. + Vous pourrez activer ou désactiver les boutons de votre choix. :: ::tab{ label="Depuis le panel" } @@ -453,4 +463,113 @@ Vous pouvez personnaliser les boutons de réglage de l'embed. Grâce à cela, vo :: :: +### Réquisition de salon + +Lorsque cette option est activée, les membres présents dans un salon vocal temporaire peuvent **récupérer la propriété** du salon si le propriétaire l'a quitté, en cliquant sur le bouton **Transférer**. Le membre qui réquisitionne deviendra le nouveau propriétaire du salon. + +::hint{ type="info" } + Si cette option est désactivée, les membres ne pourront pas récupérer un salon dont le propriétaire est parti. +:: + +::tabs + ::tab{ label="Depuis la commande /config" } + Exécuter la commande \, puis sélectionner depuis le menu déroulant `Salons vocaux temporaires` ➔ `Modifier un hub` ➔ `Réquisition de salons autorisé`. + + Le bouton bascule entre activé et désactivé. + :: + + ::tab{ label="Depuis le panel" } + [⫸ Accéder au panel de **DraftBot**](/dashboard/first/community) + + Allez dans le panel, puis dans la catégorie [Communautaire](dashboard/first/community). Ensuite, cliquez sur `Salons vocaux temporaires (privateroom)` et enfin sur le bouton `Modifier`. + + Vous trouverez l'option **Réquisition** permettant d'autoriser les membres à récupérer un salon vocal temporaire inactif. + :: +:: + + +### Sauvegardes +Cette option permet d'activer ou de désactiver le système de **sauvegardes de configuration** pour les salons vocaux temporaires. + +![Menu d'une sauvegarde](../assets/salons-vocaux-temporaires/saves.png) + +::hint{ type="info" } + Cette fonctionnalité est réservée aux serveurs [premium](/premium) <:icon_premium_:1096140508625125417>. +:: + +::tabs + ::tab{ label="Depuis la commande /config" } + Exécuter la commande \, puis sélectionner depuis le menu déroulant `Salons vocaux temporaires` ➔ `Modifier un hub` ➔ `Sauvegardes`. + + Le bouton bascule entre activé et désactivé. + :: + + ::tab{ label="Depuis le panel" } + [⫸ Accéder au panel de **DraftBot**](/dashboard/first/community) + + Allez dans le panel, puis dans la catégorie [Communautaire](dashboard/first/community). Ensuite, cliquez sur `Salons vocaux temporaires (privateroom)` et enfin sur le bouton `Modifier`. + + Vous trouverez l'option **Sauvegardes** permettant d'autoriser les membres à sauvegarder la configuration de leur salon vocal temporaire. + :: +:: + +## Sauvegardes de configuration + +::hint{ type="info" } + Cette fonctionnalité est réservée aux serveurs [premium](/premium) <:icon_premium_:1096140508625125417> et doit être activée par un administrateur dans la configuration du hub. +:: + +Les sauvegardes permettent aux membres de **sauvegarder** et **charger** des configurations complètes de leur salon vocal temporaire. Cela inclut : + +- La **visibilité** du salon (ouvert, fermé, privé) +- La **limite de membres** +- Le **nom du salon** +- Les **listes blanche et noire** (membres et rôles) — automatiquement mises à jour dans la sauvegarde par défaut lors de chaque ajout ou retrait +- Les **permissions** (micro, vidéo, soundboard, statut) + +Chaque membre peut avoir jusqu'à **5 sauvegardes** par hub. + +::hint{ type="info" } + Le bouton **Exclure** permet d'exclure temporairement un membre du salon vocal sans affecter les sauvegardes. Contrairement à la liste noire, l'exclusion ne persiste pas dans les sauvegardes et prend fin à la prochaine session. +:: + + +### Créer une sauvegarde +En cliquant sur le bouton **Sauvegardes** puis **Nouvelle sauvegarde**, vous avez deux options : + +- **Configuration actuelle** : Enregistre la configuration actuelle de votre salon (visibilité, permissions, listes, limite, nom). +- **Configuration vierge** : Crée une sauvegarde avec les paramètres par défaut du serveur. + +Un aperçu de la configuration est affiché avant confirmation. + + +### Charger une sauvegarde +Sélectionnez une sauvegarde dans le menu déroulant, puis cliquez sur **Charger** pour appliquer cette configuration à votre salon vocal actuel. Toutes les permissions, listes et paramètres de la sauvegarde seront appliqués. + + +### Sauvegarde par défaut +Vous pouvez définir une sauvegarde comme **par défaut**. Celle-ci sera automatiquement chargée à chaque fois que vous créerez un nouveau salon vocal temporaire. + +::hint{ type="info" } + Lorsqu'une sauvegarde par défaut est définie, chaque modification du salon sera gardé d'un salon à un autre (changement de visibilité, de permissions, etc.). +:: + + +### Gérer les sauvegardes +Depuis l'interface, vous pouvez : + +- **Modifier le nom** d'une sauvegarde +- **Supprimer** une sauvegarde (avec confirmation) +- **Définir par défaut** une sauvegarde +### Importer une sauvegarde + +Il est possible d'**importer une sauvegarde depuis un autre hub ou un autre serveur** où vous avez des sauvegardes existantes. Le processus se déroule en plusieurs étapes : + +1. Sélectionnez le **serveur** source +2. Sélectionnez le **hub** source +3. Sélectionnez la **sauvegarde** à importer + +::hint{ type="warning" } + Lors d'une importation depuis un autre serveur, les **rôles** présents dans les listes blanche/noire ne seront pas importés (ils sont propres au serveur d'origine). Seuls les **membres** seront conservés s'ils sont présents sur le serveur de destination. +:: \ No newline at end of file diff --git a/docs/assets/salons-vocaux-temporaires/saves.png b/docs/assets/salons-vocaux-temporaires/saves.png new file mode 100644 index 000000000..f2a32dedc Binary files /dev/null and b/docs/assets/salons-vocaux-temporaires/saves.png differ diff --git a/docs/assets/salons-vocaux-temporaires/view_button.png b/docs/assets/salons-vocaux-temporaires/view_button.png index d7f52eb59..489d025ea 100644 Binary files a/docs/assets/salons-vocaux-temporaires/view_button.png and b/docs/assets/salons-vocaux-temporaires/view_button.png differ