Class ReactionsSelfRoleManager

A class that manages self-assignable roles using reactions.

Export

Deprecated

Discord has encouraged people to use interactions instead of reactions. See InteractionsSelfRoleManager.

Hierarchy (View Summary)

SelfRoleManager
- ReactionsSelfRoleManager

Index

Constructors

constructor

new ReactionsSelfRoleManager(
client?: Client,
options?: ReactionsSelfRoleOptions,
): ReactionsSelfRoleManager
Creates an instance of ReactionsSelfRoleManager.
Parameters
- Optionalclient: Client
  The client that instantiated this Manager
- Optionaloptions: ReactionsSelfRoleOptions = ...
Returns ReactionsSelfRoleManager
Overrides SelfRoleManager.constructor
- Defined in ReactionsSelfRoleManager.ts:40

Properties

`Readonly`channels

channels: Collection<string, ChannelProperties>

The collection of registered channels.

Name

SelfRoleManager#channels

`Readonly`client

client: Client

The client that instantiated this Manager

Name

SelfRoleManager#client

`Readonly`options

options: SelfRoleOptions

The options of the manager.

Methods

`Protected`generateRolesChangesListener

generateRolesChangesListener(
    rolesToEmojis: RoleToEmojiData[],
): (
    oldMember: GuildMember | PartialGuildMember,
    newMember: GuildMember,
) => Promise<void>
Parameters
- rolesToEmojis: RoleToEmojiData[]
Returns (
oldMember: GuildMember | PartialGuildMember,
newMember: GuildMember,
) => Promise<void>
Inherited from SelfRoleManager.generateRolesChangesListener
- Defined in SelfRoleManager.ts:367

`Protected`getRTE

getRTE(
    sender:
        | MessageReaction
        | PartialMessageReaction
        | StringSelectMenuInteraction<CacheType>
        | ButtonInteraction<CacheType>,
    channelOptions: ChannelOptions,
    emoji?: null | GuildEmoji | ReactionEmoji | APIMessageComponentEmoji,
): undefined | RoleToEmojiData | RoleToEmojiData[]
Returns the RTE (and its role) based on the emoji provided.
Parameters
- sender:
      | MessageReaction
      | PartialMessageReaction
      | StringSelectMenuInteraction<CacheType>
      | ButtonInteraction<CacheType>
  the button component or message reaction
- channelOptions: ChannelOptions
  the channel options
- Optionalemoji: null | GuildEmoji | ReactionEmoji | APIMessageComponentEmoji
  the emoji clicked
Returns undefined | RoleToEmojiData | RoleToEmojiData[]
The proper RoteToEmojiData
Inherited from SelfRoleManager.getRTE
- Defined in SelfRoleManager.ts:235

`Protected`handleUserAction

handleUserAction(
    userAction: MessageReaction | PartialMessageReaction,
    user: User | PartialUser,
    isReactionRemoval: boolean,
): Promise<void>
Handle the behaviour once a user adds a reaction or clicks on a button.
Parameters
- userAction: MessageReaction | PartialMessageReaction
  the user action, whether it is a reaction or a button interaction
- user: User | PartialUser
  the user who did the action
- isReactionRemoval: boolean
  invert the logic of the action (only for reactions)
Returns Promise<void>
Overrides SelfRoleManager.handleUserAction
- Defined in ReactionsSelfRoleManager.ts:118

registerChannel

registerChannel(channelID: string, options: ChannelOptions): Promise<void>
Registers a channel. When a user reacts to the message in it, a role will be given/removed.
Parameters
- channelID: string
- options: ChannelOptions
Returns Promise<void>
Name
SelfRoleManager#registerChannel
Inherited from SelfRoleManager.registerChannel
- Defined in SelfRoleManager.ts:124

`Protected`sendsMessageAndRegisterChannel

sendsMessageAndRegisterChannel(
channel: TextChannel,
channelOptions: ChannelOptions,
): Promise<void>
Handle the registering of a channel, sending the main message for the automated role-giver system.
Parameters
- channel: TextChannel
- channelOptions: ChannelOptions
Returns Promise<void>
Overrides SelfRoleManager.sendsMessageAndRegisterChannel
- Defined in ReactionsSelfRoleManager.ts:74

unregisterChannel

unregisterChannel(channelID: string): Promise<void>
Unregisters a channel. When a user reacts to the message in it, nothing will happen.
Parameters
- channelID: string
Returns Promise<void>
Name
SelfRoleManager#unregisterChannel
Inherited from SelfRoleManager.unregisterChannel
- Defined in SelfRoleManager.ts:152

`Protected`userCanBeAddedToRole

userCanBeAddedToRole(
    member: GuildMember,
    role: Role,
    userAction:
        | MessageReaction
        | PartialMessageReaction
        | StringSelectMenuInteraction<CacheType>
        | ButtonInteraction<CacheType>,
): Promise<void>
Parameters
- member: GuildMember
- role: Role
- userAction:
      | MessageReaction
      | PartialMessageReaction
      | StringSelectMenuInteraction<CacheType>
      | ButtonInteraction<CacheType>
Returns Promise<void>
Inherited from SelfRoleManager.userCanBeAddedToRole
- Defined in SelfRoleManager.ts:315

`Protected`userCanBeRemovedFromRole

userCanBeRemovedFromRole(
    member: GuildMember,
    role: Role,
    userAction:
        | MessageReaction
        | PartialMessageReaction
        | StringSelectMenuInteraction<CacheType>
        | ButtonInteraction<CacheType>,
): Promise<void>
Parameters
- member: GuildMember
- role: Role
- userAction:
      | MessageReaction
      | PartialMessageReaction
      | StringSelectMenuInteraction<CacheType>
      | ButtonInteraction<CacheType>
Returns Promise<void>
Inherited from SelfRoleManager.userCanBeRemovedFromRole
- Defined in SelfRoleManager.ts:341

`Protected`userHasMissingRequiredRoles

userHasMissingRequiredRoles(
    member: GuildMember,
    userAction:
        | MessageReaction
        | PartialMessageReaction
        | StringSelectMenuInteraction<CacheType>
        | ButtonInteraction<CacheType>,
    role: Role,
    requiredRoles: undefined | RoleResolvable[],
): Promise<void>
Parameters
- member: GuildMember
- userAction:
      | MessageReaction
      | PartialMessageReaction
      | StringSelectMenuInteraction<CacheType>
      | ButtonInteraction<CacheType>
- role: Role
- requiredRoles: undefined | RoleResolvable[]
Returns Promise<void>
Inherited from SelfRoleManager.userHasMissingRequiredRoles
- Defined in SelfRoleManager.ts:296

`Protected`userHasReachedMaxRoles

userHasReachedMaxRoles(
    member: GuildMember,
    userAction:
        | MessageReaction
        | PartialMessageReaction
        | StringSelectMenuInteraction<CacheType>
        | ButtonInteraction<CacheType>,
    numberOfMemberManagedRoles: number,
    numberOfMaxRolesAssigned: undefined | number,
    role: Role,
): Promise<void>
Parameters
- member: GuildMember
- userAction:
      | MessageReaction
      | PartialMessageReaction
      | StringSelectMenuInteraction<CacheType>
      | ButtonInteraction<CacheType>
- numberOfMemberManagedRoles: number
- numberOfMaxRolesAssigned: undefined | number
- role: Role
Returns Promise<void>
Inherited from SelfRoleManager.userHasReachedMaxRoles
- Defined in SelfRoleManager.ts:275

Class ReactionsSelfRoleManager

Export

Deprecated

Hierarchy (View Summary)

Index

Constructors

Properties

Methods

Constructors

constructor

Parameters

Returns ReactionsSelfRoleManager

Properties

Readonlychannels

Name

Readonlyclient

Name

Readonlyoptions

Methods

ProtectedgenerateRolesChangesListener

Parameters

Returns ( oldMember: GuildMember | PartialGuildMember, newMember: GuildMember,) => Promise<void>

ProtectedgetRTE

Parameters

Returns undefined | RoleToEmojiData | RoleToEmojiData[]

ProtectedhandleUserAction

Parameters

Returns Promise<void>

registerChannel

Parameters

Returns Promise<void>

Name

ProtectedsendsMessageAndRegisterChannel

Parameters

Returns Promise<void>

unregisterChannel

Parameters

Returns Promise<void>

Name

ProtecteduserCanBeAddedToRole

Parameters

Returns Promise<void>

ProtecteduserCanBeRemovedFromRole

Parameters

Returns Promise<void>

ProtecteduserHasMissingRequiredRoles

Parameters

Returns Promise<void>

ProtecteduserHasReachedMaxRoles

Parameters

Returns Promise<void>

Settings

On This Page

`Readonly`channels

`Readonly`client

`Readonly`options

`Protected`generateRolesChangesListener

Returns (
oldMember: GuildMember | PartialGuildMember,
newMember: GuildMember,
) => Promise<void>

`Protected`getRTE

`Protected`handleUserAction

`Protected`sendsMessageAndRegisterChannel

`Protected`userCanBeAddedToRole

`Protected`userCanBeRemovedFromRole

`Protected`userHasMissingRequiredRoles

`Protected`userHasReachedMaxRoles