<?php
/*
+--------------------------------------------------------------------+
- | CiviCRM version 4.6 |
+ | CiviCRM version 4.7 |
+--------------------------------------------------------------------+
| Copyright (C) 2011 Marty Wright |
| Licensed to CiviCRM under the Academic Free License version 3.0. |
| 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_PaperSize extends CRM_Core_DAO_OptionValue {
/**
- * Static holder for the Paper Size Option Group ID
+ * Static holder for the Paper Size Option Group ID.
*/
private static $_gid = NULL;
);
/**
- * Get Option Group ID for Paper Sizes
- *
- * @param void
+ * Get Option Group ID for Paper Sizes.
*
* @return int
* Group ID (null if Group ID doesn't exist)
}
/**
- * Add ordering fields to Paper Size list
+ * Add ordering fields to Paper Size list.
*
* @param array (reference) $list List of Paper Sizes
* @param string $returnURL
* URL of page calling this function.
*
- * @return array
- * (reference) List of Paper Sizes
- * @static
*/
public static function &addOrder(&$list, $returnURL) {
$filter = "option_group_id = " . self::_getGid();
*
* @return array
* (reference) Paper Size list
- * @static
*/
public static function &getList($namesOnly = FALSE) {
static $list = array();
}
/**
- * Retrieve the default Paper Size values
- *
- * @param NULL
+ * Retrieve the default Paper Size values.
*
* @return array
* Name/value pairs containing the default Paper Size values.
- * @static
*/
public static function &getDefaultValues() {
$params = array('is_active' => 1, 'is_default' => 1);
}
/**
- * Get Paper Size from the DB
+ * Get Paper Size from the DB.
*
* @param string $field
* Field name to search by.
}
/**
- * Get Paper Size by Name
+ * Get Paper Size by Name.
*
* @param int $name
* Paper Size name. Empty = get default Paper Size.
}
/**
- * Get Paper Size by ID
+ * Get Paper Size by ID.
*
* @param int $id
* Paper Size id. 0 = get default Paper Size.
}
/**
- * Get Paper Size field from associative array
+ * Get Paper Size field from associative array.
*
* @param string $field
* Name of a Paper Size field.
* @param null $default
*
* @return value
- * @static
*/
public static function getValue($field, &$values, $default = NULL) {
if (array_key_exists($field, self::$optionValueFields)) {
}
/**
- * Takes a bunch of params that are needed to match certain criteria and
- * retrieves the relevant objects. Typically the valid params are only
- * paper size 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.
*
- * @return CRM_Core_DAO_OptionValue object
- * @static
+ * @return CRM_Core_DAO_OptionValue
*/
public static function retrieve(&$params, &$values) {
$optionValue = new CRM_Core_DAO_OptionValue();
}
/**
- * Save the Paper Size in the DB
+ * Save the Paper Size in the DB.
*
* @param array (reference) $values associative array of name/value pairs
* @param int $id
}
/**
- * Delete a Paper Size
+ * Delete a Paper Size.
*
* @param int $id
* ID of the Paper Size to be deleted.
*
- * @static
*/
public static function del($id) {
if ($id) {
}
CRM_Core_Error::fatal(ts('Invalid value passed to delete function.'));
}
+
}