Variables de formatage
Les variables de formatage permettent à April d’insérer des valeurs Discord dans les messages, les embeds, les URLs d’image et les champs d’éditeur pris en charge.
Variables de message legacy
Section intitulée « Variables de message legacy »Welcome, leaver, logs, protection messages, custom commands, managed embeds, stream monitors et levels utilisent des variables à accolades simples lorsque l’éditeur de message affiche des boutons de variables.
Exemple :
Welcome {user.mention} to {guild}. You are member {memberCount.ordinal}.Les pages n’exposent pas toutes les mêmes données. Si une variable n’est pas disponible pour cette fonctionnalité, April la laisse inchangée ou la remplace par une valeur de repli.
Variables utilisateur courantes
Section intitulée « Variables utilisateur courantes »| Variable | Signification |
|---|---|
{user} | Nom d’utilisateur |
{user.mention} | Mention utilisateur Discord |
{user.status.color} | Couleur hexadécimale du statut actuel de l’utilisateur |
{user.discriminator} | Discriminateur Discord lorsqu’il est disponible |
{user.avatar} | URL de l’avatar utilisateur |
{user.avatar.rounded} | URL de l’avatar utilisateur pour les modèles d’image |
{user.fullname} | Valeur complète du nom d’affichage disponible pour le formateur |
{user.id} | ID utilisateur Discord |
{user.created} | Date complète de création de l’utilisateur |
{user.created.date} | Date de création de l’utilisateur |
{user.created.ago} | Temps relatif depuis la création de l’utilisateur |
{user.created.time} | Heure de création de l’utilisateur |
{user.joined} | Date complète d’arrivée sur le serveur |
{user.joined.date} | Date d’arrivée sur le serveur |
{user.joined.ago} | Temps relatif depuis l’arrivée sur le serveur |
{user.joined.time} | Heure d’arrivée sur le serveur |
Variables de guild et de channel
Section intitulée « Variables de guild et de channel »| Variable | Signification |
|---|---|
{guild} | Nom du serveur |
{memberCount} | Nombre approximatif de membres |
{memberCount.ordinal} | Nombre de membres sous forme ordinale |
{guild.id} | ID du serveur Discord |
{guild.created.ago} | Temps relatif depuis la création du serveur |
{guild.created.date} | Date de création du serveur |
{guild.created.time} | Heure de création du serveur |
{guild.icon} | URL de l’icône du serveur |
{channel} | Nom du channel |
{channel.id} | ID du channel Discord |
{channel.mention} | Mention du channel Discord |
{channel.created} | Date complète de création du channel |
{channel.created.date} | Date de création du channel |
{channel.created.time} | Heure de création du channel |
{channel.created.ago} | Temps relatif depuis la création du channel |
{channel.nsfw} | Indique si le channel est marqué NSFW |
{channel.topic} | Sujet du channel |
Variables de niveau
Section intitulée « Variables de niveau »Utilisez-les dans les messages de level-up, les designs de rank card et les modèles liés aux niveaux lorsque la page les propose.
| Variable | Signification |
|---|---|
{user.level} | Niveau de l’utilisateur dans le serveur |
{user.xp} | XP dans le niveau actuel |
{user.xpRatio} | Progression du niveau actuel de 0 à 1 |
{user.nextLevel} | XP requis pour le niveau suivant |
{user.totalXp} | XP total accumulé |
Variables de log
Section intitulée « Variables de log »Les événements de log peuvent exposer des valeurs avant/après lorsque Discord envoie les deux états.
| Variable | Signification |
|---|---|
{before.user} | Nom d’utilisateur précédent |
{before.user.nickname} | Surnom serveur précédent |
{before.user.avatar} | URL d’avatar précédente |
{before.user.fullname} | Valeur utilisateur complète précédente |
{after.user} | Nom d’utilisateur mis à jour |
{after.user.nickname} | Surnom serveur mis à jour |
{after.user.avatar} | URL d’avatar mise à jour |
{after.user.fullname} | Valeur utilisateur complète mise à jour |
{before.channel} | Nom du channel précédent |
{before.channel.id} | ID du channel précédent |
{before.channel.nsfw} | État NSFW précédent |
{before.channel.topic} | Sujet du channel précédent |
{after.channel} | Nom du channel mis à jour |
{after.channel.id} | ID du channel mis à jour |
{after.channel.nsfw} | État NSFW mis à jour |
{after.channel.topic} | Sujet du channel mis à jour |
Certains événements de log ajoutent aussi des valeurs propres à l’événement, comme le contenu du message ou les rôles modifiés. Utilisez les boutons de variables affichés sur la page de configuration de cet événement.
Variables de stream monitor
Section intitulée « Variables de stream monitor »Les notifications Twitch peuvent utiliser :
| Variable | Signification |
|---|---|
{stream.channel} | Nom d’affichage du streamer |
{stream.avatarUrl} | URL de l’avatar du streamer |
{stream.url} | URL de la chaîne Twitch |
{stream.viewerCount} | Nombre de spectateurs |
{stream.started.ago} | Heure relative de début du stream |
{stream.type} | Type de stream |
{stream.length} | Durée du stream |
{stream.title} | Titre du stream |
{stream.preview} | URL de la miniature du stream |
{stream.game} | Jeu ou catégorie |
Les notifications YouTube peuvent utiliser {stream.channel.name}, {stream.channel}, {stream.url}, {stream.started.ago} et {stream.title}.
Valeurs aléatoires
Section intitulée « Valeurs aléatoires »Les custom commands et autres modèles de message legacy peuvent utiliser des variables de nombre aléatoire :
{random}{random.1-100}{random} renvoie une valeur de 0 à 10. {random.1-100} renvoie une valeur dans la plage configurée.
Variables de l’espace de travail de l’éditeur
Section intitulée « Variables de l’espace de travail de l’éditeur »Les bindings Editor V2 utilisent plutôt la syntaxe de sortie de style Liquid :
| Variable | Exemple d’utilisation |
|---|---|
{{ user }} | Afficher l’utilisateur sélectionné dans le texte |
{{ guild }} | Afficher le nom du serveur dans le texte |
{{ channel }} | Afficher une valeur de channel dans le texte |
Les bindings Editor V2 se configurent depuis l’inspector de l’espace de travail. Les valeurs à accolade simple comme {user} ne sont pas valides dans les bindings Editor V2.
Valeurs d’URL
Section intitulée « Valeurs d’URL »Les variables d’image et d’icône doivent se résoudre en URLs valides. Par exemple, {user.avatar}, {guild.icon} et {stream.preview} conviennent aux champs d’URL d’image lorsque la fonctionnalité les prend en charge.