zappyzep/backend/src/plugins/RoleButtons/info.ts

import { trimPluginDescription } from "../../utils";
import { ZeppelinGuildPluginBlueprint } from "../ZeppelinPluginBlueprint";

export const pluginInfo: ZeppelinGuildPluginBlueprint["info"] = {
  prettyName: "Role buttons",
  description: trimPluginDescription(`
    Allow users to pick roles by clicking on buttons
  `),
  configurationGuide: trimPluginDescription(`
    Button roles are entirely config-based; this is in contrast to the old reaction roles. They can either be added to an existing message posted by Zeppelin or posted as a new message.
    
    ## Basic role buttons
    ~~~yml
    role_buttons:
      config:
        buttons:
          my_roles: # You can use any name you want here, but make sure not to change it afterwards
            message:
              channel_id: "967407495544983552"
              content: "Click the reactions below to get roles! Click again to remove the role."
            options:
              - role_id: "878339100015489044"
                label: "Role 1"
              - role_id: "967410091571703808"
                emoji: "😁" # Default emoji as a unicode emoji
                label: "Role 2"
              - role_id: "967410091571703234"
                emoji: "967412591683047445" # Custom emoji ID
              - role_id: "967410091571703567"
                label: "Role 4"
                style: DANGER # Button style (in all caps), see https://discord.com/developers/docs/interactions/message-components#button-object-button-styles
    ~~~
    
    ### Or with an embed:
    ~~~yml
    role_buttons:
      config:
        buttons:
          my_roles:
            message:
              channel_id: "967407495544983552"
              content:
                embeds:
                  - title: "Pick your role below!"
                    color: 0x0088FF
                    description: "You can pick any role you want by clicking the buttons below."
            options:
              ... # See above for examples for options
    ~~~
    
    ## Role buttons for an existing message
    This message must be posted by Zeppelin.
    ~~~yml
    role_buttons:
      config:
        buttons:
          my_roles:
            message:
              channel_id: "967407495544983552"
              message_id: "967407554412040193"
            options:
              ... # See above for examples for options
    ~~~
    
    ## Limiting to one role ("exclusive" roles)
    When the \`exclusive\` option is enabled, only one role can be selected at a time.
    ~~~yml
    role_buttons:
      config:
        buttons:
          my_roles:
            message:
              channel_id: "967407495544983552"
              message_id: "967407554412040193"
            exclusive: true # With this option set, only one role can be selected at a time
            options:
              ... # See above for examples for options
    ~~~
  `),
};