| GNU Affero General Public License or the licensing of CiviCRM, |
| see the CiviCRM license FAQ at http://civicrm.org/licensing |
+--------------------------------------------------------------------+
-*/
+ */
/**
*
* @package CRM
- * @copyright CiviCRM LLC (c) 2004-2014
+ * @copyright CiviCRM LLC (c) 2004-2015
* $Id$
*
*/
class CRM_Core_BAO_LabelFormat extends CRM_Core_DAO_OptionValue {
/**
- * Static holder for the Label Formats Option Group ID
+ * Static holder for the Label Formats Option Group ID.
*/
private static $_gid = NULL;
/**
* Get page orientations recognized by the DOMPDF package used to create PDF letters.
*
- * @param void
- *
- * @return array array of page orientations
- * @access public
- * @static
+ * @return array
+ * array of page orientations
*/
public static function getPageOrientations() {
return array(
/**
* Get font names supported by the TCPDF package used to create PDF labels.
*
- * @param string $name group name
+ * @param string $name
+ * Group name.
*
- * @return array array of font names
- * @access public
- * @static
+ * @return array
+ * array of font names
*/
- public static function getFontNames($name='label_format') {
+ public static function getFontNames($name = 'label_format') {
$label = new CRM_Utils_PDF_Label(self::getDefaultValues($name));
return $label->getFontNames();
}
/**
* Get font sizes supported by the TCPDF package used to create PDF labels.
*
- * @param void
- *
- * @return array array of font sizes
- * @access public
- * @static
+ * @return array
+ * array of font sizes
*/
public static function getFontSizes() {
$fontSizes = array();
/**
* Get measurement units recognized by the TCPDF package used to create PDF labels.
*
- * @param void
- *
- * @return array array of measurement units
- * @access public
- * @static
+ * @return array
+ * array of measurement units
*/
public static function getUnits() {
return array(
/**
* Get text alignment recognized by the TCPDF package used to create PDF labels.
*
- * @param void
- *
- * @return array array of alignments
- * @access public
- * @static
+ * @return array
+ * array of alignments
*/
public static function getTextAlignments() {
return array(
/**
* Get text alignment recognized by the TCPDF package used to create PDF labels.
*
- * @param void
- *
- * @return array array of alignments
- * @access public
- * @static
+ * @return array
+ * array of alignments
*/
public static function getFontStyles() {
return array(
}
/**
- * Get Option Group ID for Label Formats
+ * Get Option Group ID for Label Formats.
*
* @param string $name
*
- * @return int Group ID (null if Group ID doesn't exist)
- * @access private
+ * @return int
+ * Group ID (null if Group ID doesn't exist)
*/
- private static function _getGid($name='label_format') {
+ private static function _getGid($name = 'label_format') {
if (!isset(self::$_gid[$name]) || !self::$_gid[$name]) {
self::$_gid[$name] = CRM_Core_DAO::getFieldValue('CRM_Core_DAO_OptionGroup', $name, 'id', 'name');
if (!self::$_gid[$name]) {
}
/**
- * Add ordering fields to Label Format list
+ * Add ordering fields to Label Format list.
*
- * @param array (reference) $list List of Label Formats
- * @param string $returnURL URL of page calling this function
+ * @param array (reference) $list List of Label Formats
+ * @param string $returnURL
+ * URL of page calling this function.
*
- * @return array (reference) List of Label Formats
- * @static
- * @access public
+ * @return array
+ * (reference) List of Label Formats
*/
public static function addOrder(&$list, $returnURL) {
$filter = "option_group_id = " . self::_getGid();
CRM_Utils_Weight::addOrder($list, 'CRM_Core_DAO_OptionValue', 'id', $returnURL, $filter);
+ return $list;
}
/**
* Retrieve list of Label Formats.
*
- * @param bool $namesOnly return simple list of names
- * @param string $groupName group name of the label format option group
+ * @param bool $namesOnly
+ * Return simple list of names.
+ * @param string $groupName
+ * Group name of the label format option group.
*
- * @return array (reference) label format list
- * @static
- * @access public
+ * @return array
+ * (reference) label format list
*/
- public static function &getList($namesOnly = FALSE, $groupName='label_format') {
+ public static function &getList($namesOnly = FALSE, $groupName = 'label_format') {
static $list = array();
if (self::_getGid($groupName)) {
// get saved label formats from Option Value table
}
/**
- * Retrieve the default Label Format values
+ * Retrieve the default Label Format values.
*
- * @param string $groupName label format group name
+ * @param string $groupName
+ * Label format group name.
*
- * @return array Name/value pairs containing the default Label Format values.
- * @static
- * @access public
+ * @return array
+ * Name/value pairs containing the default Label Format values.
*/
public static function &getDefaultValues($groupName = 'label_format') {
$params = array('is_active' => 1, 'is_default' => 1);
}
/**
- * Get Label Format from the DB
+ * Get Label Format from the DB.
*
- * @param string $field Field name to search by
- * @param int $val Field value to search for
+ * @param string $field
+ * Field name to search by.
+ * @param int $val
+ * Field value to search for.
*
* @param string $groupName
*
- * @return array $values (reference) associative array of name/value pairs
- * @access public
+ * @return array
+ * (reference) associative array of name/value pairs
*/
public static function &getLabelFormat($field, $val, $groupName = 'label_format') {
$params = array('is_active' => 1, $field => $val);
}
/**
- * Get Label Format by Name
+ * Get Label Format by Name.
*
- * @param int $name Label format name. Empty = get default label format
+ * @param int $name
+ * Label format name. Empty = get default label format.
*
- * @return array $values (reference) associative array of name/value pairs
- * @access public
+ * @return array
+ * (reference) associative array of name/value pairs
*/
public static function &getByName($name) {
return self::getLabelFormat('name', $name);
}
/**
- * Get Label Format by ID
+ * Get Label Format by ID.
*
- * @param int $id label format id. 0 = get default label format
- * @param string $groupName group name
+ * @param int $id
+ * Label format id. 0 = get default label format.
+ * @param string $groupName
+ * Group name.
*
- * @return array $values (reference) associative array of name/value pairs
- * @access public
+ * @return array
+ * (reference) associative array of name/value pairs
*/
public static function &getById($id, $groupName = 'label_format') {
return self::getLabelFormat('id', $id, $groupName);
}
/**
- * Get Label Format field from associative array
+ * Get Label Format field from associative array.
*
- * @param string $field name of a label format field
+ * @param string $field
+ * Name of a label format field.
* @param array (reference) $values associative array of name/value pairs containing
* label format field selections
*
* @param null $default
*
* @return value
- * @access public
- * @static
*/
public static function getValue($field, &$values, $default = NULL) {
if (array_key_exists($field, self::$optionValueFields)) {
switch (self::$optionValueFields[$field]['type']) {
case CRM_Utils_Type::T_INT:
- return (int)CRM_Utils_Array::value($field, $values, $default);
+ return (int) CRM_Utils_Array::value($field, $values, $default);
case CRM_Utils_Type::T_FLOAT:
// Round float values to three decimal places and trim trailing zeros.
$f = sprintf('%05.3f', $values[$field]);
$f = rtrim($f, '0');
$f = rtrim($f, '.');
- return (float)(empty($f) ? '0' : $f);
+ return (float) (empty($f) ? '0' : $f);
}
return CRM_Utils_Array::value($field, $values, $default);
}
}
/**
- * Takes a bunch of params that are needed to match certain criteria and
- * retrieves the relevant objects. Typically the valid params are only
- * label id. It also stores all the retrieved values in the default array.
+ * Retrieve DB object based on input parameters.
+ *
+ * It also stores all the retrieved values in the default array.
*
- * @param array $params (reference ) an assoc array of name/value pairs
- * @param array $values (reference ) an assoc array to hold the flattened values
+ * @param array $params
+ * (reference ) an assoc array of name/value pairs.
+ * @param array $values
+ * (reference ) an assoc array to hold the flattened values.
*
* @param string $groupName
*
- * @return CRM_Core_DAO_OptionValue object
- * @access public
- * @static
+ * @return CRM_Core_DAO_OptionValue
*/
- public static function retrieve(&$params, &$values, $groupName='label_format') {
+ public static function retrieve(&$params, &$values, $groupName = 'label_format') {
$optionValue = new CRM_Core_DAO_OptionValue();
$optionValue->copyValues($params);
$optionValue->option_group_id = self::_getGid($groupName);
}
/**
- * Return the name of the group for customized labels
- *
- * @param void
+ * Return the name of the group for customized labels.
*
* @return void
- * @access public
*/
public static function customGroupName() {
return ts('Custom');
}
/**
- * Save the Label Format in the DB
+ * Save the Label Format in the DB.
*
- * @param array (reference) $values associative array of name/value pairs
- * @param int $id id of the database record (null = new record)
- * @param string $groupName group name of the label format
+ * @param array (reference) $values associative array of name/value pairs
+ * @param int $id
+ * Id of the database record (null = new record).
+ * @param string $groupName
+ * Group name of the label format.
*
* @return void
- * @access public
*/
public function saveLabelFormat(&$values, $id = NULL, $groupName = 'label_format') {
// get the Option Group ID for Label Formats (create one if it doesn't exist)
}
else {
// new record
- $list = self::getList(TRUE,$groupName);
+ $list = self::getList(TRUE, $groupName);
$cnt = 1;
- while (array_key_exists("custom_$cnt", $list)) $cnt++;
+ while (array_key_exists("custom_$cnt", $list)) {
+ $cnt++;
+ }
$values['name'] = "custom_$cnt";
$values['grouping'] = self::customGroupName();
}
}
/**
- * Delete a Label Format
+ * Delete a Label Format.
*
- * @param int $id ID of the label format to be deleted.
- * @param string $groupName group name
- * @access public
- * @static
+ * @param int $id
+ * ID of the label format to be deleted.
+ * @param string $groupName
+ * Group name.
*/
public static function del($id, $groupName) {
if ($id) {
}
CRM_Core_Error::fatal(ts('Invalid value passed to delete function.'));
}
-}
+}