Les réglages de l’admin

Blocs et code

Un module ne contient jamais l’identifiant d’un salon ou d’un rôle : il les demande à l’admin de chaque serveur. Ces réglages apparaissent dans le dashboard après l’installation.

En blocs : automatique

Quand une action a besoin d’un salon ou d’un rôle, tu ne choisis pas un vrai salon : tu donnes un nom à ce choix, par exemple « Salon des candidatures ». À l’installation, l’admin choisit le vrai salon de son serveur. Un même choix peut servir à plusieurs actions (« Réutiliser le même choix que… »).

  • Salon : un salon texte. Il peut être proposé en salon privé (le staff seulement) pour les demandes à valider.
  • Salon vocal : pour « Jouer un son », « Le déplacer en vocal », « Programmer un événement ».
  • Catégorie : facultative, pour ranger les salons créés.
  • Rôle : obligatoire ou facultatif selon l’action.

D’autres réglages sont créés quand tu les actives : Chaque admin peut réécrire ce texte sur un message, Chaque admin peut modifier les boutons de lien, les questions du formulaire ou l’annonce au-dessus du bouton.

En code : l’onglet Réglages

Tu déclares toi-même les réglages dans l’onglet Réglages du Studio Code. Chaque réglage a une clé (ex. salon) et un type. Dans le code, tu le lis avec ctx.config.<clé>.

TypeCe que l’admin remplitValeur dans ctx.config
SalonUn salon du serveuridentifiant (texte)
RôleUn rôleidentifiant (texte)
Plusieurs rôlesPlusieurs rôlesliste d’identifiants
Plusieurs salonsPlusieurs salonsliste d’identifiants
Texte courtUne ligne de textetexte
Texte longUn texte longtexte
InterrupteurOui ou nontrue / false
NombreUn nombrenombre
Choix dans une listeUn choix dans ta listevaleur du choix
Liste de questionsUne liste de questionsliste d’objets
JavaScript
module.on('memberJoin', async (ctx) => {
  if (!ctx.config.salon) return;
  await ctx.send(ctx.config.salon, 'Bienvenue ' + ctx.member.mention + ' !');
  if (ctx.config.role) await ctx.addRole(ctx.config.role);
});

Champs obligatoires

Un réglage obligatoire non rempli empêche les actions qui l’utilisent de fonctionner, et le dashboard le signale à l’admin. Les boutons du dashboard qui en ont besoin restent grisés tant qu’il manque.

Les réglages de l’admin · Documentation Opale