<?php
/*
+--------------------------------------------------------------------+
- | CiviCRM version 4.4 |
+ | CiviCRM version 4.6 |
+--------------------------------------------------------------------+
- | Copyright CiviCRM LLC (c) 2004-2013 |
+ | Copyright CiviCRM LLC (c) 2004-2014 |
+--------------------------------------------------------------------+
| This file is a part of CiviCRM. |
| |
* and similar across all objects (thus providing both reuse and standards)
*
* @package CRM
- * @copyright CiviCRM LLC (c) 2004-2013
+ * @copyright CiviCRM LLC (c) 2004-2014
* $Id$
*
*/
* Different possible actions are defined here. Keep in sync with the
* constant from CRM_Core_Form for various modes.
*
- * @var const
+ * @var integer const
*
- * @access public
*/
- CONST
+ const
NONE = 0,
ADD = 1,
UPDATE = 2,
RENEW = 32768,
DETACH = 65536,
REVERT = 131072,
- CLOSE = 262144,
- REOPEN = 524288,
+ CLOSE = 262144,
+ REOPEN = 524288,
MAX_ACTION = 1048575;
//make sure MAX_ACTION = 2^n - 1 ( n = total number of actions )
/**
- * map the action names to the relevant constant. We perform
+ * Map the action names to the relevant constant. We perform
* bit manipulation operations so we can perform multiple
* actions on the same object if needed
*
- * @var array _names tupe of variable name to action constant
+ * @var array $_names type of variable name to action constant
*
- * @access private
* @static
*
*/
);
/**
- * the flipped version of the names array, initialized when used
+ * The flipped version of the names array, initialized when used
*
* @var array
* @static
static $_description;
/**
+ * Called by the request object to translate a string into a mask
*
- * called by the request object to translate a string into a mask
- *
- * @param string $action the action to be resolved
+ * @param string $str
+ * The action to be resolved.
*
* @return int the action mask corresponding to the input string
- * @access public
* @static
- *
*/
- static function resolve($str) {
+ public static function resolve($str) {
$action = 0;
if ($str) {
$items = explode('|', $str);
* Given a string or an array of strings, determine the bitmask
* for this set of actions
*
- * @param mixed either a single string or an array of strings
+ * @param mixed $item
+ * Either a single string or an array of strings.
*
* @return int the action mask corresponding to the input args
- * @access public
* @static
*
*/
- static function map($item) {
+ public static function map($item) {
$mask = 0;
if (is_array($item)) {
/**
* Given a string determine the bitmask for this specific string
*
- * @param string the input action to process
+ * @param string $item
+ * The input action to process.
*
* @return int the action mask corresponding to the input string
- * @access public
* @static
*
*/
- static function mapItem($item) {
+ public static function mapItem($item) {
$mask = CRM_Utils_Array::value(trim($item), self::$_names);
return $mask ? $mask : 0;
}
*
* Given an action mask, find the corresponding description
*
- * @param int the action mask
+ * @param int $mask
+ * The action mask.
*
* @return string the corresponding action description
- * @access public
* @static
*
*/
- static function description($mask) {
+ public static function description($mask) {
if (!isset($_description)) {
self::$_description = array_flip(self::$_names);
}
}
/**
- * given a set of links and a mask, return the html action string for
+ * Given a set of links and a mask, return the html action string for
* the links associated with the mask
*
- * @param array $links the set of link items
- * @param int $mask the mask to be used. a null mask means all items
- * @param array $values the array of values for parameter substitution in the link items
- * @param string $extraULName enclosed extra links in this UL.
- * @param boolean $enclosedAllInSingleUL force to enclosed all links in single UL.
+ * @param array $links
+ * The set of link items.
+ * @param int $mask
+ * The mask to be used. a null mask means all items.
+ * @param array $values
+ * The array of values for parameter substitution in the link items.
+ * @param string $extraULName
+ * Enclosed extra links in this UL.
+ * @param bool $enclosedAllInSingleUL
+ * Force to enclosed all links in single UL.
+ *
+ * @param null $op
+ * @param null $objectName
+ * @param int $objectId
*
* @return string the html string
- * @access public
* @static
*/
- static function formLink($links,
+ static function formLink(
+ $links,
$mask,
$values,
$extraULName = 'more',
}
}
-
$mainLinks = $url;
if ($enclosedAllInSingleUL) {
$allLinks = '';
}
/**
- * given a string and an array of values, substitute the real values
+ * Given a string and an array of values, substitute the real values
* in the placeholder in the str in the CiviCRM format
*
- * @param string $str the string to be replaced
- * @param array $values the array of values for parameter substitution in the str
+ * @param string $str
+ * The string to be replaced.
+ * @param array $values
+ * The array of values for parameter substitution in the str.
*
* @return string the substituted string
- * @access public
* @static
*/
- static function &replace(&$str, &$values) {
+ public static function &replace(&$str, &$values) {
foreach ($values as $n => $v) {
$str = str_replace("%%$n%%", $v, $str);
}
}
/**
- * get the mask for a permission (view, edit or null)
+ * Get the mask for a permission (view, edit or null)
*
* @param string the permission
*
* @return int the mask for the above permission
* @static
- * @access public
*/
- static function mask($permissions) {
+ public static function mask($permissions) {
$mask = NULL;
if (!is_array($permissions) || CRM_Utils_System::isNull($permissions)) {
return $mask;
return $mask;
}
}
-