🆑 Buttons

⚠️ Requirements

If it's your first button handler you may not have Button. You can create one with this simple command template:

const { ButtonBuilder, ActionRowBuilder, SlashCommandBuilder, ButtonStyle } = require("discord.js")

async function parse(interaction)
{
	const row = new ActionRowBuilder()
	.setComponents(
		new ButtonBuilder()
		// Replace "doc" by the name of your module
		.setCustomId("doc-test")
		.setEmoji("🚨")
		.setLabel("Test")
		.setStyle(ButtonStyle.Secondary)
	)
	interaction.reply({
		content: "Test button below.",
		components: [row]
	})
}

module.exports = {
	parse,
	name: "button",
	permissions: [],
	builder: new SlashCommandBuilder()
		.setName("button")
		.setDescription("A simple test button."),
	any_guild: false,
	dm: false
}

Here we will handle button test from module doc. The syntax for button customId is pretty simple : module_name + - + button_name (e.g: doc-test).

⎯ Why you must use clappybot's syntax ?

Because now, if you disable module doc and click on any button from this module, system will tell you that the button doesn't work because the module is disabled (instead of telling you that the button doesn't work because there is a bug or missing file).

👍 Handle a button

The first thing to do it's create a file inside ./sources/modules/<module_name>/buttons (replace <module_name> with the name of your module). In this example, we called the button test so let's create ./sources/modules/<module_name>/buttons/test.js and paste this code :

const { MessageFlags } = require("discord.js");

async function parse(interaction)
{
	interaction.reply({content: "Yes, this simple button works!", flags: [MessageFlags.Ephemeral]})
}

module.exports = {
	parse,
	// replace "doc" by the name of your module
	customId: "doc-test",
	permissions: [],
	any_guild: false,
	dm: false
}

The method parse is run by system when a button is clicked.

async function parse(interaction)

As you can see we have only one argument:

• interaction → corresponding to the event (InteractionButton)

⎯ Exports

At the bottom of the file we have exports, which includes several important elements.

module.exports = {
	parse,
	customId: "doc-test",
	permissions: [],
	any_guild: false,
	dm: false
}

• parse → method to handle the click
• customId → customId of the button we want to handle
• permissions → list of methods to check ifinteraction.member has the right permissions
• any_guild → if false, the command can be executed only on the main guild
• dm → if true, we can use this command in direct messages