Tags TEST

The Tags cog provides a comprehensive system for storing, organizing, and retrieving reusable text responses, embeds, and information.
Tags are perfect for frequently asked questions, server information, and quick responses.

⚙️ Features Overview

Tag Management

• Create, edit, and delete tags for server-wide use.
• Support for text, embeds, images, and attachments.
• Assign multiple aliases per tag with full edit history tracking.

Organization

• Organize tags into custom categories and add searchable keywords.
• Track contributor information and permissions seamlessly.
• Full support for mixed content types.

Content Support

• Plain text tags & Discord embeds with rich formatting.
• Native image and attachment support.
• Combine formatted text with rich media.

Basic Tag Commands

↳ Indicates an alternative way to run the command.

Command Description Example
!tag create (category) [name] (content) (attachment)
↳ /tag create		 Creates a new tag in an existing category.
(Defaults to Uncategorized if omitted; requires content or attachment)		 !tag create fun hello Hello there!
!tag edit [name] (content) (attachment)
↳ /tag edit		 Edits an existing tag you own or contribute to.
(Supports Discord image/GIF attachments)		 !tag edit hello Welcome back!
!tag attachment-url [name] [url]
↳ /tag attachment-url		 Sets or replaces the tag’s attachment.
(Provide a valid direct image/GIF URL ending in .png, .webp, .jpg, .jpeg, or .gif)		 !tag attachment-url hello https://example.com/image.png
!tag delete [name]
↳ /tag delete		 Deletes a tag you own or contribute to.
(Removes all associated aliases)		 !tag delete hello
!tag categorize [name] [category]
↳ /tag categorize		 Changes the category of an existing tag.
(Requires ownership or contributor access)		 !tag categorize hello fun
!tag contributor [name] [user]
↳ /tag contributor		 Adds or removes a contributor from a tag.
(Supports user IDs, usernames, and mentions)		 !tag contributor hello @User

Tag Aliases

↳ Indicates an alternative way to run the command.

Command Description Example
!tag alias [tag_name] [alias]
↳ /tag alias [tag_name] [alias]		 Adds an alias to an existing tag.
(A tag can have up to 5 aliases)		 !tag alias hello hi
!tag unalias [alias_name]
↳ /tag unalias [alias_name]		 Removes an existing alias from the guild. !tag unalias hi

Tag Information

↳ Indicates an alternative way to run the command.

Command Description Example
![name]
↳ /tag get [name]
↳ !tag [name]		 Calls a tag by name. !hello
!tag raw [name]
↳ /tag raw		 Returns the raw tag content.
Useful for copying or editing tags.		 !tag raw hello
!tag search [query]
↳ /tag search		 Searches guild tags by name or content. !tag search welcome
!tag info [name]
↳ /tag info		 Displays metadata about an existing tag. !tag info hello
!tags
↳ /tag list [category] [user] [csv]		 Lists tags in the guild.
Supports optional category, user, and CSV filters.		 !tags

🎛️ Configuration

Run /cog TagsManagement to open the configuration menu.

Setting Description
Enabled Toggle the entire tags system on or off.
Log Channel Channel where all tag actions (creation, edits, deletions) are logged.
Roles Call Tags Roles permitted to use/call existing tags.
Roles Create Tags Roles permitted to create and edit their own tags.
Roles Manager Roles allowed to manage all tags across the guild.
Roles Blacklisted Roles explicitly blocked from using the tag system.

💡 Best Practices

  • Clear Naming: Use descriptive, searchable tag names to prevent duplicates.
  • Categorization: Organize tags logically into relevant categories.
  • Regular Updates: Keep tag content accurate and current.
  • Keyword Addition: Attach relevant keywords to improve searchability.
  • Moderation: Review newly created tags periodically before or after approval.

🔗 Integrations

  • Help System: Auto-suggests relevant tags when users ask common questions.
  • Moderation: Use pre-made tags as standardized warning templates.
  • Welcome System: Send automated welcome tags to new members.
  • FAQ System: Acts as a centralized knowledge base for your server.

🛡️ Permissions Breakdown

  • Users: Can view, search, and call public tags.
  • Contributors: Can create, edit, and manage their own tags.
  • Moderators: Can manage, edit, or delete all tags and categories.
  • Admins: Full control over the system, including module configuration and role permissions.