docs: created a page about making threads (channel threads) (brainbox…

…dotcc#850)

docpages/example_programs/interactions_and_components.md

@@ -15,3 +15,4 @@ The example programs listed here demonstrate lots of things to do with interacti
 * \subpage application-command-autocomplete "Slash command auto completion"
 * \subpage discord-application-command-file-upload "Using file parameters in slash commands"
 * \subpage private-messaging
+* \subpage making_threads

docpages/example_programs/interactions_and_components/making_threads.md

@@ -0,0 +1,115 @@
+\page making_threads Creating and talking in a thread
+
+A new feature added to Discord recently is `Threads`, these allow you to break off a message into a different "channel", without creating a whole new channel. There are also other types of "thread channels", one example being a `forums channel`. This type of channel only contains threads, meaning you can't send messages in it so if you want to make one of them, be careful about trying to send a message in it!
+
+In this tutorial, we'll be going through how to create a thread and how to talk in a thread.
+
+First, let's go through creating a thread.
+~~~~~~~~~~{.cpp}
+#include <dpp/dpp.h>
+
+int main()
+{
+	/* Create the bot */
+	dpp::cluster bot("token");
+
+	bot.on_log(dpp::utility::cout_logger());
+
+	/* The event is fired when the bot detects a message in any server and any channel it has access to. */
+	bot.on_slashcommand([&bot](const dpp::slashcommand_t& event) {
+		/* Check which command they ran */
+		if (event.command.get_command_name() == "create-thread") {
+			/* Here we create a thread in the current channel. It will expire after 60 minutes of inactivity. We'll also allow other mods to join, and we won't add a slowdown timer. */
+			bot.thread_create("Cool thread!", event.command.channel_id, 60, dpp::channel_type::CHANNEL_PUBLIC_THREAD, true, 0, [event](const dpp::confirmation_callback_t& callback) {
+				if (callback.is_error()) {
+					event.reply("Failed to create a thread!");
+					return;
+				}
+				
+				event.reply("Created a thread for you!");
+			});
+		}
+	});
+
+	bot.on_ready([&bot](const dpp::ready_t& event) {
+		if (dpp::run_once<struct register_bot_commands>()) {
+			/* Create and register the command */
+			bot.global_command_create(dpp::slashcommand("create-thread", "Create a thread!", bot.me.id));
+		}
+	});
+
+	bot.start(dpp::st_wait);
+
+	return 0;
+}
+~~~~~~~~~~
+
+If all went well, you'll see that the bot has successfully created a thread!
+
+\image html creating_thread.png
+
+Now, let's cover talking in that thread from a channel. It's worth noting that we will be assuming that the thread you just created is the only thread in your server!
+~~~~~~~~~~{.cpp}
+
+#include <dpp/dpp.h>
+
+int main()
+{
+	/* Create the bot */
+	dpp::cluster bot("token");
+
+	bot.on_log(dpp::utility::cout_logger());
+
+	/* The event is fired when the bot detects a message in any server and any channel it has access to. */
+	bot.on_slashcommand([&bot](const dpp::slashcommand_t & event) {
+		/* Check which command they ran */
+		if (event.command.get_command_name() == "message-thread") {
+			/* Get all active threads in a guild. */
+			bot.threads_get_active(event.command.guild_id, [&bot, event](const dpp::confirmation_callback_t& callback) {
+				if (callback.is_error()) {
+					event.reply("Failed to get threads!");
+					return;
+				}
+				
+				/* Get the list of active threads in the guild. */
+				auto threads = callback.get<dpp::active_threads>();
+				
+				dpp::snowflake thread_id;
+				
+				/* Loop through the threads, getting each value in the map. Then we get the first value and then break off.
+				* The reason we're getting only the first value is because, for this example, we'll just assume you've only got a single active thread (the one created by the bot)
+				*/
+				for (const auto& _thread : threads) {
+					thread_id = _thread.first;
+					break;
+				}
+				
+				/* Send a message in the first thread we find. */
+				bot.message_create(dpp::message(thread_id, "Hey, I'm first to message in a cool thread!"), [event](const dpp::confirmation_callback_t& callback2) {
+					if (callback2.is_error()) {
+						event.reply("Failed to send a message in a thread.");
+						return;
+					}
+				
+					event.reply("I've sent a message in the specified thread.");
+				});
+			});
+		}
+	});
+
+	bot.on_ready([&bot](const dpp::ready_t& event) {
+		if (dpp::run_once<struct register_bot_commands>()) {
+			/* Create and register the command */
+			bot.global_command_create(dpp::slashcommand("message-thread", "Message a thread!", bot.me.id));
+		}
+	});
+
+	bot.start(dpp::st_wait);
+
+	return 0;
+}
+~~~~~~~~~~
+
+After that, you'll be able to see your bot send a message in your thread!
+
+\image html creating_thread_2.png