CRM_Core_Permission_UnitTests

class CRM_Core_Permission_UnitTests extends CRM_Core_Permission_Base

Properties

array $permissions permission mapping to stub check() calls

Methods

NULL|string
translatePermission(string $perm, string $nativePrefix, array $map)

Translate permission.

from CRM_Core_Permission_Base
string
getPermission()

Get the current permission of this user.

from CRM_Core_Permission_Base
string
whereClause(int $type, array $tables, array $whereTables)

Get the permissioned where clause for the user.

string
getPermissionedStaticGroupClause(int $type, array $tables, array $whereTables)

Get the permissioned where clause for the user when trying to see groups.

from CRM_Core_Permission_Base
array
group(string $groupType = NULL, bool $excludeHidden = TRUE)

Get all groups from database, filtered by permissions for this user

from CRM_Core_Permission_Base
string
groupClause(int $type, array $tables, array $whereTables)

Get group clause for this user.

from CRM_Core_Permission_Base
check(string $str, int $userId = NULL)

Given a permission string, check for access requirements

bool
checkGroupRole(array $array)

Given a roles array, check for access requirements

from CRM_Core_Permission_Base
permissionEmails(string $permissionName)

Get all the contact emails for users that have a specific permission.

from CRM_Core_Permission_Base
roleEmails(string $roleName)

Get all the contact emails for users that have a specific role.

from CRM_Core_Permission_Base
bool
isModulePermissionSupported()

Determine whether the permission store allows us to store a list of permissions generated dynamically (eg by hook_civicrm_permissions.)

from CRM_Core_Permission_Base
upgradePermissions(array $permissions)

Ensure that the CMS supports all the permissions defined by CiviCRM and its extensions. If there are stale permissions, they should be deleted. This is useful during module upgrade when the newer module version has removed permission that were defined in the older version.

from CRM_Core_Permission_Base
static array
getModulePermissions($module)

Get the permissions defined in the hook_civicrm_permission implementation of the given module.

from CRM_Core_Permission_Base
array
getAllModulePermissions(bool $descriptions = FALSE)

Get the permissions defined in the hook_civicrm_permission implementation in all enabled CiviCRM module extensions.

from CRM_Core_Permission_Base

Details

in CRM_Core_Permission_Base at line 61
NULL|string translatePermission(string $perm, string $nativePrefix, array $map)

Translate permission.

Parameters

string $perm Permission string e.g "administer CiviCRM", "cms:access user record", "Drupal:administer content", "Joomla:action:com_asset"
string $nativePrefix
array $map Array($portableName => $nativeName).

Return Value

NULL|string a permission name

in CRM_Core_Permission_Base at line 85
string getPermission()

Get the current permission of this user.

Return Value

string the permission of the user (edit or view or null)

at line 82
string whereClause(int $type, array $tables, array $whereTables)

Get the permissioned where clause for the user.

Parameters

int $type The type of permission needed.
array $tables (reference ) add the tables that are needed for the select clause.
array $whereTables (reference ) add the tables that are needed for the where clause.

Return Value

string the group where clause for this user

in CRM_Core_Permission_Base at line 119
string getPermissionedStaticGroupClause(int $type, array $tables, array $whereTables)

Get the permissioned where clause for the user when trying to see groups.

Parameters

int $type The type of permission needed.
array $tables (reference ) add the tables that are needed for the select clause.
array $whereTables (reference ) add the tables that are needed for the where clause.

Return Value

string the group where clause for this user

in CRM_Core_Permission_Base at line 137
array group(string $groupType = NULL, bool $excludeHidden = TRUE)

Get all groups from database, filtered by permissions for this user

Parameters

string $groupType Type of group(Access/Mailing).
bool $excludeHidden exclude hidden groups.

Return Value

array array reference of all groups.

in CRM_Core_Permission_Base at line 154
string groupClause(int $type, array $tables, array $whereTables)

Get group clause for this user.

Parameters

int $type The type of permission needed.
array $tables (reference ) add the tables that are needed for the select clause.
array $whereTables (reference ) add the tables that are needed for the where clause.

Return Value

string the group where clause for this user

at line 57
check(string $str, int $userId = NULL)

Given a permission string, check for access requirements

Parameters

string $str The permission to check.
int $userId

in CRM_Core_Permission_Base at line 179
bool checkGroupRole(array $array)

Given a roles array, check for access requirements

Parameters

array $array The roles to check.

Return Value

bool true if yes, else false

in CRM_Core_Permission_Base at line 190
permissionEmails(string $permissionName)

Get all the contact emails for users that have a specific permission.

Parameters

string $permissionName Name of the permission we are interested in.

in CRM_Core_Permission_Base at line 201
roleEmails(string $roleName)

Get all the contact emails for users that have a specific role.

Parameters

string $roleName Name of the role we are interested in.

in CRM_Core_Permission_Base at line 212
bool isModulePermissionSupported()

Determine whether the permission store allows us to store a list of permissions generated dynamically (eg by hook_civicrm_permissions.)

Return Value

bool

in CRM_Core_Permission_Base at line 228
upgradePermissions(array $permissions)

Ensure that the CMS supports all the permissions defined by CiviCRM and its extensions. If there are stale permissions, they should be deleted. This is useful during module upgrade when the newer module version has removed permission that were defined in the older version.

Parameters

array $permissions Same format as CRM_Core_Permission::getCorePermissions().

Exceptions

CRM_Core_Exception

See also

CRM_Core_Permission::getCorePermissions

in CRM_Core_Permission_Base at line 245
static array getModulePermissions($module)

Get the permissions defined in the hook_civicrm_permission implementation of the given module.

Note: At time of writing, this is only used with native extension-modules, so there's one, predictable calling convention (regardless of CMS).

Parameters

$module

Return Value

array Array of permissions, in the same format as CRM_Core_Permission::getCorePermissions().

See also

CRM_Core_Permission::getCorePermissions

in CRM_Core_Permission_Base at line 265
array getAllModulePermissions(bool $descriptions = FALSE)

Get the permissions defined in the hook_civicrm_permission implementation in all enabled CiviCRM module extensions.

Parameters

bool $descriptions

Return Value

array Array of permissions, in the same format as CRM_Core_Permission::getCorePermissions().