User capabilities service. More...

Public Member Functions
	__construct (protected EventsService $events, protected EntityTable $entities, protected SessionManagerService $session_manager)
	Constructor. More...

	canBypassPermissionsCheck (int $user_guid=0)
	Decides if the access system should be ignored for a user. More...

	canEdit (\ElggEntity $entity, int $user_guid=0)
	Can a user edit this entity? More...

	canDelete (\ElggEntity $entity, int $user_guid=0)
	Can a user delete this entity? More...

	canDeleteRiverItem (\ElggRiverItem $item, int $user_guid=0)
	Can a user delete this river item? More...

	canEditAnnotation (\ElggEntity $entity, int $user_guid=0, ?\ElggAnnotation $annotation=null)
	Determines whether 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, int $user_guid=0)
	Can a user comment on an entity? More...

	canAnnotate (\ElggEntity $entity, int $user_guid=0, string $annotation_name='')
	Can a user annotate an entity? More...

	canDownload (\ElggFile $entity, int $user_guid=0, bool $default=true)
	Can a user download a file? More...

Detailed Description

User capabilities service.

Definition at line 14 of file UserCapabilities.php.

Constructor & Destructor Documentation

◆ __construct()

Elgg\UserCapabilities::__construct	(	protected EventsService	$events,
		protected EntityTable	$entities,
		protected SessionManagerService	$session_manager
	)

Constructor.

Parameters

EventsService	$events	Events service
EntityTable	$entities	Entity table
SessionManagerService	$session_manager	Session

Definition at line 23 of file UserCapabilities.php.

Member Function Documentation

◆ canAnnotate()

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

Can a user annotate an entity?

@tip Can be overridden by registering for the event [permissions_check:annotate:<name>, <entity type>] or [permissions_check:annotate, <entity type>]. The events are called in that order.

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

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 324 of file UserCapabilities.php.

◆ canBypassPermissionsCheck()

Elgg\UserCapabilities::canBypassPermissionsCheck ( int $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 41 of file UserCapabilities.php.

◆ canComment()

Elgg\UserCapabilities::canComment	(	\ElggEntity	$entity,
		int	$user_guid = `0`
	)

Can a user comment on an entity?

@tip Can be overridden by registering for the permissions_check:comment, <entity type> event.

Parameters

\ElggEntity	$entity	Object entity
int	$user_guid	User guid (default is logged in user)

Returns: bool

Definition at line 287 of file UserCapabilities.php.

◆ canDelete()

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

Can a user delete this entity?

@tip Can be overridden by registering for the 'permissions_check:delete' event.

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 126 of file UserCapabilities.php.

◆ canDeleteRiverItem()

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

Can a user delete this river item?

@tip Can be overridden by registering for the "permissions_check:delete", "river" event.

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 157 of file UserCapabilities.php.

◆ canDownload()

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

Can a user download a file?

@tip Can be overridden by registering for the 'permissions_check:download', 'file' event.

Parameters

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

Returns: bool

Definition at line 361 of file UserCapabilities.php.

◆ canEdit()

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

Can a user edit this entity?

@tip Can be overridden by registering for the 'permissions_check' event.

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 67 of file UserCapabilities.php.

◆ canEditAnnotation()

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

Determines whether 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)
null \| \ElggAnnotation	$annotation	Annotation

Returns: bool

Definition at line 184 of file UserCapabilities.php.

◆ canWriteToContainer()

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 233 of file UserCapabilities.php.

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

engine/classes/Elgg/UserCapabilities.php

Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ canAnnotate()

◆ canBypassPermissionsCheck()

◆ canComment()

◆ canDelete()

◆ canDeleteRiverItem()

◆ canDownload()

◆ canEdit()

◆ canEditAnnotation()

◆ canWriteToContainer()