3 +--------------------------------------------------------------------+
4 | CiviCRM version 4.7 |
5 +--------------------------------------------------------------------+
6 | Copyright CiviCRM LLC (c) 2004-2016 |
7 +--------------------------------------------------------------------+
8 | This file is a part of CiviCRM. |
10 | CiviCRM is free software; you can copy, modify, and distribute it |
11 | under the terms of the GNU Affero General Public License |
12 | Version 3, 19 November 2007 and the CiviCRM Licensing Exception. |
14 | CiviCRM is distributed in the hope that it will be useful, but |
15 | WITHOUT ANY WARRANTY; without even the implied warranty of |
16 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. |
17 | See the GNU Affero General Public License for more details. |
19 | You should have received a copy of the GNU Affero General Public |
20 | License and the CiviCRM Licensing Exception along |
21 | with this program; if not, contact CiviCRM LLC |
22 | at info[AT]civicrm[DOT]org. If you have questions about the |
23 | GNU Affero General Public License or the licensing of CiviCRM, |
24 | see the CiviCRM license FAQ at http://civicrm.org/licensing |
25 +--------------------------------------------------------------------+
31 * @copyright CiviCRM LLC (c) 2004-2016
37 * This is the basic permission class wrapper
39 class CRM_Core_Permission
{
42 * Static strings used to compose permissions.
47 const EDIT_GROUPS
= 'edit contacts in ', VIEW_GROUPS
= 'view contacts in ';
50 * The various type of permissions.
54 const EDIT
= 1, VIEW
= 2, DELETE
= 3, CREATE
= 4, SEARCH
= 5, ALL
= 6, ADMIN
= 7;
57 * A placeholder permission which always fails.
59 const ALWAYS_DENY_PERMISSION
= "*always deny*";
62 * A placeholder permission which always fails.
64 const ALWAYS_ALLOW_PERMISSION
= "*always allow*";
67 * Various authentication sources.
71 const AUTH_SRC_UNKNOWN
= 0, AUTH_SRC_CHECKSUM
= 1, AUTH_SRC_SITEKEY
= 2, AUTH_SRC_LOGIN
= 4;
74 * Get the current permission of this user.
77 * the permission of the user (edit or view or null)
79 public static function getPermission() {
80 $config = CRM_Core_Config
::singleton();
81 return $config->userPermissionClass
->getPermission();
85 * Given a permission string or array, check for access requirements
86 * @param mixed $permissions
87 * The permission to check as an array or string -see examples.
92 * Must have 'access CiviCRM'
93 * (string) 'access CiviCRM'
96 * Ex 2 Must have 'access CiviCRM' and 'access Ajax API'
97 * array('access CiviCRM', 'access Ajax API')
99 * Ex 3 Must have 'access CiviCRM' or 'access Ajax API'
101 * array('access CiviCRM', 'access Ajax API'),
104 * Ex 4 Must have 'access CiviCRM' or 'access Ajax API' AND 'access CiviEvent'
106 * array('access CiviCRM', 'access Ajax API'),
107 * 'access CiviEvent',
110 * Note that in permissions.php this is keyed by the action eg.
111 * (access Civi || access AJAX) && (access CiviEvent || access CiviContribute)
112 * 'myaction' => array(
113 * array('access CiviCRM', 'access Ajax API'),
114 * array('access CiviEvent', 'access CiviContribute')
118 * true if yes, else false
120 public static function check($permissions) {
121 $permissions = (array) $permissions;
123 $tempPerm = CRM_Core_Config
::singleton()->userPermissionTemp
;
125 foreach ($permissions as $permission) {
126 if (is_array($permission)) {
127 foreach ($permission as $orPerm) {
128 if (self
::check($orPerm)) {
129 //one of our 'or' permissions has succeeded - stop checking this permission
133 //none of our our conditions was met
138 !CRM_Core_Config
::singleton()->userPermissionClass
->check($permission)
139 && !($tempPerm && $tempPerm->check($permission))
141 //one of our 'and' conditions has not been met
150 * Determine if any one of the permissions strings applies to current user.
152 * @param array $perms
155 public static function checkAnyPerm($perms) {
156 foreach ($perms as $perm) {
157 if (CRM_Core_Permission
::check($perm)) {
165 * Given a group/role array, check for access requirements
167 * @param array $array
168 * The group/role to check.
171 * true if yes, else false
173 public static function checkGroupRole($array) {
174 $config = CRM_Core_Config
::singleton();
175 return $config->userPermissionClass
->checkGroupRole($array);
179 * Get the permissioned where clause for the user.
182 * The type of permission needed.
183 * @param array $tables
184 * (reference ) add the tables that are needed for the select clause.
185 * @param array $whereTables
186 * (reference ) add the tables that are needed for the where clause.
189 * the group where clause for this user
191 public static function getPermissionedStaticGroupClause($type, &$tables, &$whereTables) {
192 $config = CRM_Core_Config
::singleton();
193 return $config->userPermissionClass
->getPermissionedStaticGroupClause($type, $tables, $whereTables);
197 * Get all groups from database, filtered by permissions
200 * @param string $groupType
201 * Type of group(Access/Mailing).
202 * @param bool $excludeHidden
203 * exclude hidden groups.
207 * array reference of all groups.
209 public static function group($groupType, $excludeHidden = TRUE) {
210 $config = CRM_Core_Config
::singleton();
211 return $config->userPermissionClass
->group($groupType, $excludeHidden);
217 public static function customGroupAdmin() {
220 // check if user has all powerful permission
221 // or administer civicrm permission (CRM-1905)
222 if (self
::check('access all custom data')) {
227 self
::check('administer Multiple Organizations') &&
228 self
::isMultisiteEnabled()
233 if (self
::check('administer CiviCRM')) {
246 public static function customGroup($type = CRM_Core_Permission
::VIEW
, $reset = FALSE) {
247 $customGroups = CRM_Core_PseudoConstant
::get('CRM_Core_DAO_CustomField', 'custom_group_id',
248 array('fresh' => $reset));
249 $defaultGroups = array();
251 // check if user has all powerful permission
252 // or administer civicrm permission (CRM-1905)
253 if (self
::customGroupAdmin()) {
254 $defaultGroups = array_keys($customGroups);
257 return CRM_ACL_API
::group($type, NULL, 'civicrm_custom_group', $customGroups, $defaultGroups);
262 * @param null $prefix
267 public static function customGroupClause($type = CRM_Core_Permission
::VIEW
, $prefix = NULL, $reset = FALSE) {
268 if (self
::customGroupAdmin()) {
272 $groups = self
::customGroup($type, $reset);
273 if (empty($groups)) {
277 return "{$prefix}id IN ( " . implode(',', $groups) . ' ) ';
287 public static function ufGroupValid($gid, $type = CRM_Core_Permission
::VIEW
) {
292 $groups = self
::ufGroup($type);
293 return !empty($groups) && in_array($gid, $groups) ?
TRUE : FALSE;
301 public static function ufGroup($type = CRM_Core_Permission
::VIEW
) {
302 $ufGroups = CRM_Core_PseudoConstant
::get('CRM_Core_DAO_UFField', 'uf_group_id');
304 $allGroups = array_keys($ufGroups);
306 // check if user has all powerful permission
307 if (self
::check('profile listings and forms')) {
312 case CRM_Core_Permission
::VIEW
:
313 if (self
::check('profile view')) {
318 case CRM_Core_Permission
::CREATE
:
319 if (self
::check('profile create')) {
324 case CRM_Core_Permission
::EDIT
:
325 if (self
::check('profile edit')) {
330 case CRM_Core_Permission
::SEARCH
:
331 if (self
::check('profile listings')) {
337 return CRM_ACL_API
::group($type, NULL, 'civicrm_uf_group', $ufGroups);
342 * @param null $prefix
343 * @param bool $returnUFGroupIds
345 * @return array|string
347 public static function ufGroupClause($type = CRM_Core_Permission
::VIEW
, $prefix = NULL, $returnUFGroupIds = FALSE) {
348 $groups = self
::ufGroup($type);
349 if ($returnUFGroupIds) {
352 elseif (empty($groups)) {
356 return "{$prefix}id IN ( " . implode(',', $groups) . ' ) ';
362 * @param int $eventID
363 * @param string $context
367 public static function event($type = CRM_Core_Permission
::VIEW
, $eventID = NULL, $context = '') {
368 if (!empty($context)) {
369 if (CRM_Core_Permission
::check($context)) {
373 $events = CRM_Event_PseudoConstant
::event(NULL, TRUE);
374 $includeEvents = array();
376 // check if user has all powerful permission
377 if (self
::check('register for events')) {
378 $includeEvents = array_keys($events);
381 if ($type == CRM_Core_Permission
::VIEW
&&
382 self
::check('view event info')
384 $includeEvents = array_keys($events);
387 $permissionedEvents = CRM_ACL_API
::group($type, NULL, 'civicrm_event', $events, $includeEvents);
389 return $permissionedEvents;
391 if (!empty($permissionedEvents)) {
392 return array_search($eventID, $permissionedEvents) === FALSE ?
NULL : $eventID;
399 * @param null $prefix
403 public static function eventClause($type = CRM_Core_Permission
::VIEW
, $prefix = NULL) {
404 $events = self
::event($type);
405 if (empty($events)) {
409 return "{$prefix}id IN ( " . implode(',', $events) . ' ) ';
415 * @param bool $checkPermission
419 public static function access($module, $checkPermission = TRUE) {
420 $config = CRM_Core_Config
::singleton();
422 if (!in_array($module, $config->enableComponents
)) {
426 if ($checkPermission) {
427 if ($module == 'CiviCase') {
428 return CRM_Case_BAO_Case
::accessCiviCase();
431 return CRM_Core_Permission
::check("access $module");
439 * Check permissions for delete and edit actions.
441 * @param string $module
444 * Action to be check across component.
449 public static function checkActionPermission($module, $action) {
450 //check delete related permissions.
451 if ($action & CRM_Core_Action
::DELETE
) {
452 $permissionName = "delete in $module";
455 $editPermissions = array(
456 'CiviEvent' => 'edit event participants',
457 'CiviMember' => 'edit memberships',
458 'CiviPledge' => 'edit pledges',
459 'CiviContribute' => 'edit contributions',
460 'CiviGrant' => 'edit grants',
461 'CiviMail' => 'access CiviMail',
462 'CiviAuction' => 'add auction items',
464 $permissionName = CRM_Utils_Array
::value($module, $editPermissions);
467 if ($module == 'CiviCase' && !$permissionName) {
468 return CRM_Case_BAO_Case
::accessCiviCase();
471 //check for permission.
472 return CRM_Core_Permission
::check($permissionName);
482 public static function checkMenu(&$args, $op = 'and') {
483 if (!is_array($args)) {
486 foreach ($args as $str) {
487 $res = CRM_Core_Permission
::check($str);
488 if ($op == 'or' && $res) {
491 elseif ($op == 'and' && !$res) {
495 return ($op == 'or') ?
FALSE : TRUE;
504 public static function checkMenuItem(&$item) {
505 if (!array_key_exists('access_callback', $item)) {
506 CRM_Core_Error
::backtrace();
507 CRM_Core_Error
::fatal();
510 // if component_id is present, ensure it is enabled
511 if (isset($item['component_id']) && $item['component_id']) {
512 if (!isset(Civi
::$statics[__CLASS__
]['componentNameId'])) {
513 Civi
::$statics[__CLASS__
]['componentNameId'] = array_flip(CRM_Core_Component
::getComponentIDs());
515 $componentName = Civi
::$statics[__CLASS__
]['componentNameId'][$item['component_id']];
517 $config = CRM_Core_Config
::singleton();
518 if (is_array($config->enableComponents
) && in_array($componentName, $config->enableComponents
)) {
519 // continue with process
526 // the following is imitating drupal 6 code in includes/menu.inc
527 if (empty($item['access_callback']) ||
528 is_numeric($item['access_callback'])
530 return (boolean
) $item['access_callback'];
533 // check whether the following Ajax requests submitted the right key
534 // FIXME: this should be integrated into ACLs proper
535 if (CRM_Utils_Array
::value('page_type', $item) == 3) {
536 if (!CRM_Core_Key
::validate($_REQUEST['key'], $item['path'])) {
541 // check if callback is for checkMenu, if so optimize it
542 if (is_array($item['access_callback']) &&
543 $item['access_callback'][0] == 'CRM_Core_Permission' &&
544 $item['access_callback'][1] == 'checkMenu'
546 $op = CRM_Utils_Array
::value(1, $item['access_arguments'], 'and');
547 return self
::checkMenu($item['access_arguments'][0], $op);
550 return call_user_func_array($item['access_callback'], $item['access_arguments']);
556 * Include disabled components
557 * @param bool $descriptions
558 * Whether to return descriptions
562 public static function basicPermissions($all = FALSE, $descriptions = FALSE) {
563 $cacheKey = implode('-', array($all, $descriptions));
564 if (empty(Civi
::$statics[__CLASS__
][__FUNCTION__
][$cacheKey])) {
565 Civi
::$statics[__CLASS__
][__FUNCTION__
][$cacheKey] = self
::assembleBasicPermissions($all, $descriptions);
567 return Civi
::$statics[__CLASS__
][__FUNCTION__
][$cacheKey];
572 * @param bool $descriptions
573 * whether to return descriptions
577 public static function assembleBasicPermissions($all = FALSE, $descriptions = FALSE) {
578 $config = CRM_Core_Config
::singleton();
579 $prefix = ts('CiviCRM') . ': ';
580 $permissions = self
::getCorePermissions($descriptions);
582 if (self
::isMultisiteEnabled()) {
583 $permissions['administer Multiple Organizations'] = array($prefix . ts('administer Multiple Organizations'));
586 if (!$descriptions) {
587 foreach ($permissions as $name => $attr) {
588 $permissions[$name] = array_shift($attr);
592 $components = CRM_Core_Component
::getEnabledComponents();
595 $components = CRM_Core_Component
::getComponents();
598 foreach ($components as $comp) {
599 $perm = $comp->getPermissions(FALSE, $descriptions);
601 $info = $comp->getInfo();
602 foreach ($perm as $p => $attr) {
604 if (!is_array($attr)) {
605 $attr = array($attr);
608 $attr[0] = $info['translatedName'] . ': ' . $attr[0];
611 $permissions[$p] = $attr;
614 $permissions[$p] = $attr[0];
620 // Add any permissions defined in hook_civicrm_permission implementations.
621 $module_permissions = $config->userPermissionClass
->getAllModulePermissions($descriptions);
622 $permissions = array_merge($permissions, $module_permissions);
623 CRM_Financial_BAO_FinancialType
::permissionedFinancialTypes($permissions, $descriptions);
630 public static function getAnonymousPermissionsWarnings() {
631 static $permissions = array();
632 if (empty($permissions)) {
633 $permissions = array(
634 'administer CiviCRM',
636 $components = CRM_Core_Component
::getComponents();
637 foreach ($components as $comp) {
638 if (!method_exists($comp, 'getAnonymousPermissionWarnings')) {
641 $permissions = array_merge($permissions, $comp->getAnonymousPermissionWarnings());
648 * @param $anonymous_perms
652 public static function validateForPermissionWarnings($anonymous_perms) {
653 return array_intersect($anonymous_perms, self
::getAnonymousPermissionsWarnings());
657 * Get core permissions.
661 public static function getCorePermissions() {
662 $prefix = ts('CiviCRM') . ': ';
663 $permissions = array(
664 'add contacts' => array(
665 $prefix . ts('add contacts'),
666 ts('Create a new contact record in CiviCRM'),
668 'view all contacts' => array(
669 $prefix . ts('view all contacts'),
670 ts('View ANY CONTACT in the CiviCRM database, export contact info and perform activities such as Send Email, Phone Call, etc.'),
672 'edit all contacts' => array(
673 $prefix . ts('edit all contacts'),
674 ts('View, Edit and Delete ANY CONTACT in the CiviCRM database; Create and edit relationships, tags and other info about the contacts'),
676 'view my contact' => array(
677 $prefix . ts('view my contact'),
679 'edit my contact' => array(
680 $prefix . ts('edit my contact'),
682 'delete contacts' => array(
683 $prefix . ts('delete contacts'),
685 'access deleted contacts' => array(
686 $prefix . ts('access deleted contacts'),
687 ts('Access contacts in the trash'),
689 'import contacts' => array(
690 $prefix . ts('import contacts'),
691 ts('Import contacts and activities'),
693 'edit groups' => array(
694 $prefix . ts('edit groups'),
695 ts('Create new groups, edit group settings (e.g. group name, visibility...), delete groups'),
697 'administer CiviCRM' => array(
698 $prefix . ts('administer CiviCRM'),
699 ts('Perform all tasks in the Administer CiviCRM control panel and Import Contacts'),
701 'skip IDS check' => array(
702 $prefix . ts('skip IDS check'),
703 ts('IDS system is bypassed for users with this permission. Prevents false errors for admin users.'),
705 'access uploaded files' => array(
706 $prefix . ts('access uploaded files'),
707 ts('View / download files including images and photos'),
709 'profile listings and forms' => array(
710 $prefix . ts('profile listings and forms'),
711 ts('Access the profile Search form and listings'),
713 'profile listings' => array(
714 $prefix . ts('profile listings'),
716 'profile create' => array(
717 $prefix . ts('profile create'),
718 ts('Use profiles in Create mode'),
720 'profile edit' => array(
721 $prefix . ts('profile edit'),
722 ts('Use profiles in Edit mode'),
724 'profile view' => array(
725 $prefix . ts('profile view'),
727 'access all custom data' => array(
728 $prefix . ts('access all custom data'),
729 ts('View all custom fields regardless of ACL rules'),
731 'view all activities' => array(
732 $prefix . ts('view all activities'),
733 ts('View all activities (for visible contacts)'),
735 'delete activities' => array(
736 $prefix . ts('Delete activities'),
738 'access CiviCRM' => array(
739 $prefix . ts('access CiviCRM'),
740 ts('Master control for access to the main CiviCRM backend and API'),
742 'access Contact Dashboard' => array(
743 $prefix . ts('access Contact Dashboard'),
744 ts('View Contact Dashboard (for themselves and visible contacts)'),
746 'translate CiviCRM' => array(
747 $prefix . ts('translate CiviCRM'),
748 ts('Allow User to enable multilingual'),
750 'administer reserved groups' => array(
751 $prefix . ts('administer reserved groups'),
752 ts('Edit and disable Reserved Groups (Needs Edit Groups)'),
754 'administer Tagsets' => array(
755 $prefix . ts('administer Tagsets'),
757 'administer reserved tags' => array(
758 $prefix . ts('administer reserved tags'),
760 'administer dedupe rules' => array(
761 $prefix . ts('administer dedupe rules'),
762 ts('Create and edit rules, change the supervised and unsupervised rules'),
764 'merge duplicate contacts' => array(
765 $prefix . ts('merge duplicate contacts'),
766 ts('Delete Contacts must also be granted in order for this to work.'),
768 'force merge duplicate contacts' => array(
769 $prefix . ts('force merge duplicate contacts'),
770 ts('Delete Contacts must also be granted in order for this to work.'),
772 'view debug output' => array(
773 $prefix . ts('view debug output'),
774 ts('View results of debug and backtrace'),
777 'view all notes' => array(
778 $prefix . ts('view all notes'),
779 ts("View notes (for visible contacts) even if they're marked admin only"),
781 'access AJAX API' => array(
782 $prefix . ts('access AJAX API'),
783 ts('Allow API access even if Access CiviCRM is not granted'),
785 'access contact reference fields' => array(
786 $prefix . ts('access contact reference fields'),
787 ts('Allow entering data into contact reference fields'),
789 'create manual batch' => array(
790 $prefix . ts('create manual batch'),
791 ts('Create an accounting batch (with Access to CiviContribute and View Own/All Manual Batches)'),
793 'edit own manual batches' => array(
794 $prefix . ts('edit own manual batches'),
795 ts('Edit accounting batches created by user'),
797 'edit all manual batches' => array(
798 $prefix . ts('edit all manual batches'),
799 ts('Edit all accounting batches'),
801 'view own manual batches' => array(
802 $prefix . ts('view own manual batches'),
803 ts('View accounting batches created by user (with Access to CiviContribute)'),
805 'view all manual batches' => array(
806 $prefix . ts('view all manual batches'),
807 ts('View all accounting batches (with Access to CiviContribute)'),
809 'delete own manual batches' => array(
810 $prefix . ts('delete own manual batches'),
811 ts('Delete accounting batches created by user'),
813 'delete all manual batches' => array(
814 $prefix . ts('delete all manual batches'),
815 ts('Delete all accounting batches'),
817 'export own manual batches' => array(
818 $prefix . ts('export own manual batches'),
819 ts('Export accounting batches created by user'),
821 'export all manual batches' => array(
822 $prefix . ts('export all manual batches'),
823 ts('Export all accounting batches'),
825 'administer payment processors' => array(
826 $prefix . ts('administer payment processors'),
827 ts('Add, Update, or Disable Payment Processors'),
829 'edit message templates' => array(
830 $prefix . ts('edit message templates'),
832 'view my invoices' => array(
833 $prefix . ts('view my invoices'),
834 ts('Allow users to view/ download their own invoices'),
836 'edit api keys' => array(
837 $prefix . ts('edit api keys'),
840 'edit own api keys' => array(
841 $prefix . ts('edit own api keys'),
842 ts('Edit user\'s own API keys'),
850 * Validate user permission across.
851 * edit or view or with supportable acls.
855 public static function giveMeAllACLs() {
856 if (CRM_Core_Permission
::check('view all contacts') ||
857 CRM_Core_Permission
::check('edit all contacts')
862 $session = CRM_Core_Session
::singleton();
863 $contactID = $session->get('userID');
866 $aclPermission = self
::getPermission();
867 if (in_array($aclPermission, array(
868 CRM_Core_Permission
::EDIT
,
869 CRM_Core_Permission
::VIEW
,
875 // run acl where hook and see if the user is supplying an ACL clause
877 $tables = $whereTables = array();
880 CRM_Utils_Hook
::aclWhereClause(CRM_Core_Permission
::VIEW
,
881 $tables, $whereTables,
884 return empty($whereTables) ?
FALSE : TRUE;
888 * Get component name from given permission.
890 * @param string $permission
892 * @return null|string
893 * the name of component.
895 public static function getComponentName($permission) {
896 $componentName = NULL;
897 $permission = trim($permission);
898 if (empty($permission)) {
899 return $componentName;
902 static $allCompPermissions = array();
903 if (empty($allCompPermissions)) {
904 $components = CRM_Core_Component
::getComponents();
905 foreach ($components as $name => $comp) {
906 //get all permissions of each components unconditionally
907 $allCompPermissions[$name] = $comp->getPermissions(TRUE);
911 if (is_array($allCompPermissions)) {
912 foreach ($allCompPermissions as $name => $permissions) {
913 if (array_key_exists($permission, $permissions)) {
914 $componentName = $name;
920 return $componentName;
924 * Get all the contact emails for users that have a specific permission.
926 * @param string $permissionName
927 * Name of the permission we are interested in.
930 * a comma separated list of email addresses
932 public static function permissionEmails($permissionName) {
933 $config = CRM_Core_Config
::singleton();
934 return $config->userPermissionClass
->permissionEmails($permissionName);
938 * Get all the contact emails for users that have a specific role.
940 * @param string $roleName
941 * Name of the role we are interested in.
944 * a comma separated list of email addresses
946 public static function roleEmails($roleName) {
947 $config = CRM_Core_Config
::singleton();
948 return $config->userRoleClass
->roleEmails($roleName);
954 public static function isMultisiteEnabled() {
955 return Civi
::settings()->get('is_enabled') ?
TRUE : FALSE;
959 * Verify if the user has permission to get the invoice.
962 * TRUE if the user has download all invoices permission or download my
963 * invoices permission and the invoice author is the current user.
965 public static function checkDownloadInvoice() {
967 $cid = CRM_Core_BAO_UFMatch
::getContactId($user->uid
);
968 if (CRM_Core_Permission
::check('access CiviContribute') ||
969 (CRM_Core_Permission
::check('view my invoices') && $_GET['cid'] == $cid)