DiscordPHP Documentation

CommandAttributes

Application Command attributes.

Tags
see
CommandBuilder
Command
since
7.1.0
@property

?int|null $guild_id The optional guild ID this command is for. If not set, the command is global.

?string[]|null $name_localizations Localization dictionary for the name field. Values follow the same restrictions as name.

?string[]|null $description_localizations Localization dictionary for the description field. Values follow the same restrictions as description.

?ExCollectionInterface<Option>|Option[] $options The parameters for the command, max 25. Only for Slash command (CHAT_INPUT).

?bool|null $dm_permission Deprecated (use contexts instead); Indicates whether the command is available in DMs with the app, only for globally-scoped commands. By default, commands are visible.

?int[]|null $contexts Interaction context(s) where the command can be used, only for globally-scoped commands.

?int|null $handler Determines whether the interaction is handled by the app's interactions handler or by Discord

Table of Contents

Properties

$default_member_permissions  : string|null
$default_permission  : bool|null
$description  : string|null
$integration_types  : array<string|int, int>|null
$name  : string
$nsfw  : bool|null
$type  : int

Methods

addContext()  : self
Adds a context to the command. (Only for globally-scoped commands).
addIntegrationType()  : self
Adds an integration type to the command. (Only for globally-scoped commands).
addOption()  : self
Adds an option to the command.
clearOptions()  : self
Clear all options from the command.
removeContext()  : self
Removes a context from the command. (Only for globally-scoped commands).
removeIntegrationType()  : self
Removes an integration type from the command. (Only for globally-scoped commands).
removeOption()  : self
Removes an option from the command.
setContext()  : self
Sets the contexts of the command. (Only for globally-scoped commands).
setDefaultMemberPermissions()  : self
Sets the default member permissions of the command.
setDefaultPermission()  : self
Sets the default permission of the command.
setDescription()  : self
Sets the description of the command.
setDescriptionLocalization()  : self
Sets the description of the command in another language.
setDmPermission()  : self
Sets the DM permission of the command.
setGuildId()  : self
Sets the guild ID of the command.
setHandler()  : self
Sets the handler for the command.
setName()  : self
Sets the name of the command.
setNameLocalization()  : self
Sets the name of the command in another language.
setNsfw()  : self
Sets the age restriction of the command.
setType()  : self
Sets the type of the command.

Properties

$default_member_permissions

public string|null $default_member_permissions

Set of permissions represented as a bit set.

$default_permission

public bool|null $default_permission

Deprecated (use default_member_permissions instead); Whether the command is enabled by default when the app is added to a guild, defaults to true. SOON DEPRECATED.

$description

public string|null $description

1-100 character description for CHAT_INPUT commands, empty string for USER and MESSAGE commands.

$integration_types

public array<string|int, int>|null $integration_types

Installation contexts where the command is available, only for globally-scoped commands. Defaults to your app's configured contexts

$nsfw

public bool|null $nsfw

Indicates whether the command is age-restricted, defaults to false.

Methods

addContext()

Adds a context to the command. (Only for globally-scoped commands).

public addContext(int $context) : self
Parameters
$context : int

Context to add.

Tags
throws
DomainException

If the command is not globally-scoped.

since
10.18.0
Return values
self

addIntegrationType()

Adds an integration type to the command. (Only for globally-scoped commands).

public addIntegrationType(int $integration_type) : self
Parameters
$integration_type : int

The integration type to add. Must be one of GUILD_INSTALL (0) or USER_INSTALL (1).

Tags
throws
DomainException

If the command is not globally-scoped or if an invalid integration type is provided.

Return values
self

addOption()

Adds an option to the command.

public addOption(Option $option) : self
Parameters
$option : Option

The option.

Tags
throws
DomainException

Command type is not CHAT_INPUT (1).

OverflowException

Command exceeds maximum 25 options.

Return values
self

clearOptions()

Clear all options from the command.

public clearOptions() : self
Return values
self

removeContext()

Removes a context from the command. (Only for globally-scoped commands).

public removeContext(int $context) : self
Parameters
$context : int

Context to remove.

Tags
throws
DomainException

If the command is not globally-scoped.

since
10.18.0
Return values
self

removeIntegrationType()

Removes an integration type from the command. (Only for globally-scoped commands).

public removeIntegrationType(int $integration_type) : self
Parameters
$integration_type : int

The integration type to remove.

Tags
throws
DomainException

If the command is not globally-scoped.

Return values
self

removeOption()

Removes an option from the command.

public removeOption(Option $option) : self
Parameters
$option : Option

Option to remove.

Tags
throws
DomainException

Command type is not CHAT_INPUT (1).

Return values
self

setContext()

Sets the contexts of the command. (Only for globally-scoped commands).

public setContext(array<string|int, mixed>|null $contexts) : self
Parameters
$contexts : array<string|int, mixed>|null

Interaction contexts where the command can be used.

Tags
throws
DomainException

If the command is not globally-scoped.

since
10.18.0
Return values
self

setDefaultMemberPermissions()

Sets the default member permissions of the command.

public setDefaultMemberPermissions(string|int $permissions) : self
Parameters
$permissions : string|int

Default member permission bits of the command.

Return values
self

setDefaultPermission()

Sets the default permission of the command.

public setDefaultPermission(bool|null $permission) : self

See CommandAttributes::setDefaultMemberPermissions().

Parameters
$permission : bool|null

Default permission of the command

Return values
self

setDescription()

Sets the description of the command.

public setDescription(string $description) : self
Parameters
$description : string

Description of the command

Tags
throws
LengthException

$description is not 1-100 characters long.

Return values
self

setDescriptionLocalization()

Sets the description of the command in another language.

public setDescriptionLocalization(string $locale, string|null $description) : self
Parameters
$locale : string

Discord locale code.

$description : string|null

Localized description of the command.

Tags
throws
LengthException

$description is not 1-100 characters long.

Return values
self

setDmPermission()

Sets the DM permission of the command.

public setDmPermission(bool $permission) : self
Parameters
$permission : bool

DM permission of the command.

Return values
self

setGuildId()

Sets the guild ID of the command.

public setGuildId(int $guildId) : self
Parameters
$guildId : int

Guild ID of the command.

Return values
self

setHandler()

Sets the handler for the command.

public setHandler(int $handler) : self
Parameters
$handler : int

Handler to set.

Tags
throws
DomainException

Command type is not PRIMARY_ENTRY_POINT (4) or if the handler is not valid.

Return values
self

setName()

Sets the name of the command.

public setName(string $name) : self
Parameters
$name : string

Name of the command. Slash command names are lowercase.

Tags
throws
LengthException

$name is not 1-32 characters long.

DomainException

$name contains invalid characters.

Return values
self

setNameLocalization()

Sets the name of the command in another language.

public setNameLocalization(string $locale, string|null $name) : self
Parameters
$locale : string

Discord locale code.

$name : string|null

Localized name of the command. Slash command names are lowercase.

Tags
throws
LengthException

$name is not 1-32 characters long.

DomainException

$name contains invalid characters.

Return values
self

setNsfw()

Sets the age restriction of the command.

public setNsfw(bool $restricted) : self
Parameters
$restricted : bool

Age restriction of the command.

Return values
self

setType()

Sets the type of the command.

public setType(int $type) : self
Parameters
$type : int

Type of the command.

Tags
throws
InvalidArgumentException

$type is not 1-3.

Return values
self
On this page

Search results