Dashboard Templates

This page explains how to use the templating system and how to make your commands compatible with it. This includes parsing of Metadata and Inputs, making command creation and customization easier.

Metadata

Metadata adds extra information to your commands, such as descriptions, tags, categories, and more. This helps users find your commands more easily through template search.

To add metadata to your code, use the following syntax. Make sure to comment out the metadata in your code.

{{{ and }}}

These delimiters mark the beginning and end of the metadata, allowing the system to parse it correctly.

Metadata Structure

Here's the structure of the metadata JSON object:

{{{
    "version": number,
    "tags": Array<string>,
    "author": string,
    "usecase": string,
    "category": string,
    "preview": link,
    "description": Array<string>,
    "link": Array<link>,
    "custommd"?: string // Optional custom markdown
}}}

Explanation of Fields:

• version: The version of the command. Use numbers.
• tags: An array of strings representing keywords related to the command (e.g., ["economy", "balance", "money"]).
• author: The author of the command (e.g., "User-0000").
• usecase: A brief explanation of what the command does (e.g., "checks the balance of the user").
• category: The category the command belongs to (e.g., "economy").
• preview: A link to a preview image or video demonstrating the command.
• description: An array of strings providing a detailed description of the command. Each string can be a separate line of the description. Use \...`` to format command examples.
• link: An array of links to relevant resources, documentation, or examples.
• custommd: (Optional) A string containing custom markdown to further describe or provide instructions for the command.

Metadata Example

Here's an example of metadata for a !balance command:

/* Metadata:
{{{
    "version": "1",
    "tags": ["economy", "balance", "money"],
    "author": "User-0000",
    "usecase": "checks the balance of the user",
    "category": "economy",
    "preview": "URL",
    "description": ["Run `!bal` to show your balance"],
    "link": ["URL"],
    "custommd": ""
}}}
*/

// The !bal command code here

Note: In this example, the link and preview are the same, as it's a simple command.

$onTemplate Function

The $onTemplate function creates a user interface (UI) for interacting with commands. This UI allows users to input values and customize the command before execution. It is especially useful for commands that require user-specific information.

Important: A UI is only generated if the command has associated metadata.

Usage

$onTemplate[type;field;title;help;default value]

Parameters:

• type: The type of input field to create.
• field: The style/appearance of the input field.
• title: The title displayed above the input field in the UI.
• help: A helpful description displayed below the input field.
• default value: The default value for the input field.

Valid Types:

• category: Creates a dropdown list of categories from the server. dropdownarray or dropdown should be used for the field parameter.
• number: Creates a number input field.
• channel: Creates a dropdown list of channels from the server. dropdownarray or dropdown should be used for the field parameter.
• role: Creates a dropdown list of roles from the server. dropdownarray or dropdown should be used for the field parameter.
• text: Creates a single-line text input field.
• boolean: Creates a checkbox.
• id: Creates a text input field, typically used for IDs.
• runonlyin: This modifies the cloned command run only in to the selected channel(s)

Valid Fields:

• input: Creates a standard text input field.
• inputarray: Creates a text input field with the placeholder "Split by ,". The input will be treated as an array, split by commas.
• dropdown: Creates a dropdown list with values from the specified type. If the type is text or number, the values are taken from the default value parameter, separated by commas.
• dropdownarray: Creates a dropdown list where multiple options can be selected. Values are determined as with the standard dropdown field.
• checkbox: Creates a checkbox.

Title & Help:

• title: The label for the input field.
• help: A descriptive text providing guidance on what to enter in the input field.

Default Value:

• default value: The value that's pre-filled or pre-selected in the input field.

Example

$let[categoryID;$onTemplate[category;dropdown;Ticket Category;Choose the category where the ticket should be created;$channelCategoryID]] // Put the category ID Here

$newTicket[$username;;$get[categoryID];no;{private}Could not Create Ticket]

After Cloning:

$let[categoryID;866251414232498197]

Arrays

dropdownarray and inputarray fields split their input by commas (,). To use these arrays as function arguments, you have to use $spread.