| GNU Affero General Public License or the licensing of CiviCRM, |
| see the CiviCRM license FAQ at http://civicrm.org/licensing |
+--------------------------------------------------------------------+
-*/
+ */
/**
*
class CRM_Core_BAO_Block {
/**
- * Fields that are required for a valid block
+ * Fields that are required for a valid block.
*/
static $requiredBlockFields = array(
'email' => array('email'),
'phone' => array('phone'),
'im' => array('name'),
- 'openid' => array('openid')
+ 'openid' => array('openid'),
);
/**
* @param array $params
* Input parameters to find object.
*
- * @return array of $block objects.
- * @static
+ * @return array
+ * Array of $block objects.
*/
public static function &getValues($blockName, $params) {
if (empty($params)) {
return NULL;
}
$BAOString = 'CRM_Core_BAO_' . $blockName;
- $block = new $BAOString( );
+ $block = new $BAOString();
$blocks = array();
if (!isset($params['entity_table'])) {
$count = 1;
foreach ($blockIds as $blockId) {
- $block = new $BAOString( );
- $block->id = $blockId['id'];
- $getBlocks = self::retrieveBlock($block, $blockName);
+ $block = new $BAOString();
+ $block->id = $blockId['id'];
+ $getBlocks = self::retrieveBlock($block, $blockName);
$blocks[$count++] = array_pop($getBlocks);
}
}
* @param string $blockName
* Name of the above object.
*
- * @return array of $block objects.
- * @static
+ * @return array
+ * Array of $block objects.
*/
public static function retrieveBlock(&$block, $blockName) {
// we first get the primary location due to the order by clause
}
/**
- * Check if the current block object has any valid data
+ * Check if the current block object has any valid data.
*
* @param array $blockFields
* Array of fields that are of interest for this object.
* @param array $params
* Associated array of submitted fields.
*
- * @return boolean true if the block has data, otherwise false
- * @static
+ * @return bool
+ * true if the block has data, otherwise false
*/
public static function dataExists($blockFields, &$params) {
foreach ($blockFields as $field) {
}
/**
- * Check if the current block exits
+ * Check if the current block exits.
*
* @param string $blockName
* Bloack name.
* @param array $params
* Associated array of submitted fields.
*
- * @return boolean true if the block exits, otherwise false
- * @static
+ * @return bool
+ * true if the block exits, otherwise false
*/
public static function blockExists($blockName, &$params) {
// return if no data present
}
/**
- * Get all block ids for a contact
+ * Get all block ids for a contact.
*
* @param string $blockName
* Block name.
* @param null $entityElements
* @param bool $updateBlankLocInfo
*
- * @return array $contactBlockIds formatted array of block ids
+ * @return array
+ * formatted array of block ids
*
- * @static
*/
public static function getBlockIds($blockName, $contactId = NULL, $entityElements = NULL, $updateBlankLocInfo = FALSE) {
$allBlocks = array();
// e.g $bao = new $baoString;
// $bao->getAllBlocks()
$baoFunction = 'all' . $name . 's';
- $allBlocks = $baoString::$baoFunction( $contactId, $updateBlankLocInfo );
+ $allBlocks = $baoString::$baoFunction($contactId, $updateBlankLocInfo);
}
elseif (!empty($entityElements) && $blockName != 'openid') {
$baoFunction = 'allEntity' . $name . 's';
- $allBlocks = $baoString::$baoFunction( $entityElements );
+ $allBlocks = $baoString::$baoFunction($entityElements);
}
return $allBlocks;
}
/**
- * Takes an associative array and creates a block
+ * Takes an associative array and creates a block.
*
* @param string $blockName
* Block name.
* @param null $entity
* @param int $contactId
*
- * @return object CRM_Core_BAO_Block object on success, null otherwise
- * @static
+ * @return object
+ * CRM_Core_BAO_Block object on success, null otherwise
*/
public static function create($blockName, &$params, $entity = NULL, $contactId = NULL) {
if (!self::blockExists($blockName, $params)) {
return NULL;
}
- $name = ucfirst($blockName);
- $contactId = NULL;
- $isPrimary = $isBilling = TRUE;
+ $name = ucfirst($blockName);
+ $contactId = NULL;
+ $isPrimary = $isBilling = TRUE;
$entityElements = $blocks = array();
if ($entity) {
}
if ($resetPrimaryId) {
$baoString = 'CRM_Core_BAO_' . $blockName;
- $block = new $baoString( );
+ $block = new $baoString();
$block->selectAdd();
$block->selectAdd("id, is_primary");
$block->id = $resetPrimaryId;
$blockFields = array_merge($value, $contactFields);
$baoString = 'CRM_Core_BAO_' . $name;
- $blocks[] = $baoString::add( $blockFields );
+ $blocks[] = $baoString::add($blockFields);
}
// we need to delete blocks that were deleted during update
}
/**
- * Delete block
+ * Delete block.
*
* @param string $blockName
* Block name.
* Associates array.
*
* @return void
- * @static
*/
public static function blockDelete($blockName, $params) {
$name = ucfirst($blockName);
}
$baoString = 'CRM_Core_DAO_' . $name;
- $block = new $baoString( );
+ $block = new $baoString();
$block->copyValues($params);
- /*
- * CRM-11006 add call to pre and post hook for delete action
- */
+
+ // CRM-11006 add call to pre and post hook for delete action
CRM_Utils_Hook::pre('delete', $name, $block->id, CRM_Core_DAO::$_nullArray);
$block->delete();
CRM_Utils_Hook::post('delete', $name, $block->id, $block);
* @param $class
*
* @throws API_Exception
- * @static
*/
public static function handlePrimary(&$params, $class) {
$table = CRM_Core_DAO_AllCoreTables::getTableForClass($class);
$sql = "UPDATE $table SET is_primary = 0 WHERE contact_id = %1";
$sqlParams = array(1 => array($contactId, 'Integer'));
// we don't want to create unecessary entries in the log_ tables so exclude the one we are working on
- if(!empty($params['id'])){
+ if (!empty($params['id'])) {
$sql .= " AND id <> %2";
$sqlParams[2] = array($params['id'], 'Integer');
}
* is_primary to 1
* CRM-10451
*/
- if ( $existingEntities->N == 1 && $existingEntities->id == CRM_Utils_Array::value( 'id', $params ) ) {
+ if ($existingEntities->N == 1 && $existingEntities->id == CRM_Utils_Array::value('id', $params)) {
$params['is_primary'] = 1;
return;
}
}
/**
- * Sort location array so primary element is first
+ * Sort location array so primary element is first.
*
* @param array $locations
- *
*/
- public static function sortPrimaryFirst(&$locations){
+ public static function sortPrimaryFirst(&$locations) {
uasort($locations, 'self::primaryComparison');
}
-/**
- * compare 2 locations to see which should go first based on is_primary
- * (sort function for sortPrimaryFirst)
- * @param array $location1
- * @param array $location2
- * @return number
- */
- public static function primaryComparison($location1, $location2){
+ /**
+ * compare 2 locations to see which should go first based on is_primary
+ * (sort function for sortPrimaryFirst)
+ * @param array $location1
+ * @param array $location2
+ * @return int
+ */
+ public static function primaryComparison($location1, $location2) {
$l1 = CRM_Utils_Array::value('is_primary', $location1);
$l2 = CRM_Utils_Array::value('is_primary', $location2);
if ($l1 == $l2) {
}
return ($l1 < $l2) ? -1 : 1;
}
+
}