diff --git a/docs/2.modules/7.suggestions.md b/docs/2.modules/7.suggestions.md index 77abc2107..d6152dd81 100644 --- a/docs/2.modules/7.suggestions.md +++ b/docs/2.modules/7.suggestions.md @@ -2,7 +2,7 @@ title: Suggestions description: Récoltez simplement les suggestions et avis de vos membres avec DraftBot ! navigation.icon: 'twemoji:light-bulb' -contributors: ['bariboo', 'clement669', 'rababio', 'elbaguetto'] +contributors: ['bariboo', 'clement669', 'rababio', 'elbaguetto', 'imroxxor'] updated_at: '2025-04-18' --- @@ -625,4 +625,116 @@ Vous pouvez personnaliser votre message avec différentes variables : :: :: +### Annonces de récompenses +Configurez où et comment annoncer l'obtention d'une récompense (désactivé par défaut) : + +- **Salon dédié** : Choisissez un salon spécifique pour les annonces. +- **Message personnalisé** : Personnalisez le message d'annonce avec les [variables disponibles](#variables-de-personnalisation), ainsi que `{reward}`, `{target.count}` et `{target.type}` pour afficher la récompense obtenue. + +**Message par défaut** : `{user}, voici votre récompense pour avoir atteint **{target.count} {target.type}** !` + +::hint{ type="info" } + Par défaut, les annonces de récompenses sont **désactivées**. N'oubliez pas de les activer et de choisir un salon pour que vos membres soient notifiés ! +:: + +::hint{ type="warning" } + **Permissions requises** : Pour envoyer les annonces, DraftBot doit disposer des permissions suivantes dans le salon choisi : **Voir le salon**, **Envoyer des messages**, **Intégrer des liens** et **Joindre des fichiers**. Si ces permissions sont retirées, les annonces seront automatiquement désactivées. +:: + +### Créer une récompense + +1. **Statut de suggestion** : Le statut que la suggestion occupe : acceptée, en attente, refusée, prévue +2. **Nombre de suggestion** : Le nombre déclencheur +3. **Type de récompense** : Rôle, argent, XP, objet, ou personnalisée +4. **Paramètres spécifiques** selon le type choisi + +::tabs + ::tab{ label="Via la commande /config" } + + DraftBot peut récompenser automatiquement l'auteur de suggestions pour un certain nombre de suggestions acceptées / refusées / en attente + + Via la commande \, accédez au menu "Suggestions" > "Récompenses" > "Créer une récompense", puis suivez les étapes de configuration. + + ![Création de récompense via /config](../assets/suggestions/config_recompenses.png) + :: + + ::tab{ label="Via le panel" } + [⫸ Accéder au panel de **DraftBot**](/dashboard/first/suggestions) + + Dans la section "Récompenses", cliquez sur "Créer une récompense" : + + ![Création de récompense depuis le panel](../assets/suggestions/panel_creer_recompense.png) + :: +:: + +::tabs + ::tab{ label="Rôle" } + Attribuez un rôle permanent ou temporaire au membre qui atteint l'objectif. + + **Paramètres :** + - Le rôle à attribuer + - Durée (pour rôle temporaire uniquement) + + ::hint{ type="warning" } + Le rôle sélectionné doit avoir été créé au préalable et être accessible à DraftBot (ne pas être situé plus haut que le rôle le plus élevé de DraftBot). + :: + + ::hint{ type="info" } + Contrairement aux récompenses de niveau, les rôles ne sont **jamais retirés** automatiquement si la suggestion est changée. + :: + :: + + ::tab{ label="Argent" } + Donnez de l'argent du [système d'économie](/docs/modules/economie) au membre. + + **Paramètres :** + - Montant à donner + + ::hint{ type="warning" } + Le système d'économie doit être **activé** sur votre serveur pour utiliser ce type de récompense. + :: + :: + + ::tab{ label="Expérience" } + Donnez des points d'expérience du [système de niveaux](/docs/modules/niveaux). + + **Paramètres :** + - Quantité d'XP à donner + + ::hint{ type="warning" } + Le système de niveaux doit être **activé** sur votre serveur pour utiliser ce type de récompense. + :: + + ::hint{ type="success" } + Si le gain d'XP fait monter le membre de niveau, il recevra automatiquement les récompenses de niveau et une annonce sera envoyée (si configurée). + :: + :: + + ::tab{ label="Objet d'inventaire" } + Donnez un ou plusieurs [objets d'inventaire](/docs/modules/inventaire) au membre. + + **Paramètres :** + - L'objet à donner + - La quantité (jusqu'à 1 million) + + ::hint{ type="info" } + Si vous n'avez pas encore créé d'objets, vous devrez d'abord [configurer votre inventaire](/docs/modules/inventaire) depuis le module Inventaire du panel. + :: + :: + + ::tab{ label="Récompense personnalisée" } + Offrez une récompense **en dehors de Discord** : codes promotionnels, goodies physiques, mentions spéciales, etc. + + **Paramètres :** + - Nom/description de la récompense (jusqu'à 250 caractères) + + ::hint{ type="success" } + **Comment ça fonctionne ?** Lorsqu'un membre obtient cette récompense, **vous recevez une notification par message privé de DraftBot** avec les informations du membre. Vous pouvez alors lui remettre la récompense manuellement. + :: + + ::hint{ type="warning" } + Assurez-vous que vos messages privés sont ouverts pour recevoir les notifications ! + :: + :: +:: \ No newline at end of file diff --git a/docs/assets/suggestions/commande_config_annonce_recompenses.png b/docs/assets/suggestions/commande_config_annonce_recompenses.png new file mode 100644 index 000000000..90ecd26f1 Binary files /dev/null and b/docs/assets/suggestions/commande_config_annonce_recompenses.png differ diff --git a/docs/assets/suggestions/config_recompenses.png b/docs/assets/suggestions/config_recompenses.png new file mode 100644 index 000000000..3ceeb12ac Binary files /dev/null and b/docs/assets/suggestions/config_recompenses.png differ diff --git a/docs/assets/suggestions/panel_creer_recompense.png b/docs/assets/suggestions/panel_creer_recompense.png new file mode 100644 index 000000000..90a9401ee Binary files /dev/null and b/docs/assets/suggestions/panel_creer_recompense.png differ diff --git a/docs/assets/suggestions/recompense_embed.png b/docs/assets/suggestions/recompense_embed.png new file mode 100644 index 000000000..738983425 Binary files /dev/null and b/docs/assets/suggestions/recompense_embed.png differ