Represents an application command, created by your bot either globally, or on a guild. More...

#include <appcommand.h>

Inheritance diagram for dpp::slashcommand:

Collaboration diagram for dpp::slashcommand:

Public Member Functions
	slashcommand ()
	Construct a new slashcommand object. More...

	slashcommand (const std::string &_name, const std::string &_description, const dpp::snowflake _application_id)
	Construct a new slashcommand object. More...

virtual	~slashcommand ()
	Destroy the slashcommand object. More...

slashcommand &	add_localization (const std::string &language, const std::string &_name, const std::string &_description)
	Add a localisation for this slash command. More...

slashcommand &	add_option (const command_option &o)
	Add an option (parameter) More...

slashcommand &	add_permission (const command_permission &p)
	Adds a permission to the command. More...

std::string	build_json (bool with_id=false) const
	Build a json string for this object. More...

slashcommand &	disable_default_permissions ()
	Disable default permissions, command will be unusable unless permissions are overridden with add_permission and dpp::guild_command_edit_permissions. More...

slashcommand &	fill_from_json (nlohmann::json *j)
	Fill object properties from JSON. More...

double	get_creation_time () const
	Get the creation time of this object according to Discord. More...

bool	operator!= (const managed &other) const noexcept
	Comparison operator for comparing two managed objects by id. More...

bool	operator== (const managed &other) const noexcept
	Comparison operator for comparing two managed objects by id. More...

slashcommand &	set_application_id (snowflake i)
	Set the application id of the command. More...

slashcommand &	set_default_permissions (uint64_t defaults)
	Set the default permissions of the slash command. More...

slashcommand &	set_description (const std::string &d)
	Set the description of the command. More...

slashcommand &	set_dm_permission (bool dm)
	Set the dm permission for the command. More...

slashcommand &	set_name (const std::string &n)
	Set the name of the command. More...

slashcommand &	set_type (slashcommand_contextmenu_type _type)
	Set the type of the slash command (only for context menu entries) More...

Public Attributes
snowflake	application_id
	Application id (usually matches your bots id) More...

permission	default_member_permissions
	The default permissions of this command on a guild. D++ defaults this to p_use_application_commands. More...

bool	default_permission
	whether the command is enabled by default when the app is added to a guild. This has no effect as the default_member_permissions value is used instead. More...

std::string	description
	Command description (1-100 chars) More...

std::map< std::string, std::string >	description_localizations
	Localisations of command description. More...

bool	dm_permission
	True if this command should be allowed in a DM D++ defaults this to false. Cannot be set to true in a guild command, only a global command. More...

snowflake	id
	Unique ID of object set by Discord. This value contains a timestamp, worker ID, internal server ID, and an incrementing value. Only the timestamp is relevant to us as useful metadata. More...

std::string	name
	Command name (1-32 chars) More...

std::map< std::string, std::string >	name_localizations
	Localisations of command name. More...

std::vector< command_option >	options
	Command options (parameters) More...

std::vector< command_permission >	permissions
	command permissions More...

slashcommand_contextmenu_type	type
	Context menu type, defaults to dpp::ctxm_chat_input. More...

snowflake	version
	autoincrementing version identifier updated during substantial record changes More...

Detailed Description

Represents an application command, created by your bot either globally, or on a guild.

Constructor & Destructor Documentation

◆ slashcommand() [1/2]

dpp::slashcommand::slashcommand ( )

Construct a new slashcommand object.

◆ slashcommand() [2/2]

dpp::slashcommand::slashcommand	(	const std::string &	_name,
		const std::string &	_description,
		const dpp::snowflake	_application_id
	)

Construct a new slashcommand object.

Parameters

_name	Command name
_description	Command description
_application_id	Application id (usually the bot's user id)

◆ ~slashcommand()

virtual dpp::slashcommand::~slashcommand ( )

virtual

Destroy the slashcommand object.

Member Function Documentation

◆ add_localization()

slashcommand & dpp::slashcommand::add_localization	(	const std::string &	language,
		const std::string &	_name,
		const std::string &	_description
	)

Add a localisation for this slash command.

See also: https://discord.com/developers/docs/reference#locales

Parameters

language	Name of language, see the list of locales linked to above.
_name	name of slash command in the specified language
_description	description of slash command in the specified language

Returns: slashcommand& reference to self for fluent chaining

◆ add_option()

slashcommand & dpp::slashcommand::add_option ( const command_option & o )

Add an option (parameter)

Parameters

o	option (parameter) to add

Returns: slashcommand& reference to self for chaining of calls

◆ add_permission()

slashcommand & dpp::slashcommand::add_permission ( const command_permission & p )

Adds a permission to the command.

Parameters

p	permission to add

Returns: slashcommand& reference to self for chaining of calls

Deprecated:: Discord discourage use of this value and instead you should use default_member_permissions.

◆ build_json()

std::string dpp::slashcommand::build_json ( bool with_id = false ) const

virtual

Build a json string for this object.

Parameters

with_id True if to include the ID in the JSON

Returns: std::string JSON string

Reimplemented from dpp::json_interface< slashcommand >.

◆ disable_default_permissions()

slashcommand & dpp::slashcommand::disable_default_permissions ( )

Disable default permissions, command will be unusable unless permissions are overridden with add_permission and dpp::guild_command_edit_permissions.

Returns: slashcommand& reference to self for chaining of calls

Deprecated:: Discord discourage use of this value and instead you should use default_member_permissions.

◆ fill_from_json()

slashcommand & dpp::slashcommand::fill_from_json ( nlohmann::json * j )

Fill object properties from JSON.

Parameters

j	JSON to fill from

Returns: slashcommand& Reference to self

◆ get_creation_time()

double dpp::managed::get_creation_time ( ) const

inherited

Get the creation time of this object according to Discord.

Returns: double creation time inferred from the snowflake ID. The minimum possible value is the first second of 2015.

◆ operator!=()

bool dpp::managed::operator!= ( const managed & other ) const

noexceptinherited

Comparison operator for comparing two managed objects by id.

Parameters

other Other object to compare against

Returns: true objects are not the same id; false objects are the same id

◆ operator==()

bool dpp::managed::operator== ( const managed & other ) const

noexceptinherited

Comparison operator for comparing two managed objects by id.

Parameters

other Other object to compare against

Returns: true objects are the same id; false objects are not the same id

◆ set_application_id()

slashcommand & dpp::slashcommand::set_application_id ( snowflake i )

Set the application id of the command.

Parameters

i	application id

Returns: slashcommand& reference to self for chaining of calls

◆ set_default_permissions()

slashcommand & dpp::slashcommand::set_default_permissions ( uint64_t defaults )

Set the default permissions of the slash command.

Parameters

defaults default permissions to set. This is a permission bitmask

Note: You can set it to 0 to disable the command for everyone except admins by default

Returns: slashcommand& reference to self

◆ set_description()

slashcommand & dpp::slashcommand::set_description ( const std::string & d )

Set the description of the command.

Parameters

d	description

Note: The maximum length of a command description is 100 UTF-8 codepoints. If your command description is longer than this, it will be truncated.

Returns: slashcommand& reference to self for chaining of calls

◆ set_dm_permission()

slashcommand & dpp::slashcommand::set_dm_permission ( bool dm )

Set the dm permission for the command.

Parameters

dm	true to allow this command in dms

Returns: slashcommand& reference to self

◆ set_name()

slashcommand & dpp::slashcommand::set_name ( const std::string & n )

Set the name of the command.

Parameters

n	name of command

Note: The maximum length of a command name is 32 UTF-8 codepoints. If your command name is longer than this, it will be truncated. The command name will be set to lowercase when the type is the default dpp::ctxm_chat_input.

Returns: slashcommand& reference to self for chaining of calls

◆ set_type()

slashcommand & dpp::slashcommand::set_type ( slashcommand_contextmenu_type _type )

Set the type of the slash command (only for context menu entries)

Parameters

_type Type of context menu entry this command represents

Note: If the type is dpp::ctxm_chat_input, the command name will be set to lowercase.

Returns: slashcommand& reference to self for chaining of calls

Member Data Documentation

◆ application_id

snowflake dpp::slashcommand::application_id

Application id (usually matches your bots id)

◆ default_member_permissions

permission dpp::slashcommand::default_member_permissions

The default permissions of this command on a guild. D++ defaults this to p_use_application_commands.

Note: You can set it to 0 to disable the command for everyone except admins by default

◆ default_permission

bool dpp::slashcommand::default_permission

whether the command is enabled by default when the app is added to a guild. This has no effect as the default_member_permissions value is used instead.

Deprecated:: Discord discourage use of this value and instead you should use default_member_permissions.

◆ description

std::string dpp::slashcommand::description

Command description (1-100 chars)

◆ description_localizations

std::map<std::string, std::string> dpp::slashcommand::description_localizations

Localisations of command description.

◆ dm_permission

bool dpp::slashcommand::dm_permission

True if this command should be allowed in a DM D++ defaults this to false. Cannot be set to true in a guild command, only a global command.

◆ id

snowflake dpp::managed::id

inherited

Unique ID of object set by Discord. This value contains a timestamp, worker ID, internal server ID, and an incrementing value. Only the timestamp is relevant to us as useful metadata.

◆ name

std::string dpp::slashcommand::name

Command name (1-32 chars)

◆ name_localizations

std::map<std::string, std::string> dpp::slashcommand::name_localizations

Localisations of command name.

◆ options

std::vector<command_option> dpp::slashcommand::options

Command options (parameters)

◆ permissions

std::vector<command_permission> dpp::slashcommand::permissions

command permissions

Deprecated:: Discord discourage use of this value and instead you should use default_member_permissions.

◆ type

slashcommand_contextmenu_type dpp::slashcommand::type

Context menu type, defaults to dpp::ctxm_chat_input.

◆ version

snowflake dpp::slashcommand::version

autoincrementing version identifier updated during substantial record changes

Public Member Functions

Public Attributes

Detailed Description

Constructor & Destructor Documentation

◆ slashcommand() [1/2]

◆ slashcommand() [2/2]

◆ ~slashcommand()

Member Function Documentation

◆ add_localization()

◆ add_option()

◆ add_permission()

◆ build_json()

◆ disable_default_permissions()

◆ fill_from_json()

◆ get_creation_time()

◆ operator!=()

◆ operator==()

◆ set_application_id()

◆ set_default_permissions()

◆ set_description()

◆ set_dm_permission()

◆ set_name()

◆ set_type()

Member Data Documentation

◆ application_id

◆ default_member_permissions

◆ default_permission

◆ description

◆ description_localizations

◆ dm_permission

◆ id

◆ name

◆ name_localizations

◆ options

◆ permissions

◆ type

◆ version