core

Fully merged `threadmenu config` into the main bot’s config system.

Added threadmenu embed customization capability.

Author: lorenzo132

CHANGELOG.md

@@ -51,7 +51,6 @@ Features:
     * `threadmenu option edit/remove/show`: Manage or inspect an existing option.
     * `threadmenu submenu create/delete/list/show`: Manage submenus.
     * `threadmenu submenu option add/edit/remove`: Manage options inside a submenu.
-    * `threadmenu config <timeout|close_on_timeout|embed_text|dropdown_placeholder|anonymous_menu>`: Adjust global settings.
   * Configuration / Behavior:
     * Per-option `category` targeting when creating a thread; falls back to `main_category_id` if invalid/missing.
     * Optional selection logging (`thread_creation_menu_selection_log`) posts the chosen option in the new thread.

cogs/threadmenu.py

@@ -31,6 +31,11 @@ def _get_conf(self) -> dict:
             or "Please select an option.",
             "dropdown_placeholder": self.bot.config.get("thread_creation_menu_dropdown_placeholder")
             or "Select an option to contact the staff team.",
+            "embed_title": self.bot.config.get("thread_creation_menu_embed_title"),
+            "embed_footer": self.bot.config.get("thread_creation_menu_embed_footer"),
+            "embed_thumbnail_url": self.bot.config.get("thread_creation_menu_embed_thumbnail_url"),
+            "embed_footer_icon_url": self.bot.config.get("thread_creation_menu_embed_footer_icon_url"),
+            "embed_color": self.bot.config.get("thread_creation_menu_embed_color"),
         }
 
     async def _save_conf(self, conf: dict):
@@ -49,6 +54,17 @@ async def _save_conf(self, conf: dict):
             "thread_creation_menu_dropdown_placeholder",
             conf.get("dropdown_placeholder", "Select an option to contact the staff team."),
         )
+        await self.bot.config.set("thread_creation_menu_embed_title", conf.get("embed_title"))
+        await self.bot.config.set("thread_creation_menu_embed_footer", conf.get("embed_footer"))
+        await self.bot.config.set("thread_creation_menu_embed_thumbnail_url", conf.get("embed_thumbnail_url"))
+        await self.bot.config.set(
+            "thread_creation_menu_embed_footer_icon_url", conf.get("embed_footer_icon_url")
+        )
+        if conf.get("embed_color"):
+            try:
+                await self.bot.config.set("thread_creation_menu_embed_color", conf.get("embed_color"))
+            except Exception:
+                pass
         await self.bot.config.update()
 
     # ----- commands -----
@@ -58,80 +74,6 @@ async def threadmenu(self, ctx):
         """Thread-creation menu settings (core)."""
         await ctx.send_help(ctx.command)
 
-    @checks.has_permissions(PermissionLevel.ADMINISTRATOR)
-    @threadmenu.group(name="config", invoke_without_command=True)
-    async def threadmenu_config(self, ctx):
-        """Thread-creation menu config settings (core)."""
-        await ctx.send_help(ctx.command)
-
-    @checks.has_permissions(PermissionLevel.ADMINISTRATOR)
-    @threadmenu_config.command(name="get")
-    async def threadmenu_config_get(self, ctx):
-        """Get current core thread-creation menu config."""
-        conf = self._get_conf()
-        embed = discord.Embed(
-            title="Thread-creation menu config (Core)",
-            description="The current config for the thread menu.",
-            color=discord.Color.blurple(),
-        )
-        embed.add_field(name="Enabled", value=conf["enabled"])
-        embed.add_field(name="Timeout", value=conf["timeout"])
-        embed.add_field(name="Close on timeout", value=conf["close_on_timeout"])
-        embed.add_field(name="Embed text", value=conf["embed_text"], inline=False)
-        embed.add_field(name="Dropdown placeholder", value=conf["dropdown_placeholder"], inline=False)
-        await ctx.send(embed=embed)
-
-    @checks.has_permissions(PermissionLevel.ADMINISTRATOR)
-    @threadmenu_config.command(name="timeout")
-    async def threadmenu_config_timeout(self, ctx, timeout: int):
-        """Set the menu interaction timeout in seconds.
-
-        After this period of inactivity the view times out; if
-        `close_on_timeout` is true the menu message is removed.
-        """
-        if timeout < 1:
-            return await ctx.send("Timeout must be greater than 1.")
-        conf = self._get_conf()
-        conf["timeout"] = timeout
-        await self._save_conf(conf)
-        await ctx.send("Timeout set.")
-
-    @checks.has_permissions(PermissionLevel.ADMINISTRATOR)
-    @threadmenu_config.command(name="close_on_timeout")
-    async def threadmenu_config_close_on_timeout(self, ctx, close_on_timeout: bool):
-        """Toggle deleting the menu message when it times out."""
-        conf = self._get_conf()
-        conf["close_on_timeout"] = close_on_timeout
-        await self._save_conf(conf)
-        await ctx.send("Done.")
-
-    @checks.has_permissions(PermissionLevel.ADMINISTRATOR)
-    @threadmenu_config.command(name="embed_text")
-    async def threadmenu_config_embed_text(self, ctx, *, embed_text: str):
-        """Set the embed body text shown above the select menu."""
-        conf = self._get_conf()
-        conf["embed_text"] = embed_text
-        await self._save_conf(conf)
-        await ctx.send("Done.")
-
-    @checks.has_permissions(PermissionLevel.ADMINISTRATOR)
-    @threadmenu_config.command(name="dropdown_placeholder")
-    async def threadmenu_config_dropdown_placeholder(self, ctx, *, dropdown_placeholder: str):
-        """Set the placeholder text inside the dropdown before selection."""
-        conf = self._get_conf()
-        conf["dropdown_placeholder"] = dropdown_placeholder
-        await self._save_conf(conf)
-        await ctx.send("Done.")
-
-    @checks.has_permissions(PermissionLevel.ADMINISTRATOR)
-    @threadmenu_config.command(name="anonymous_menu")
-    async def threadmenu_config_anonymous_menu(self, ctx, option: bool):
-        """Toggle whether the menu is posted anonymously (no user mention)."""
-        conf = self._get_conf()
-        conf["anonymous_menu"] = option
-        await self._save_conf(conf)
-        await ctx.send("Done.")
-
     @checks.has_permissions(PermissionLevel.ADMINISTRATOR)
     @threadmenu.command(name="toggle")
     async def threadmenu_toggle(self, ctx):

core/config.py

@@ -158,6 +158,12 @@ class ConfigManager:
         "thread_creation_menu_dropdown_placeholder": "Select an option to contact the staff team.",
         "thread_creation_menu_selection_log": True,  # log selected option in newly created thread channel
         "thread_creation_menu_precreate_channel": False,
+        # thread-creation menu embed customization
+        "thread_creation_menu_embed_title": None,
+        "thread_creation_menu_embed_footer": None,
+        "thread_creation_menu_embed_thumbnail_url": None,
+        "thread_creation_menu_embed_footer_icon_url": None,
+        "thread_creation_menu_embed_color": str(discord.Color.green()),
     }
 
     private_keys = {
@@ -214,7 +220,7 @@ class ConfigManager:
         "data_collection": True,
     }
 
-    colors = {"mod_color", "recipient_color", "main_color", "error_color"}
+    colors = {"mod_color", "recipient_color", "main_color", "error_color", "thread_creation_menu_embed_color"}
 
     time_deltas = {"account_age", "guild_age", "thread_auto_close", "thread_cooldown", "log_expiration"}
 

core/config_help.json

@@ -1425,7 +1425,7 @@
     "default": "30 (seconds)",
     "description": "Number of seconds to wait for a user to pick a menu option before timing out.",
     "examples": [
-  "`{prefix}threadmenu config timeout 30`"
+  "`{prefix}config set thread_creation_menu_timeout 30`"
     ],
     "notes": [
       "If the timeout is reached, `thread_creation_menu_close_on_timeout` controls whether the attempt is aborted or the user is asked to message again.",
@@ -1436,7 +1436,7 @@
     "default": "No",
     "description": "Silently aborts thread creation if the user does not select an option before the timeout expires.",
     "examples": [
-  "`{prefix}threadmenu config close_on_timeout yes`"
+  "`{prefix}config set thread_creation_menu_close_on_timeout yes`"
     ],
     "notes": [
       "If disabled, the user receives a message telling them to send a new DM to start again.",
@@ -1447,7 +1447,7 @@
     "default": "No",
     "description": "If enabled, the initial menu prompt relayed to staff (after creation) is anonymized; only selection details are logged, not the original prompt message author context.",
     "examples": [
-  "`{prefix}threadmenu config anonymous_menu yes`"
+  "`{prefix}config set thread_creation_menu_anonymous_menu yes`"
     ],
     "notes": [
       "Does not affect the DM the user sees, only how it's displayed/logged internally.",
@@ -1458,7 +1458,7 @@
     "default": "\"Please select an option.\"",
     "description": "Text shown in the embed above the selection dropdown in the user's DM.",
     "examples": [
-  "`{prefix}threadmenu config embed_text Please choose a department`"
+  "`{prefix}config set thread_creation_menu_embed_text Please choose a department`"
     ],
     "notes": [
       "Keep this concise; users cannot proceed until choosing.",
@@ -1469,7 +1469,7 @@
     "default": "\"Select an option to contact the staff team.\"",
     "description": "Placeholder text displayed in the dropdown before selection.",
     "examples": [
-  "`{prefix}threadmenu config dropdown_placeholder Pick a topic...`"
+  "`{prefix}config set thread_creation_menu_dropdown_placeholder Pick a topic...`"
     ],
     "notes": [
       "Appears grayed out inside the select component.",
@@ -1499,5 +1499,61 @@
       "Confirmation (`confirm_thread_creation`) is only applied in the deferred mode; enabling precreate bypasses the confirm step for menu flows.",
       "See also: `thread_creation_menu_enabled`, `thread_creation_menu_options`, `confirm_thread_creation`."
     ]
+  },
+  "thread_creation_menu_embed_title": {
+    "default": "Empty (no title)",
+    "description": "Optional title at the top of the thread-creation menu embed in the user's DM.",
+    "examples": [
+      "`{prefix}config set thread_creation_menu_embed_title Contact the staff team`",
+      "`{prefix}config delete thread_creation_menu_embed_title` (clear)"
+    ],
+    "notes": [
+      "See also: `thread_creation_menu_embed_text`."
+    ]
+  },
+  "thread_creation_menu_embed_footer": {
+    "default": "Empty (no footer)",
+    "description": "Optional footer text at the bottom of the menu embed.",
+    "examples": [
+      "`{prefix}config set thread_creation_menu_embed_footer Please choose the most relevant option`",
+      "`{prefix}config delete thread_creation_menu_embed_footer` (clear)"
+    ],
+    "notes": [
+      "You can also configure an optional footer icon via `thread_creation_menu_embed_footer_icon_url`."
+    ]
+  },
+  "thread_creation_menu_embed_footer_icon_url": {
+    "default": "Empty (no icon)",
+    "description": "Optional URL for the small footer icon displayed next to the footer text.",
+    "examples": [
+      "`{prefix}config set thread_creation_menu_embed_footer_icon_url https://example.com/icon.png`",
+      "`{prefix}config delete thread_creation_menu_embed_footer_icon_url` (clear)"
+    ],
+    "notes": [
+      "Use a direct image URL (PNG/JPEG/GIF)."
+    ]
+  },
+  "thread_creation_menu_embed_thumbnail_url": {
+    "default": "Empty (no thumbnail)",
+    "description": "Optional thumbnail image shown in the top-right of the menu embed.",
+    "examples": [
+      "`{prefix}config set thread_creation_menu_embed_thumbnail_url https://example.com/logo.png`",
+      "`{prefix}config delete thread_creation_menu_embed_thumbnail_url` (clear)"
+    ],
+    "notes": [
+      "Use a direct image URL; recommended square image.",
+      "Consider file size/CDN reliability so it loads quickly for users."
+    ]
+  },
+  "thread_creation_menu_embed_color": {
+    "default": "Green (hex for Discord Color.green)",
+    "description": "Color for the menu embed's side strip. Accepts hex (e.g. #5865F2) or one of the supported color names.",
+    "examples": [
+      "`{prefix}config set thread_creation_menu_embed_color #5865F2`",
+      "`{prefix}config set thread_creation_menu_embed_color blurple`"
+    ],
+    "notes": [
+      "Color names map to the built-in palette (e.g., 'red', 'green', 'blurple')."
+    ]
   }
 }

core/thread.py

@@ -2670,7 +2670,28 @@ async def on_timeout(self):
 
             # Send DM prompt
             try:
-                embed = discord.Embed(description=embed_text, color=self.bot.mod_color)
+                # Build embed with new customizable settings
+                try:
+                    embed_title = self.bot.config.get("thread_creation_menu_embed_title")
+                    embed_footer = self.bot.config.get("thread_creation_menu_embed_footer")
+                    embed_thumb = self.bot.config.get("thread_creation_menu_embed_thumbnail_url")
+                    embed_footer_icon = self.bot.config.get("thread_creation_menu_embed_footer_icon_url")
+                    embed_color_raw = self.bot.config.get("thread_creation_menu_embed_color")
+                except Exception:
+                    embed_title = None
+                    embed_footer = None
+                    embed_thumb = None
+                    embed_footer_icon = None
+                    embed_color_raw = None
+                embed_color = embed_color_raw or self.bot.mod_color
+                embed = discord.Embed(title=embed_title, description=embed_text, color=embed_color)
+                if embed_footer:
+                    embed.set_footer(text=embed_footer, icon_url=embed_footer_icon or discord.Embed.Empty)
+                if embed_thumb:
+                    try:
+                        embed.set_thumbnail(url=embed_thumb)
+                    except Exception:
+                        pass
                 menu_view = _ThreadCreationMenuView(thread)
                 menu_msg = await recipient.send(embed=embed, view=menu_view)
                 # mark thread as pending menu selection
@@ -2812,7 +2833,28 @@ async def on_timeout(self):
                         pass
 
             try:
-                embed = discord.Embed(description=embed_text, color=self.bot.mod_color)
+                # Build embed with new customizable settings (precreate flow)
+                try:
+                    embed_title = self.bot.config.get("thread_creation_menu_embed_title")
+                    embed_footer = self.bot.config.get("thread_creation_menu_embed_footer")
+                    embed_thumb = self.bot.config.get("thread_creation_menu_embed_thumbnail_url")
+                    embed_footer_icon = self.bot.config.get("thread_creation_menu_embed_footer_icon_url")
+                    embed_color_raw = self.bot.config.get("thread_creation_menu_embed_color")
+                except Exception:
+                    embed_title = None
+                    embed_footer = None
+                    embed_thumb = None
+                    embed_footer_icon = None
+                    embed_color_raw = None
+                embed_color = embed_color_raw or self.bot.mod_color
+                embed = discord.Embed(title=embed_title, description=embed_text, color=embed_color)
+                if embed_footer:
+                    embed.set_footer(text=embed_footer, icon_url=embed_footer_icon or discord.Embed.Empty)
+                if embed_thumb:
+                    try:
+                        embed.set_thumbnail(url=embed_thumb)
+                    except Exception:
+                        pass
                 menu_view = _PrecreateMenuView(thread)
                 # Send menu DM AFTER channel creation initiation (channel will be created below)
                 menu_msg = await recipient.send(embed=embed, view=menu_view)