🎭Menus de rôles

C'est quoi un Menu de rôles ?

Anciennement appelés réaction-rôles sur Sharles, ou rôle en clique, rôle-réaction, auto-rôle et autres sur d'autres bots, Sharles possède désormais les ✨ Menus de rôles ✨.

C'est un moyen simple et moderne de laisser certains rôles de ton serveur en libre-service à tes membres.

Comment les mettre en place ?

C'est ni très compliqué, ni très long, il te suffira de trois étapes :

• 📊 Création du menu dans le Dashboard

• 💬 Création du message de Sharles sur lequel installer le menu

• 🛠️ Installation du menu

1. Création du menu de rôle dans le Dashboard

Première étape, se rendre sur le Dashboard. Comme la personnalisation est grande, impossible de faire ça avec des commandes. Donc direction le Dashboard, et dans la catégorie 🎭 Menus de rôles.

Le gros bouton vert, c'est sur lui que tu dois cliquer ! Cela te créera un nouveau menu tout neuf que tu pourras éditer et personnaliser à ta guise.

On va essayer de décortiquer tout ce qu'on voit ici :

🎭 Nouveau menu de rôle C'est l'émoji et le nom du menu. Ces derniers apparaîtront sur le bouton générateur du réel menu qui permettra de choisir ses rôles. Tu ne vois pas à quoi ça sert ? Pas grave, tu pourras le modifier après.

Couleur du bouton C'est la couleur que prendra le bouton générateur de menu de sélection des rôles. Ça aussi tu pourras toujours le changer plus tard.

Type de menu Là on est sur quelque chose de plus important. Pour donner accès aux rôles à tes membres deux solutions s'offrent à toi : Un bouton : En cliquant dessus le membre pourra obtenir un unique rôle ou se le retirer Un menu déroulant : En cliquant dessus le membre pourra accéder à une liste de rôles et choisir ceux qu'il veut parmi les siens Pour ce premier exemple on restera sur un menu déroulant, ce que tu utiliseras probablement le plus souvent.

Nombre max de rôles possédés simultanément Comme on va regarder comment faire avec un menu déroulant, plusieurs rôles seront mis au service pour un même menu. Ainsi il peut être intéressant pour toi de limiter le nombre de rôles qui pourront être pris par le membre. Par exemple si tu as un menu qui permet de s'assigner un genre. Tu ne voudras pas qu'un membre s'en assigne plusieurs, logique ;)

Rôles disponibles Ce sera la liste des options du menus de rôles, on va voir ça juste en dessous.

Encore un gros bouton vert ?! Tu sais quoi faire 😉 Ce bouton te permet d'ajouter des options à ton menu, c'est indispensable car c'est ici que tu vas spécifier quels rôles feront partie de ton menu. Clique !

Et nous voilà avec un nouveau cadre à décortiquer !

Nom de l'option C'est assez clair, c'est ce sur quoi tes membres cliqueront pour sélectionner le rôle. Tu peux le laisser vide si tu veux qu'il y soit affiché automatiquement le nom du rôle que tu associeras à l'option. Juste à côté tu as un sélecteur d'émoji, tu peux donc sélectionner un émoji qui sera affiché à côté du nom de l'option, je te le conseille, c'est stylé de ouf.

Description Cette dernière sera située juste en dessous du nom de l'option, elle peut renseigner le membre en quelques mots.

Le rôle Bon pas très dur à deviner, c'est évidemment le rôle qui sera donné si l'option du menu est sélectionnée.

Et voilà ! J'ai personnalisé un peu mon menu, et j'ai laisser le nom de chaque option vide afin que l'option prenne le nom du rôle. J'ai aussi pensé à enregistrer, c'est toujours mieux ^^. Maintenant on passe à l'étape suivant, il faut un message où placer le menu !

2. Création du message de Sharles

Contrairement aux réaction-rôles, les menus de rôles doivent être installés sur des message de Sharles. Pas sur un message d'un autre utilisateur, et pas sur un webhook. C'est malheureusement impossible car Sharles doit pouvoir modifier son message afin d'installer le menu de rôle. Enfin bref, comment créer un message avec Sharles ?

Deux solutions !

• Utiliser la commande say : Tu peux par exemple faire /say Sélectionnez vos rôles afin que Sharles envoie "Sélectionnez vos rôles" dans le salon de la commande.

• Utiliser le générateur de message du Dashboard : Un poil plus long mais plus personnalisable, il existe le générateur de messages de Sharles. C'est un outil du Dashboard qui permet d'envoyer des messages et des embeds à travers Sharles. Si tu ne t'en ais jamais servi, utilise plutôt la commande say pour le moment, tu pourras modifier ton message plus tard. Sinon tu peux t'aider de l'article sur le générateur de message.

On va faire simple pour le tuto, on va utiliser say. Ce qui nous donnera le message ci-dessous, et ce qui amène à l'étape suivante ! L'installation du menu 😉

3. Installation du menu

Pour installer le menu, pas besoin de commande, c'est encore plus simple que ça !

Clique droit sur le message → Applications → Gérer menus de rôles

Un bouton ! Clique ! Celui-ci ouvre un menu qui te demande de sélectionner le menu que tu souhaites ajouter au message de Sharles. Tu verras la liste de tes menus et leur date de création respective.

Une fois ton menu sélectionné, il est ajouté ! Bravo ! 🥳🎉

Comme tu peux le constater, la couleur du bouton, son nom, et l'émoji associé sont au rendez-vous ;)

Et voilà le résultat ! On retrouve bien l'émoji, le nom et la description de chaque option de ton menu. Le message informe aussi du nombre de rôle max pour ce menu, qui, pour cet exemple n'est pas limité.

Autre type de menu (Les menus Bouton)

En plus des menus de rôles de type Menu déroulant, il existe les menus de type Bouton. Leur avantage ? Ils sont beaucoup plus simples à utiliser si tu ne veux mettre qu'un seul rôle à disposition.

Tu te souviens du premier gros bouton vert ? Tu peux recliquer dessus afin d'ouvrir un nouveau menu. Une fois fait, il faut modifier le type de menu, il doit être sur Bouton.

Tout de suite on voit de nouveaux paramètres :

Action du menu Peut être défini sur Ajout ou Suppression du rôle au premier clic. Cela définir l'action effectuée sur le membre quand ce dernier interagira avec le bouton du menu.

Rôle à donner / retirer au clic sur le bouton L'unique rôle qui sera donné ou retiré au membre suivant l'action du menu.

Menu à double sens Permettra ou non, au membre de réutiliser le bouton du menu pour se retirer le rôle si la première action était définie sur Ajout.

Ici j'ai créé un menu de vérification, qui donnera le rôle Membre aux membres interagissant avec. Le menu à double sens étant désactivé ils ne pourront pas se retirer le rôle après se l'être attribué.

Maintenant on peut l'associer avec notre message créé précédemment. Tu remarqueras assez vite que des nouveaux boutons sont apparus. Ils permettent différents choses :

👀 Mettre à jour les menus du message Met à jour les couleurs, noms, et émojis des boutons générateurs de menus si jamais ils ont été modifiés. N'est pas nécessaire pour mettre à jour les options du menu ! Cela se fera tout seul si modifications il y a.

🗑️ Retirer un menu du message Après avoir cliqué sur ce bouton on te demandera simplement de choisir quel menu tu veux retirer du message. Après sélection, le menu sera supprimé du message, mais tu pourras toujours le réintégrer sur un autre message si tu le souhaites.

En suivant la même méthode que pour le menu déroulant, tu peux ajouter le menu de vérification au message de Sharles.

UN BOUTON VERT !!! Bon j'arrête... Mais tu peux quand même cliquer dessus, au moins pour essayer ^^'

Ce menu n'étant pas à double sens, il est normal, qu'en recliquant dessus, je ne puisse pas me retirer le rôle.