more-cores / discord-message-builder
v3.0.13
2022-06-24 15:39 UTC
Requires
- php: >=7.1.0
Requires (Dev)
- mockery/mockery: ^1.0
- phpunit/phpunit: ^7.0
README
A small library for building Discord messages.
Installation
composer require more-cores/discord-message-builder:^3.0
Usage
Using webhooks (they have higher rate limits):
$message = new WebhookMessage();
$message->setContent($content);
$embed = new Embed();
$embed->setTitle($title);
$embed->setDescription($description);
$embed->setUrl($url);
$embed->setTimestamp($dateTime);
$embed->setColor($color);
$message->addEmbed($embed);
$message->toJson(); // valid json ready to be sent to Discord via a Webhook
Or using standard messaging:
$message = new Message();
$message->setContent($content);
$message->setEmbed($embed);
Mentioning
Both Message
and WebhookMessage
offer the ability to mention roles.
// appends the mention to the previously set content. Setting the content again overrides mentions
$message->mention($roleId);
$message->isMentioned($roleId);
$message->hasMentions();
Author
// define an embed author using shorthand
$embed->setAuthor($name);
// and optionally specify specific attributes
$embed->setAuthor($name, $url);
// define an embed author by object
$author = new Author();
$author->setName($name);
$embed->setAuthor($author);
Fields
// define an embed video using shorthand
$embed->addField($fieldName, $fieldValue);
// and optionally specify whether it's inline (default to false)
$embed->addField($fieldName, $fieldValue, $inline = true);
// define an embed field by object
$field = new Field();
$field->setName($name);
$field->setValue($value);
$embed->setVideo($field);
Image
$embed->setImageUrl($imageUrl);
Thumbnail
$embed->setThumbnailUrl($thumbnailUrl);
Footer
// define an embed footer using shorthand
$embed->setFooter($text, $iconUrl);
// and optionally specify specific attributes
$embed->setFooter($urlToImage, $width, $height);
// define an embed thumbnail by object
$thumbnail = new Thumbnail();
$thumbnail->setText($text);
$thumbnail->setUrl($urlToImage);
$embed->setFooter($thumbnail);