X-Git-Url: https://vcs.fsf.org/?a=blobdiff_plain;f=CRM%2FCore%2FBAO%2FEntityTag.php;h=f4a8c16928213bbfeb3523dd87c88d2b16c06202;hb=1e66775e6f88ac33d643ca2d68577ab01dd41dd5;hp=3202e467d381d4998c54b4ecf6eb87ab64fbf3e3;hpb=681aa547248b9c7d92d368f4879f75f941eba90b;p=civicrm-core.git diff --git a/CRM/Core/BAO/EntityTag.php b/CRM/Core/BAO/EntityTag.php index 3202e467d3..f4a8c16928 100644 --- a/CRM/Core/BAO/EntityTag.php +++ b/CRM/Core/BAO/EntityTag.php @@ -23,7 +23,7 @@ | GNU Affero General Public License or the licensing of CiviCRM, | | see the CiviCRM license FAQ at http://civicrm.org/licensing | +--------------------------------------------------------------------+ -*/ + */ /** * This class contains functions for managing Tag(tag) for a contact @@ -40,13 +40,14 @@ class CRM_Core_BAO_EntityTag extends CRM_Core_DAO_EntityTag { * Given a contact id, it returns an array of tag id's the * contact belongs to. * - * @param int $entityID id of the entity usually the contactID. - * @param string $entityTable name of the entity table usually 'civicrm_contact' + * @param int $entityID + * Id of the entity usually the contactID. + * @param string $entityTable + * Name of the entity table usually 'civicrm_contact'. * - * @return array( - ) reference $tag array of category id's the contact belongs to. + * @return array + * reference $tag array of category id's the contact belongs to. * - * @static */ public static function &getTag($entityID, $entityTable = 'civicrm_contact') { $tags = array(); @@ -69,10 +70,10 @@ class CRM_Core_BAO_EntityTag extends CRM_Core_DAO_EntityTag { * group object. the params array could contain additional unused name/value * pairs * - * @param array $params (reference ) an assoc array of name/value pairs + * @param array $params + * (reference ) an assoc array of name/value pairs. * - * @return CRM_Core_BAO_EntityTag object - * @static + * @return CRM_Core_BAO_EntityTag */ public static function add(&$params) { $dataExists = self::dataExists($params); @@ -99,10 +100,10 @@ class CRM_Core_BAO_EntityTag extends CRM_Core_DAO_EntityTag { /** * Check if there is data to create the object * - * @param array $params an assoc array of name/value pairs + * @param array $params + * An assoc array of name/value pairs. * - * @return boolean - * @static + * @return bool */ public static function dataExists($params) { return !($params['tag_id'] == 0); @@ -111,11 +112,8 @@ class CRM_Core_BAO_EntityTag extends CRM_Core_DAO_EntityTag { /** * Delete the tag for a contact * - * @param array $params (reference ) an assoc array of name/value pairs - * - * @return CRM_Core_BAO_EntityTag object - * @static - * + * @param array $params + * (reference ) an assoc array of name/value pairs. */ public static function del(&$params) { $entityTag = new CRM_Core_BAO_EntityTag(); @@ -130,23 +128,26 @@ class CRM_Core_BAO_EntityTag extends CRM_Core_DAO_EntityTag { /** * Given an array of entity ids and entity table, add all the entity to the tags * - * @param array $entityIds (reference ) the array of entity ids to be added - * @param int $tagId the id of the tag - * @param string $entityTable name of entity table default:civicrm_contact + * @param array $entityIds + * (reference ) the array of entity ids to be added. + * @param int $tagId + * The id of the tag. + * @param string $entityTable + * Name of entity table default:civicrm_contact. * - * @return array (total, added, notAdded) count of enities added to tag - * @static + * @return array + * (total, added, notAdded) count of enities added to tag */ public static function addEntitiesToTag(&$entityIds, $tagId, $entityTable = 'civicrm_contact') { - $numEntitiesAdded = 0; + $numEntitiesAdded = 0; $numEntitiesNotAdded = 0; - $entityIdsAdded = array(); + $entityIdsAdded = array(); foreach ($entityIds as $entityId) { $tag = new CRM_Core_DAO_EntityTag(); - $tag->entity_id = $entityId; - $tag->tag_id = $tagId; + $tag->entity_id = $entityId; + $tag->tag_id = $tagId; $tag->entity_table = $entityTable; if (!$tag->find()) { $tag->save(); @@ -172,12 +173,15 @@ class CRM_Core_BAO_EntityTag extends CRM_Core_DAO_EntityTag { /** * Given an array of entity ids and entity table, remove entity(s) tags * - * @param array $entityIds (reference ) the array of entity ids to be removed - * @param int $tagId the id of the tag - * @param string $entityTable name of entity table default:civicrm_contact + * @param array $entityIds + * (reference ) the array of entity ids to be removed. + * @param int $tagId + * The id of the tag. + * @param string $entityTable + * Name of entity table default:civicrm_contact. * - * @return array (total, removed, notRemoved) count of entities removed from tags - * @static + * @return array + * (total, removed, notRemoved) count of entities removed from tags */ public static function removeEntitiesFromTag(&$entityIds, $tagId, $entityTable = 'civicrm_contact') { $numEntitiesRemoved = 0; @@ -187,8 +191,8 @@ class CRM_Core_BAO_EntityTag extends CRM_Core_DAO_EntityTag { foreach ($entityIds as $entityId) { $tag = new CRM_Core_DAO_EntityTag(); - $tag->entity_id = $entityId; - $tag->tag_id = $tagId; + $tag->entity_id = $entityId; + $tag->tag_id = $tagId; $tag->entity_table = $entityTable; if ($tag->find()) { $tag->delete(); @@ -214,12 +218,12 @@ class CRM_Core_BAO_EntityTag extends CRM_Core_DAO_EntityTag { /** * Takes an associative array and creates tag entity record for all tag entities * - * @param array $params (reference) an assoc array of name/value pairs + * @param array $params + * (reference) an assoc array of name/value pairs. * @param $entityTable * @param int $entityID * * @return void - * @static */ public static function create(&$params, $entityTable, $entityID) { // get categories for the entity id @@ -258,9 +262,11 @@ class CRM_Core_BAO_EntityTag extends CRM_Core_DAO_EntityTag { /** * This function returns all entities assigned to a specific tag * - * @param object $tag an object of a tag. + * @param object $tag + * An object of a tag. * - * @return array $entityIds array of entity ids + * @return array + * array of entity ids */ public function getEntitiesByTag($tag) { $entityIds = array(); @@ -332,14 +338,15 @@ class CRM_Core_BAO_EntityTag extends CRM_Core_DAO_EntityTag { * Merge two tags: tag B into tag A. */ public function mergeTags($tagAId, $tagBId) { - $queryParams = array(1 => array($tagBId, 'Integer'), + $queryParams = array( + 1 => array($tagBId, 'Integer'), 2 => array($tagAId, 'Integer'), ); // re-compute used_for field $query = "SELECT id, name, used_for FROM civicrm_tag WHERE id IN (%1, %2)"; - $dao = CRM_Core_DAO::executeQuery($query, $queryParams); - $tags = array(); + $dao = CRM_Core_DAO::executeQuery($query, $queryParams); + $tags = array(); while ($dao->fetch()) { $label = ($dao->id == $tagAId) ? 'tagA' : 'tagB'; $tags[$label] = $dao->name; @@ -378,5 +385,33 @@ class CRM_Core_BAO_EntityTag extends CRM_Core_DAO_EntityTag { $tags['status'] = TRUE; return $tags; } -} + /** + * Get options for a given field. + * + * @see CRM_Core_DAO::buildOptions + * @see CRM_Core_DAO::buildOptionsContext + * + * @param string $fieldName + * @param string $context + * As per CRM_Core_DAO::buildOptionsContext. + * @param array $props + * whatever is known about this dao object. + * + * @return array|bool + */ + public static function buildOptions($fieldName, $context = NULL, $props = array()) { + $params = array(); + + $options = CRM_Core_PseudoConstant::get(__CLASS__, $fieldName, $params, $context); + + // Output tag list as nested hierarchy + // TODO: This will only work when api.entity is "entity_tag". What about others? + if (($fieldName == 'tag' || $fieldName == 'tag_id') && ($context == 'search' || $context == 'create')) { + $options = CRM_Core_BAO_Tag::getTags('civicrm_contact', CRM_Core_DAO::$_nullArray, CRM_Utils_Array::value('parent_id', $params), '- '); + } + + return $options; + } + +}