Bienvenue dans ce tutoriel sur le développement d'un bot discord !

Nous allons voir tout au long de ce tutoriel comment

Configuration initiale pour créer un bot Discord avec Sheweny

Bienvenue dans ce nouveau chapitre sur la structure de notre projet et l'installation des modules.

_Ce chapitre fait partie d'une série

Structure du projet et modules pour un bot Discord avec Sheweny

Bienvenue dans ce nouveau chapitre sur la création de notre client Sheweny

_Ce chapitre fait partie d'une série de tutoriels. Bien

Connecter son bot à l'API de Discord avec Sheweny

Bienvenue dans ce nouveau chapitre dans lequel nous allons découvrir les commandes de messages. Les commandes messages ont été les

Créer sa première commande sur son bot Discord avec Sheweny

Bienvenue dans ce nouveau chapitre dans lequel nous allons créer notre première slash-command.

_Ce chapitre fait partie d'une série de tutoriels.

Créer sa première slash commande sur son bot Discord avec Sheweny

Bienvenue dans ce nouveau chapitre dans lequel nous allons parler des restrictions de commandes.

_Ce chapitre fait partie d'une série de

Protéger une commande sur son bot Discord avec Sheweny

Créer des événements sur son bot Discord avec Sheweny

Bienvenue dans ce nouveau chapitre sur la création et l'utilisation de boutons.

_Ce chapitre fait partie d'une série de tutoriels. Bien

Créer des boutons sur son bot Discord avec Sheweny

Bienvenue dans ce nouveau chapitre sur la création et l'utilisation de select-menus.

_Ce chapitre fait partie d'une série de tutoriels. Bien

Créer des select-menus sur son bot Discord avec Sheweny

Documentation pour créer un bot Discord avec Sheweny

Javascript

Discord.js

Bienvenue dans ce nouveau chapitre sur la création et l'utilisation de select-menus.

_Ce chapitre fait partie d'une série de tutoriels. Bien qu'il soit possible de la suivre sans avoir lu les chapitres précédents, il est conseillé de les lire avant de commencer ce chapitre._

### Introduction aux select-menus

Depuis l'année derrière, les select-menus ont été introduits par discord. Ils permettent d'intéragir avec nos utilisateurs de façon conviviale grâce à leur simplicité et leur aspect graphique.
Les select-menus peuvent êtres envoyés sous n'importe quel message du bot sauf les messages éphémères (ephemeral).

### Modification de notre client

Comme pour les événements, l'utilisation des select-menus nécéssite l'ajout d'un manager Sheweny pour charger nos différents select-menus.
Si ce n'est pas déjà fait, vous pouvez créer un dossier `select-menus` dans la structure de votre bot et modifier le client comme suit :

```js
const client = new ShewenyClient({
  intents: [Intents.FLAGS.GUILDS, Intents.FLAGS.GUILD_MESSAGES],
  partials: ["CHANNEL", "MESSAGE", "REACTION", "USER", "GUILD_MEMBER"],
  presence: {
    status: "online",
    activities: [
      {
        name: "Tutorial Bot",
        type: "WATCHING",
      },
    ],
  },
  managers: {
    commands: {
      directory: "./commands",
      guildId: ["877090306103840778"],
      autoRegisterApplicationCommands: true,
      loadAll: true,
      prefix: "!",
    },
  },
  events: {
    directory: "./events",
    loadAll: true,
  },
  buttons: {
    directory: "./buttons",
    loadAll: true,
  },
  select-menus: {
    directory: "./selectmenus",
    loadAll: true,
  },
});
```

### Envoi d'un select-menu dans un message

Pour envoyer un select-menu dans un message il est nécéssaire de le construire (comme un message embed).  
Cependant, il est nécéssaire de comprendre comment les select-menus et les composants d'une manière générale sont construits sur discord :
Il est possible d'ajouter des lignes d'actions à nos messages, jusqu'à 5 lignes d'actions par message. Ensuite sur chaque ligne d'action, il est possible d'ajouter des composants.  
Les composants sont des boutons, des inputs, des select-menus etc. Chaque composant prend une place définie :

- Les boutons prennent une place de 1
- Les select-menus prennent une place de 5
- Les inputs prennent une place de 5

Il est possible d'ajouter jusqu'à 5 places de composants par lignes d'actions.  
Vous suivez ?  
En clair vous pouvez ajouter jusqu'à 25 boutons par message (5 lignes de 5 select-menus), 5 select-menus (5 lignes de 1 select-menu) et 5 inputs (5 lignes de 1 input).

#### Construction sur discord

Nous allons créer une commande pour illustrer cette construction.

```js
const { Command } = require("sheweny");
const { MessageButton, MessageActionRow } = require("discord.js");

module.exports = class SelectCommand extends Command {
  constructor(client) {
    super(client, {
      name: "select-menus",
      type: "SLASH_COMMAND",
      description: "Envoi 1 select-menu",
    });
  }
  execute(interaction) {
    const row = new MessageActionRow().addComponents(
      new MessageSelectMenu()
        .setCustomId("select")
        .setPlaceholder("Rien de sélectionné")
        .addOptions([
          {
            label: "Première option",
            description: "La première option",
            value: "option_un",
          },
          {
            label: "Deuxième option",
            description: "La deuxième option",
            value: "option_deux",
          },
        ])
    );
    interaction.reply({ content: "Teste des select-menus", components: [row] });
  }
};
```

On voit que dans un premier temps on crée un select-menu, on lui donne un identifiant puis des options (des valeurs possibles) et enfin on lui donne un placeholder (un texte grisé).  
Ensuite on crée une nouvelle ligne d'action et on ajoute le select-menu à cette ligne d'action.  
Enfin on envoie le message avec le select-menu.  
Vous pouvez en savoir plus en lisant le guide de discord.js qui est très bien fait : [discordjs.guide/interactions/select-menus](https://discordjs.guide/interactions/select-menus.html#building-and-sending-select-menus)

### Recevoir un select-menu

Nous allons maintenant voir comment recevoir un select-menu. Si vous vous souvenez du chapitre précédent sur les événements ou les boutons, vous verrez que c'est quasiment le même processus.

Dans notre dossier `/selectmenus` nous allons créer un fichier pour recevoir notre select-menu :

```js
const { SelectMenu } = require("shewney");

module.exports = class select-menu extends SelectMenu {
  constructor(client) {
    super(client, ["identifiant-select-menu-1"]);
  }
  async execute(interaction) {
    interaction.reply("Vous avez cliqué sur le select-menu bleu");
  }
};
```

Note: Pour une utilisation plus avancée il est possible d'utiliser des expressions régulières et même des cooldowns, voyons un exemple ensemble :

```js
const { SelectMenu } = require("shewney");

module.exports = class select-menu extends SelectMenu {
  constructor(client) {
    super(client, [/identifiant-select-menu-[0-9]{1,2}/], {
      cooldown: 3.5, // 3.5 secondes
    });
  }
  async execute(interaction) {
    interaction.reply(
      "Vous avez cliqué sur le select-menu avec comme identifiant une chaine commencant par idenfitiant-select-menu- suivie de 1 ou 2 chiffres"
    );
  }
};
```

### Conclusion

Dans ce chapitre nous avons appris à utiliser des select-menus avec Sheweny.

Après ce chapitre vous êtes maintenant capables :

- De créer des select-menus et les envoyer dans des messages
- De recevoir des select-menus
- D'utiliser des expressions régulières pour recevoir des select-menus et d'ajouter des cooldowns

<data>NE PAS SUPPRIMER CETTE LIGNE!</data>

Nous allons voir comment créer un bot discord avec Discord.js v13 et Sheweny