docs: Added emoji page

docpages/example_code/using_emoji.cpp

@@ -0,0 +1,46 @@
+#include <dpp/dpp.h>
+#include <dpp/unicode_emoji.h>
+
+int main() {
+    dpp::cluster bot("Epic Token", dpp::i_default_intents | dpp::i_message_content);
+    /* The second argument is a bitmask of intents - i_message_content is needed to see the messages */
+
+    bot.on_log(dpp::utility::cout_logger());
+
+    /* We'll be using a shocked guy emoji */
+    dpp::emoji shocked("vahuyi", 1179366531856093214);
+
+    bot.on_message_create([&bot, shocked](const dpp::message_create_t& event) {
+        if (event.msg.content == "WHAT?") {
+            /* If some unknown content shocks the user */
+
+            bot.message_add_reaction(event.msg.id, event.msg.channel_id, shocked.format());
+            /* React to their message with a shocked guy */
+        } else if (event.msg.content == "I'm hungry") {
+            /* But if they're hungry */
+
+            bot.message_add_reaction(event.msg.id, event.msg.channel_id, dpp::unicode_emoji::cut_of_meat);
+            /* Let's send some meat to the message, so they don't starve. They will thank us later. */
+        }
+    });
+
+    bot.on_slashcommand([shocked](const dpp::slashcommand_t& event) {
+        if (event.command.get_command_name() == "send-emoji") {
+
+            /* Here we send our very informative message: two emojis next to each other.
+             * We also have to use mention instead of format. */
+            event.reply(shocked.get_mention() + dpp::unicode_emoji::cut_of_meat);
+        }
+    });
+
+    bot.on_ready([&bot](const dpp::ready_t& event) {
+        if (dpp::run_once<struct register_bot_commands>()) {
+            dpp::slashcommand send("send-emoji", "Send the emoji", bot.me.id);
+            bot.global_bulk_command_create({ send });
+        }
+    });
+
+    /* Start the bot! */
+    bot.start(dpp::st_wait);
+    return 0;
+}

docpages/example_programs/misc.md

@@ -11,3 +11,4 @@ This section lists examples that do not fit neatly into any of the categories ab
 * \subpage cpp-eval-command-discord
 * \subpage checking-member-permissions
 * \subpage setting_status
+* \subpage using-emoji

docpages/example_programs/misc/using-emoji.md

@@ -0,0 +1,9 @@
+\page using-emoji Using Emoji
+
+Need your bot to use an emoji? Then the `dpp::emoji` class is just for you. It can store either a custom or a unicode emoji's name and ID. To use one in a message or when reacting to one, you use its mention. In select menus, it's the emoji object itself. Here's how to use them:
+
+\include{cpp} using_emoji.cpp
+
+Now, our bot will react to our messages!
+
+\image html using_emoji.png