+--------------------------------------------------------------------+
| CiviCRM version 4.7 |
+--------------------------------------------------------------------+
- | Copyright CiviCRM LLC (c) 2004-2016 |
+ | Copyright CiviCRM LLC (c) 2004-2017 |
+--------------------------------------------------------------------+
| This file is a part of CiviCRM. |
| |
/**
*
* @package CiviCRM_Hook
- * @copyright CiviCRM LLC (c) 2004-2016
+ * @copyright CiviCRM LLC (c) 2004-2017
*/
abstract class CRM_Utils_Hook {
return self::$_singleton;
}
+ /**
+ * CRM_Utils_Hook constructor.
+ */
public function __construct() {
$this->cache = CRM_Utils_Cache::create(array(
'name' => 'hooks',
);
}
+ /**
+ * This hook is called when checking permissions; use this hook to dynamically
+ * escalate user permissions in certain use cases (cf. CRM-19256).
+ *
+ * @param string $permission
+ * The name of an atomic permission, ie. 'access deleted contacts'
+ * @param bool $granted
+ * Whether this permission is currently granted. The hook can change this value.
+ *
+ * @return null
+ * The return value is ignored
+ */
+ public static function permission_check($permission, &$granted) {
+ return self::singleton()->invoke(2, $permission, $granted,
+ self::$_nullObject, self::$_nullObject, self::$_nullObject, self::$_nullObject,
+ 'civicrm_permission_check'
+ );
+ }
+
/**
* @param CRM_Core_Exception Exception $exception
* @param mixed $request
}
/**
- * This hook is called for bypass a few civicrm urls from IDS check
- * @param array $skip list of civicrm url;
+ * This hook is called for bypass a few civicrm urls from IDS check.
+ *
+ * @param array $skip list of civicrm urls
+ *
+ * @return mixed
*/
public static function idsException(&$skip) {
return self::singleton()->invoke(1, $skip, self::$_nullObject,
* @param string $geoProvider
* @param array $values
* @param SimpleXMLElement $xml
+ *
+ * @return mixed
*/
public static function geocoderFormat($geoProvider, &$values, $xml) {
return self::singleton()->invoke(3, $geoProvider, $values, $xml,