Elgg\UserCapabilities Class Reference

User capabilities service. More...

Public Member Functions
	__construct (PluginHooksService $hooks, EntityTable $entities, ElggSession $session)
	Constructor. More...
	canBypassPermissionsCheck ($user_guid=0)
	Decides if the access system should be ignored for a user. More...
	canEdit (ElggEntity $entity, $user_guid=0)
	Can a user edit this entity? More...
	canDelete (ElggEntity $entity, $user_guid=0)
	Can a user delete this entity? More...
	canDeleteRiverItem (ElggRiverItem $item, $user_guid=0)
	Can a user delete this river item? More...
	canEditAnnotation (ElggEntity $entity, $user_guid=0, ElggAnnotation $annotation=null)
	Determines whether or not the user can edit this annotation. More...
	canWriteToContainer (ElggEntity $entity, string $type, string $subtype, int $user_guid=0)
	Can a user add an entity to this container. More...
	canComment (ElggEntity $entity, $user_guid=0, $default=null)
	Can a user comment on an entity? More...
	canAnnotate (ElggEntity $entity, $user_guid=0, $annotation_name= '')
	Can a user annotate an entity? More...
	canDownload (ElggFile $entity, $user_guid=0, $default=true)
	Can a user download a file? More...

Detailed Description

User capabilities service.

Definition at line 20 of file UserCapabilities.php.

Constructor & Destructor Documentation

Elgg\UserCapabilities::__construct	(	PluginHooksService	$hooks,
		EntityTable	$entities,
		ElggSession	$session
	)

Constructor.

Parameters

PluginHooksService	$hooks	Plugin hooks service
EntityTable	$entities	Entity table
ElggSession	$session	Session

Definition at line 44 of file UserCapabilities.php.

Member Function Documentation

Elgg\UserCapabilities::canAnnotate	(	ElggEntity	$entity,
			$user_guid = 0,
			$annotation_name = ''
	)

Can a user annotate an entity?

Can be overridden by registering for the plugin hook [permissions_check:annotate:<name>, <entity type>="">] or [permissions_check:annotate, <entity type>="">]. The hooks are called in that order.

If you want logged out users to annotate an object, do not call canAnnotate(). It's easier than using the plugin hook.

Parameters

ElggEntity	$entity	Objet entity
int	$user_guid	User guid (default is logged in user)
string	$annotation_name	The name of the annotation (default is unspecified)

Returns

bool

Definition at line 349 of file UserCapabilities.php.

Elgg\UserCapabilities::canBypassPermissionsCheck

(

$user_guid = 0

)

Decides if the access system should be ignored for a user.

Returns true (meaning ignore access) if either of these 2 conditions are true: 1) an admin user guid is passed to this function. 2) elgg_get_ignore_access() returns true.

Parameters

int

$user_guid

The user to check against.

Returns

bool

Definition at line 61 of file UserCapabilities.php.

Elgg\UserCapabilities::canComment	(	ElggEntity	$entity,
			$user_guid = 0,
			$default = null
	)

Can a user comment on an entity?

Can be overridden by registering for the permissions_check:comment, <entity type>=""> plugin hook.

Parameters

ElggEntity	$entity	Object entity
int	$user_guid	User guid (default is logged in user)
bool	$default	Default permission

Returns

bool

Definition at line 306 of file UserCapabilities.php.

Elgg\UserCapabilities::canDelete	(	ElggEntity	$entity,
			$user_guid = 0
	)

Can a user delete this entity?

Can be overridden by registering for the permissions_check:delete plugin hook.

Parameters

ElggEntity	$entity	Object entity
int	$user_guid	The user GUID, optionally (default: logged in user)

Returns

bool Whether this entity is deletable by the given user.

Since

1.11

Definition at line 144 of file UserCapabilities.php.

Elgg\UserCapabilities::canDeleteRiverItem	(	ElggRiverItem	$item,
			$user_guid = 0
	)

Can a user delete this river item?

Can be overridden by registering for the "permissions_check:delete", "river" plugin hook.

Parameters

ElggRiverItem	$item	River item
int	$user_guid	The user GUID, optionally (default: logged in user)

Returns

bool Whether this river item should be considered deletable by the given user.

Since

2.3

Definition at line 175 of file UserCapabilities.php.

Elgg\UserCapabilities::canDownload	(	ElggFile	$entity,
			$user_guid = 0,
			$default = true
	)

Can a user download a file?

Can be overridden by registering for the permissions_check:download,file plugin hook.

Parameters

ElggFile	$entity	File entity
int	$user_guid	User guid (default is logged in user)
bool	$default	Default permission

Returns

bool

Definition at line 393 of file UserCapabilities.php.

Elgg\UserCapabilities::canEdit	(	ElggEntity	$entity,
			$user_guid = 0
	)

Can a user edit this entity?

Can be overridden by registering for the permissions_check plugin hook.

Parameters

ElggEntity	$entity	Object entity
int	$user_guid	The user GUID, optionally (default: logged in user)

Returns

bool Whether this entity is editable by the given user.

Definition at line 87 of file UserCapabilities.php.

Elgg\UserCapabilities::canEditAnnotation	(	ElggEntity	$entity,
			$user_guid = 0,
		ElggAnnotation	$annotation = null
	)

Determines whether or not the user can edit this annotation.

Parameters

Elggentity	$entity	Object entity
int	$user_guid	The GUID of the user (defaults to currently logged in user)
ElggAnnotation	$annotation	Annotation

Returns

bool

Definition at line 202 of file UserCapabilities.php.

Elgg\UserCapabilities::canWriteToContainer	(	ElggEntity	$entity,
		string	$type,
		string	$subtype,
		int	$user_guid = 0
	)

Can a user add an entity to this container.

Parameters

ElggEntity	$entity	Container entity
string	$type	The type of entity we're looking to write
string	$subtype	The subtype of the entity we're looking to write
int	$user_guid	The GUID of the user creating the entity (0 for logged in user).

Returns

bool

Definition at line 251 of file UserCapabilities.php.

---

The documentation for this class was generated from the following file:

• engine/classes/Elgg/UserCapabilities.php