LlInviteToGroup

From Second Life Wiki

LlInviteToGroup
Jump to: navigation, search
Image:Emblem-important-yellow.png LSL Feature Request
The described function does not exist. This article is a feature request.

Contents

Description

Function: llInviteToGroup( key avatar, string role );

Adds avatar to the group the object is deeded to.

• key avatar
• string role Role name avatar is to have.

Requires the PERMISSION_GROUP_INVITE permission, granted by a group officer, to run.

Specification

We need some way to invite an avatar to join the owners group if he has the right to invite members and has given the script permission to act as his delegate.

llInviteToGroup(key group, key avatar)

or

llInviteToGroup(key avatar)

would be great.

We basically need to be able to perform group administration tasks if the script owner is in the group and has the right to perform these tasks.

Depending on if the script has a ('active') group if it's not group-owned we might or might not need another function: list llGetOwnerGroups()

Caveats

  • Do not depend upon the auto-grant status of permissions. Always use the run_time_permissions event.
  • If the script lacks the permission PERMISSION_GROUP_INVITE, the script will shout an error on DEBUG_CHANNEL and the operation fails (but the script continues to run).
  • If PERMISSION_GROUP_INVITE is granted by anyone other than a group officer, then when the function is called an error will be shouted on DEBUG_CHANNEL.
  • Once the PERMISSION_GROUP_INVITE permission is granted there is no way to revoke it. The script will only lose the permission if it is reset or the object derezzed (deleted, detached, or taken).

Examples

See Also

Events

•  run_time_permissions Permission receiving event

Functions

•  llGetPermissions Get the permissions granted
•  llGetPermissionsKey Get the agent who granted permissions
•  llRequestPermissions Request permissions

Articles

•  Script permissions
Personal tools