/**
* takes an associative array and creates a contact object
*
* The function extract all the params it needs to initialize the create a
* contact object. the params array could contain additional unused name/value
* pairs
*
* @param array $params (reference) an assoc array of name/value pairs
* @param array $ids (reference) the array that holds all the db ids
*
* @return object CRM_Core_DAO_Tag object on success, otherwise null
* @access public
* @static
*/
function add(&$params, &$ids)
{
if (!CRM_Core_BAO_Tag::dataExists($params)) {
return null;
}
$tag =& new CRM_Core_DAO_Tag();
$tag->domain_id = CRM_Core_Config::domainID();
$tag->copyValues($params);
$tag->id = CRM_Utils_Array::value('tag', $ids);
$tag->save();
CRM_Core_Session::setStatus(ts('The tag "%1" has been saved.', array(1 => $tag->name)));
return $tag;
}
