Tags Cog
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
Tag Management
- Create Tags: Store text, embeds, or images as reusable tags
- Edit Tags: Modify existing tags with full history tracking
- Delete Tags: Remove tags with confirmation
- Tag Aliases: Create alternative names for tags
- Tag Categories: Organize tags into hierarchical categories
Content Types
- Text Tags: Plain text responses
- Embed Tags: Rich Discord embeds with formatting
- Image Tags: Tags that include images or attachments
- Mixed Content: Combine text and images
Organization
- Categories: Group related tags together
- Keywords: Add searchable keywords to tags
- Contributors: Track who created and modified tags
- Usage Statistics: View how often tags are used
Search & Discovery
- Tag Search: Find tags by name or content
- Keyword Search: Search tags by associated keywords
- Category Browsing: Browse tags by category
- Fuzzy Matching: Approximate name matching
Access Control
- Permission Levels: Different access for users and moderators
- Channel Restrictions: Limit tag usage to specific channels
- Role Requirements: Require roles to use certain tags
- Private Tags: Tags visible only to specific roles
Commands
| Command | Description | Permissions |
|---|---|---|
/tag <name> | Display a tag | None |
/tag create <name> <content> | Create a new tag | Manage Messages |
/tag edit <name> | Edit an existing tag | Tag Owner/Moderator |
/tag delete <name> | Delete a tag | Tag Owner/Moderator |
/tag info <name> | View tag information | None |
/tag list | Browse all tags | None |
/tag search <query> | Search for tags | None |
Category Management
| Command | Description | Permissions |
|---|---|---|
/category create <name> | Create a category | Manage Messages |
/category edit <id> | Edit category settings | Category Owner/Moderator |
/category delete <id> | Delete a category | Category Owner/Moderator |
/category list | View all categories | None |
Configuration
- Enabled: Toggle the tags system
- Log Channel: Where tag actions are logged
- Allowed Channels: Channels where tags can be used
- Advisor Roles: Roles that can manage tags
- Success Emoji: Emoji shown on successful actions
Advanced Features
Embed Builder
- Visual Editor: Create embeds without code knowledge
- Template System: Predefined embed formats
- Color Picker: Choose embed colors
- Field Management: Add/remove embed fields
Bulk Operations
- CSV Import/Export: Bulk manage tags via spreadsheet
- Tag Cloning: Duplicate tags between servers
- Category Migration: Move tags between categories
Analytics
- Usage Tracking: Most popular tags
- Creation Stats: Tag creation over time
- User Contributions: Most active tag contributors
Best Practices
- Clear Naming: Use descriptive, searchable tag names
- Categorization: Organize tags logically
- Regular Updates: Keep information current
- Keyword Addition: Add relevant keywords for search
- Moderation: Review new tags before approval
Integration
The tags system integrates with:
- Help System: Auto-suggest relevant tags
- Moderation: Use tags for warning templates
- Welcome System: Automated welcome tags
- FAQ System: Centralized knowledge base
Permissions
- Users: Can view and use public tags
- Contributors: Can create and edit their own tags
- Moderators: Can manage all tags and categories
- Admins: Full control over the system