Source de données : Discord


1Présentation

Discord est un service de communication dédié initialement aux joueurs, et dont l'usage s'est élargi depuis.

Il est possible d'envoyer des messages dans un salon de communication, pour notifier les utilisateurs de manière automatisée.

Si vous avez correctement configuré les paramètres de connexion au service Discord, Temma crée automatiquement un objet de type \Temma\Datasources\Discord, avec lequel vous pourrez envoyer des messages. Par convention, nous partirons du principe que vous avez nommé cette connexion disc dans le fichier etc/temma.php (voir la documentation de la configuration).

Dans les contrôleurs, la connexion à Discord est alors disponible en écrivant :

$discord = $this->disc;

Dans les autres objets gérés par le le composant d'injection de dépendances, la connexion à Discord est accessible en écrivant :

$discord = $loader->dataSources->disc;
$discord = $loader->dataSources['disc'];

2Configuration

Pour envoyer des messages sur Discord, vous devez d'abord créer un webhook. Chaque webhook étant lié à un salon dans lequel il peut poster des messages.

Dans le fichier etc/temma.php (voir la documentation de la configuration), vous pourrez alors déclarer le DSN (Data Source Name) qui permet de se connecter à Discord.

Le DSN de connexion à Discord peut s'écrire de la forme : discord://WEBHOOK

Avec WEBHOOK la valeur de l'URL du webhook, sans le préfixe https://.
Exemple : discord.com/api/webhooks/ABC/XYZ


3Contenu des notifications

Les notifications peuvent contenir du texte (2000 caractères maximum), qui accepte un dérivé de la syntaxe Markdown.


4Appels unifiés

4.1Accès de type tableau

// envoie un message simple
$discord[''] = "Message à envoyer";

4.2Méthode avancée

// envoie un message simple
$discord->set('', "Message à envoyer");