Set or Get Current Group Tag or Title

14 October 2018

C10 - added the list action, added the optional activate parameter.

21 May 2016

Release 9.78 - added optional parameter target.

20 February 2015

Release 7.71 - renamed the command from settitle to tag.

tag (Commands)
Type	Corrade progressive command
Command	`tag`
Description	The `tag` command can make Corrade get or set the current group tag.
Permissions	`grooming`
Parameters	`group`, `password`, `action`
Last Changes	Release 9.78 - added optional parameter `target`.

The tag command can make Corrade get or set the current group tag.

Command Required Parameters Required Corrade Permissions Example

tag

group, password, action

grooming

llInstantMessage(CORRADE,
    wasKeyValueEncode(
        [
            "command", "tag",
            "group", wasURLEscape(GROUP),
            "password", wasURLEscape(PASSWORD),
            "action", "set",
            // the title must exist
            "title", wasURLEscape("Good day!")
        ]
    )
);

Parameter	Possible Value	Second Parameter	Possible Value	Description
`action`	`set`	`title`	Any title name that is defined for the command group.	Set the current group tag.
	`get`			Gets the current group tag.
	`list`			Lists all group titles as a CSV list of title name by title UUID.

Optional Parameter	Possible Value	Description
`target`	A group name or UUID.	The group to act upon. If this parameter is omitted, then the command acts upon the configured group passed to the `group` parameter.
`activate`	`True` or `False`	Activate the group after setting the title.

Note

Note that setting the active group title does not imply setting the active group as well such that the activate parameter must be sent as True for the set action if it is desired to set the active group after setting the title.