This function reloads the ACL's and the ACL groups from the ACL XML file. All ACL and ACL group elements are invalid after a call to this and should not be used anymore.

OOP Syntax Help! I don't understand this!

• Method: ACL.reload(...)

Syntax

bool aclReload ( )

Returns

• bool: result

Returns true if the XML was successfully reloaded from the file, false or nil if the XML was invalid, didn't exist or could not be loaded for some other reason.

Code Examples

Example 1 Example 2 (OOP)

server

This example allows an admin to reload the ACL by typing /reloadACL.

local function reloadACL(source, command)
  -- Check if they're an admin...
  if (isObjectInACLGroup("user."..getAccountName(getPlayerAccount(source)), aclGetGroup( "Admin"))) then
    local reload = aclReload() -- Reload the ACL
    if (reload) then -- Check it was reloaded successfully
      outputChatBox("ACL was successfully reloaded.", source, 255, 0, 0) -- If so, output it
    else -- If not, output it (line below)
      outputChatBox("An unknown error occured. Please check the ACL file exists.", source, 255, 0, 0)
    end
  else -- If they're not an admin, output it (below)
    outputChatBox("You must be an admin to use this command!", source, 255, 0, 0)
  end
end
addCommandHandler("reloadACL", reloadACL)

server

OOP Required

This example allows an admin to reload the ACL by typing /reloadACL.

local function reloadACL(source, command)
  -- Check if they're an admin...
  if (ACLGroup.get("Admin"):doesContainObject("user."..source.account.name)) then
    local reload = ACL.reload() -- Reload the ACL
    if (reload) then -- Check it was reloaded successfully
      source:outputChat("ACL was successfully reloaded.", 255, 0, 0) -- If so, output it
    else -- If not, output it (line below)
      source:outputChat("An unknown error occured. Please check the ACL file exists.", 255, 0, 0)
    end
  else -- If they're not an admin, output it (below)
    source:outputChat("You must be an admin to use this command!", 255, 0, 0)
  end
end
addCommandHandler("reloadACL", reloadACL)

See Also

ACL Functions

• aclCreate
• aclCreateGroup
• aclDestroy
• aclDestroyGroup
• aclGet
• aclGetName
• aclGetRight
• aclGetGroup
• aclGroupAddACL
• aclGroupAddObject
• aclGroupGetName
• aclGroupList
• aclGroupListObjects
• aclGroupListACL
• aclGroupRemoveACL
• aclGroupRemoveObject
• aclList
• aclListRights
• aclObjectGetGroups
• aclReload
• aclRemoveRight
• aclSave
• aclSetRight
• hasObjectPermissionTo
• isObjectInACLGroup

ACL Elements

• acl
• aclgroup

Reference

• Scripting Functions