AclGroupAddObject: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
mNo edit summary
 
(11 intermediate revisions by 10 users not shown)
Line 2: Line 2:
{{Server function}}
{{Server function}}
<!-- Describe in plain english what this function does. Don't go into details, just give an overview -->
<!-- Describe in plain english what this function does. Don't go into details, just give an overview -->
This function adds an object to the given ACL group. An object can be a player, specified as:
This function adds an object to the given ACL group. An object can be a player's account, specified as:
   ''player.<accountname>''
   ''user.<accountname>''


Or a resource, specified as:
Or a resource, specified as:
   ''resource.<resourcename>''
   ''resource.<resourcename>''


Objects are specified as strings. The ACL groups work for the players and the resources that are specified in them.
Objects are specified as strings. The ACL groups work for the user accounts and the resources that are specified in them.


==Syntax==  
==Syntax==  
Line 15: Line 15:
bool aclGroupAddObject ( aclgroup theGroup, string theObjectName )
bool aclGroupAddObject ( aclgroup theGroup, string theObjectName )
</syntaxhighlight>  
</syntaxhighlight>  
 
{{OOP||[[aclgroup]]:addObject||}}
===Required Arguments===  
===Required Arguments===  
<!-- List each argument one per line. This should be the argument's name as in the argument list above, NOT the argument's data type -->
<!-- List each argument one per line. This should be the argument's name as in the argument list above, NOT the argument's data type -->
*'''theGroup:''' The group to add the object name string too.
*'''theGroup:''' The group to add the object name string too.
*'''theGroupName:''' The object string to add to the given ACL
*'''theObjectName:''' The object string to add to the given ACL.


===Returns===
===Returns===
Line 27: Line 27:
==Example==  
==Example==  
<!-- Explain what the example is in a single sentance -->
<!-- Explain what the example is in a single sentance -->
This example does...
This example makes every player able to use a command named "giveAccountAdminRights" that will add a specific accountname as an ACL object to the "Admin" group.
<!-- Add the code below, an emphasis should be on making it clear, not optimized. You could provide two versions if you wish, one clear and well commented, the other optimized -->
<!-- Add the code below, an emphasis should be on making it clear, not optimized. You could provide two versions if you wish, one clear and well commented, the other optimized -->
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
--TODO
function giveAdminRights (playerSource, commandName, accountName) --add the function giveAdminRights and specify its arguments
if accountName then --if there was an accountName entered then
aclGroupAddObject (aclGetGroup("Admin"), "user."..accountName) --add an ACL object using the form "user.[accountName]" to the ACL group "Admin"
outputChatBox ("Account '"..accountName.."' succesfully added to the admin group", playerSource) --output a notification to the player who entered the command that the acocunt was successfully added
else --else output an error message and the correct syntax of the command to the player who entered it
outputChatBox ("No account name specified.", playerSource)
outputChatBox ("Correct syntax: /giveAccountAdminRights [accountName]", playerSource)
end
end
 
addCommandHandler ("giveAccountAdminRights", giveAdminRights) --add a command "giveAccountAdminRights" and attch the function "giveAdminRights" to it
</syntaxhighlight>
</syntaxhighlight>


Line 36: Line 46:
<!-- Change FunctionArea to the area that this function is in on the main function list page, e.g. Server, Player, Vehicle etc -->
<!-- Change FunctionArea to the area that this function is in on the main function list page, e.g. Server, Player, Vehicle etc -->
{{ACL_functions}}
{{ACL_functions}}
[[Category:Incomplete]]
 
[[ar:aclGroupAddObject]]

Latest revision as of 15:05, 11 June 2023

This function adds an object to the given ACL group. An object can be a player's account, specified as: 

 user.<accountname>

Or a resource, specified as: 

 resource.<resourcename>

Objects are specified as strings. The ACL groups work for the user accounts and the resources that are specified in them.

Syntax

bool aclGroupAddObject ( aclgroup theGroup, string theObjectName )

OOP Syntax Help! I don't understand this!

Method: aclgroup:addObject(...)


Required Arguments

  • theGroup: The group to add the object name string too.
  • theObjectName: The object string to add to the given ACL.

Returns

Returns true if the object was successfully added to the ACL, false if it already existed in the list.

Example

This example makes every player able to use a command named "giveAccountAdminRights" that will add a specific accountname as an ACL object to the "Admin" group. 

function giveAdminRights (playerSource, commandName, accountName) --add the function giveAdminRights and specify its arguments
	if accountName then --if there was an accountName entered then
		aclGroupAddObject (aclGetGroup("Admin"), "user."..accountName) --add an ACL object using the form "user.[accountName]" to the ACL group "Admin"
		outputChatBox ("Account '"..accountName.."' succesfully added to the admin group", playerSource) --output a notification to the player who entered the command that the acocunt was successfully added
	else --else output an error message and the correct syntax of the command to the player who entered it
		outputChatBox ("No account name specified.", playerSource)
		outputChatBox ("Correct syntax: /giveAccountAdminRights [accountName]", playerSource)
	end
end

addCommandHandler ("giveAccountAdminRights", giveAdminRights) --add a command "giveAccountAdminRights" and attch the function "giveAdminRights" to it

See Also

Retrieved from "https://wiki.multitheftauto.com/wiki/AclGroupAddObject?oldid=76952"