* @author Ralf Becker * @package addressbook * @copyright (c) 2005/6 by Cornelius Weiss and Ralf Becker * @license http://opensource.org/licenses/gpl-license.php GPL - GNU General Public License * @version $Id$ */ require_once(EGW_INCLUDE_ROOT.'/addressbook/inc/class.socontacts.inc.php'); /** * General business object of the adressbook * * @package addressbook * @author Cornelius Weiss * @author Ralf Becker * @copyright (c) 2005/6 by Cornelius Weiss and Ralf Becker * @license http://opensource.org/licenses/gpl-license.php GPL - GNU General Public License */ class bocontacts extends socontacts { /** * @var int $tz_offset_s offset in secconds between user and server-time, * it need to be add to a server-time to get the user-time or substracted from a user-time to get the server-time */ var $tz_offset_s; /** * @var int $now_su actual user (!) time */ var $now_su; /** * @var array $timestamps timestamps */ var $timestamps = array('modified','created'); /** * @var array $fileas_types */ var $fileas_types = array( 'org_name: n_family, n_given', 'org_name: n_family, n_prefix', 'org_name: n_given n_family', 'org_name: n_fn', 'n_family, n_given: org_name', 'n_family, n_prefix: org_name', 'n_given n_family: org_name', 'n_prefix n_family: org_name', 'n_fn: org_name', 'org_name', 'n_given n_family', 'n_prefix n_family', 'n_family, n_given', 'n_family, n_prefix', 'n_fn', ); /** * @var array $org_fields fields belonging to the (virtual) organisation entry */ var $org_fields = array( 'org_name', 'org_unit', 'adr_one_street', 'adr_one_street2', 'adr_one_locality', 'adr_one_region', 'adr_one_postalcode', 'adr_one_countryname', 'label', 'tel_work', 'tel_fax', 'tel_assistent', 'assistent', 'email', 'url', 'tz', ); /** * Which fields is a (non-admin) user allowed to edit in his own account * * @var array */ var $own_account_acl; /** * @var double $org_common_factor minimum percentage of the contacts with identical values to construct the "common" (virtual) org-entry */ var $org_common_factor = 0.6; var $contact_fields = array(); var $business_contact_fields = array(); var $home_contact_fields = array(); /** * Number and message of last error or false if no error, atm. only used for saving * * @var string/boolean */ var $error; /** * Addressbook preferences of the user * * @var array */ var $prefs; function bocontacts($contact_app='addressbook') { $this->socontacts($contact_app); $this->tz_offset_s = 3600 * $GLOBALS['egw_info']['user']['preferences']['common']['tz_offset']; $this->now_su = time() + $this->tz_offset_s; $this->prefs =& $GLOBALS['egw_info']['user']['preferences']['addressbook']; $this->contact_fields = array( 'id' => lang('Contact ID'), 'tid' => lang('Type'), 'owner' => lang('Addressbook'), 'private' => lang('private'), 'cat_id' => lang('Category'), 'n_prefix' => lang('prefix'), 'n_given' => lang('first name'), 'n_middle' => lang('middle name'), 'n_family' => lang('last name'), 'n_suffix' => lang('suffix'), 'n_fn' => lang('full name'), 'n_fileas' => lang('own sorting'), 'bday' => lang('birthday'), 'org_name' => lang('Company'), 'org_unit' => lang('Department'), 'title' => lang('Title'), 'role' => lang('Role'), 'assistent' => lang('Assistent'), 'room' => lang('Room'), 'adr_one_street' => lang('street').' ('.lang('business').')', 'adr_one_street2' => lang('address line 2').' ('.lang('business').')', 'adr_one_locality' => lang('city').' ('.lang('business').')', 'adr_one_region' => lang('state').' ('.lang('business').')', 'adr_one_postalcode' => lang('zip code').' ('.lang('business').')', 'adr_one_countryname' => lang('country').' ('.lang('business').')', 'label' => lang('label'), 'adr_two_street' => lang('street').' ('.lang('private').')', 'adr_two_street2' => lang('address line 2').' ('.lang('private').')', 'adr_two_locality' => lang('city').' ('.lang('private').')', 'adr_two_region' => lang('state').' ('.lang('private').')', 'adr_two_postalcode' => lang('zip code').' ('.lang('private').')', 'adr_two_countryname' => lang('country').' ('.lang('private').')', 'tel_work' => lang('work phone'), 'tel_cell' => lang('mobile phone'), 'tel_fax' => lang('fax').' ('.lang('business').')', 'tel_assistent' => lang('assistent phone'), 'tel_car' => lang('car phone'), 'tel_pager' => lang('pager'), 'tel_home' => lang('home phone'), 'tel_fax_home' => lang('fax').' ('.lang('private').')', 'tel_cell_private' => lang('mobile phone').' ('.lang('private').')', 'tel_other' => lang('other phone'), 'tel_prefer' => lang('preferred phone'), 'email' => lang('email').' ('.lang('business').')', 'email_home' => lang('email').' ('.lang('private').')', 'url' => lang('url').' ('.lang('business').')', 'url_home' => lang('url').' ('.lang('private').')', 'freebusy_uri' => lang('Freebusy URI'), 'calendar_uri' => lang('Calendar URI'), 'note' => lang('note'), 'tz' => lang('time zone'), 'geo' => lang('geo'), 'pubkey' => lang('public key'), 'created' => lang('created'), 'creator' => lang('created by'), 'modified' => lang('last modified'), 'modifier' => lang('last modified by'), 'jpegphoto' => lang('photo'), ); $this->business_contact_fields = array( 'org_name' => lang('Company'), 'org_unit' => lang('Department'), 'title' => lang('Title'), 'role' => lang('Role'), 'n_prefix' => lang('prefix'), 'n_given' => lang('first name'), 'n_middle' => lang('middle name'), 'n_family' => lang('last name'), 'n_suffix' => lang('suffix'), 'adr_one_street' => lang('street').' ('.lang('business').')', 'adr_one_street2' => lang('address line 2').' ('.lang('business').')', 'adr_one_locality' => lang('city').' ('.lang('business').')', 'adr_one_region' => lang('state').' ('.lang('business').')', 'adr_one_postalcode' => lang('zip code').' ('.lang('business').')', 'adr_one_countryname' => lang('country').' ('.lang('business').')', ); $this->home_contact_fields = array( 'org_name' => lang('Company'), 'org_unit' => lang('Department'), 'title' => lang('Title'), 'role' => lang('Role'), 'n_prefix' => lang('prefix'), 'n_given' => lang('first name'), 'n_middle' => lang('middle name'), 'n_family' => lang('last name'), 'n_suffix' => lang('suffix'), 'adr_two_street' => lang('street').' ('.lang('business').')', 'adr_two_street2' => lang('address line 2').' ('.lang('business').')', 'adr_two_locality' => lang('city').' ('.lang('business').')', 'adr_two_region' => lang('state').' ('.lang('business').')', 'adr_two_postalcode' => lang('zip code').' ('.lang('business').')', 'adr_two_countryname' => lang('country').' ('.lang('business').')', ); //_debug_array($this->contact_fields); $this->own_account_acl = unserialize($GLOBALS['egw_info']['server']['own_account_acl']); // we have only one acl (n_fn) for the whole name, as not all backends store every part in an own field if ($this->own_account_acl && in_array('n_fn',$this->own_account_acl)) { $this->own_account_acl = array_merge($this->own_account_acl,array('n_prefix','n_given','n_middle','n_family','n_suffix')); } } /** * calculate the file_as string from the contact and the file_as type * * @param array $contact * @param string $type=null file_as type, default null to read it from the contact, unknown/not set type default to the first one * @return string */ function fileas($contact,$type=null) { if (is_null($type)) $type = $contact['fileas_type']; if (!$type) $type = $this->fileas_types[0]; if (strpos($type,'n_fn') !== false) $contact['n_fn'] = $this->fullname($contact); $fileas = str_replace(array('n_prefix','n_given','n_middle','n_family','n_suffix','n_fn','org_name','org_unit','adr_one_locality'), array($contact['n_prefix'],$contact['n_given'],$contact['n_middle'],$contact['n_family'],$contact['n_suffix'], $contact['n_fn'],$contact['org_name'],$contact['org_unit'],$contact['adr_one_locality']),$type); // removing empty delimiters, caused by empty contact fields $fileas = str_replace(array(', , : ',', : ',': , ',', , ',': : '),array(': ',': ',': ',', ',': '),$fileas); while ($fileas{0} == ':' || $fileas{0} == ',') $fileas = substr($fileas,2); while (substr($fileas,-2) == ': ' || substr($fileas,-2) == ', ') $fileas = substr($fileas,0,-2); //echo "

bocontacts::fileas(,$type)='$fileas'

\n"; return $fileas; } /** * determine the file_as type from the file_as string and the contact * * @param array $contact * @param string $type=null file_as type, default null to read it from the contact, unknown/not set type default to the first one * @return string */ function fileas_type($contact,$file_as=null) { if (is_null($file_as)) $file_as = $contact['n_fileas']; if ($file_as) { foreach($this->fileas_types as $type) { if ($this->fileas($contact,$type) == $file_as) { return $type; } } } return $this->fileas_types[0]; } /** * get selectbox options for the fileas types with translated labels, or real content * * @param array $contact=null real content to use, default none * @return array with options: fileas type => label pairs */ function fileas_options($contact=null) { $labels = array( 'n_prefix' => lang('prefix'), 'n_given' => lang('first name'), 'n_middle' => lang('middle name'), 'n_family' => lang('last name'), 'n_suffix' => lang('suffix'), 'n_fn' => lang('full name'), 'org_name' => lang('company'), 'org_unit' => lang('department'), 'adr_one_locality' => lang('city'), ); foreach($labels as $name => $label) { if ($contact[$name]) $labels[$name] = $contact[$name]; } foreach($this->fileas_types as $fileas_type) { $options[$fileas_type] = $this->fileas($labels,$fileas_type); } return $options; } /** * get full name from the name-parts * * @param array $contact * @return string full name */ function fullname($contact) { $parts = array(); foreach(array('n_prefix','n_given','n_middle','n_family','n_suffix') as $n) { if ($contact[$n]) $parts[] = $contact[$n]; } return implode(' ',$parts); } /** * changes the data from the db-format to your work-format * * it gets called everytime when data is read from the db * This function needs to be reimplemented in the derived class * * @param array $data */ function db2data($data) { // convert timestamps from server-time in the db to user-time foreach($this->timestamps as $name) { if(isset($data[$name])) { $data[$name] += $this->tz_offset_s; } } $data['photo'] = $this->photo_src($data['id'],$data['jpegphoto']); // set freebusy_uri for accounts if (!$data['freebusy_uri'] && !$data['owner'] && $data['account_id'] && !is_object($GLOBALS['egw_setup'])) { static $fb_url; if (!$fb_url && @is_dir(EGW_SERVER_ROOT.'/calendar/inc')) $fb_url = ExecMethod('calendar.bocal.freebusy_url',''); if ($fb_url) $data['freebusy_uri'] = $fb_url.urlencode($GLOBALS['egw']->accounts->id2name($data['account_id'])); } return $data; } /** * src for photo: returns array with linkparams if jpeg exists or the $default image-name if not * @param int $id contact_id * @param boolean $jpeg=false jpeg exists or not * @param string $default='' image-name to use if !$jpeg, eg. 'template' * @return string/array */ function photo_src($id,$jpeg,$default='') { return $jpeg ? array( 'menuaction' => 'addressbook.uicontacts.photo', 'contact_id' => $id, ) : $default; } /** * changes the data from your work-format to the db-format * * It gets called everytime when data gets writen into db or on keys for db-searches * this needs to be reimplemented in the derived class * * @param array $data */ function data2db($data) { // convert timestamps from user-time to server-time in the db foreach($this->timestamps as $name) { if(isset($data[$name])) { $data[$name] -= $this->tz_offset_s; } } return $data; } /** * deletes contact in db * * @param mixed &$contact contact array with key id or (array of) id(s) * @return boolean true on success or false on failiure */ function delete($contact) { if (is_array($contact) && isset($contact['id'])) { $contact = array($contact); } elseif (!is_array($contact)) { $contact = array($contact); } if (!is_object($GLOBALS['egw']->link)) { require_once(EGW_API_INC.'/class.bolink.inc.php'); $GLOBALS['egw']->link =& new bolink(); } foreach($contact as $c) { $id = is_array($c) ? $c['id'] : $c; if ($this->check_perms(EGW_ACL_DELETE,$c) && parent::delete($id)) { $GLOBALS['egw']->link->unlink(0,'addressbook',$id); $GLOBALS['egw']->contenthistory->updateTimeStamp('contacts', $id, 'delete', time()); } else { return false; } } return true; } /** * saves contact to db * * @param array &$contact contact array from etemplate::exec * @param boolean $ignore_acl=false should the acl be checked or not * @return int/string/boolean id on success, false on failure, the error-message is in $this->error */ function save(&$contact,$ignore_acl=false) { // remember if we add or update a entry if (($isUpdate = $contact['id'])) { if (!isset($contact['owner'])) // owner not set on update, eg. SyncML { if (($old = $this->read($contact['id']))) // --> try reading the old entry and set it from there { $contact['owner'] = $old['owner']; } else // entry not found --> create a new one { $isUpdate = $contact['id'] = null; } } } if (!$isUpdate) { if (!isset($contact['owner'])) $contact['owner'] = $this->user; // write to users personal addressbook $contact['creator'] = $this->user; $contact['created'] = $this->now_su; if (!$contact['tid']) $contact['tid'] = 'n'; } if(!$ignore_acl && !$this->check_perms($isUpdate ? EGW_ACL_EDIT : EGW_ACL_ADD,$contact)) { $this->error = 'access denied'; return false; } // convert categories if (is_array($contact['cat_id'])) { $contact['cat_id'] = implode(',',$contact['cat_id']); } // last modified $contact['modifier'] = $this->user; $contact['modified'] = $this->now_su; // set full name and fileas from the content if (isset($contact['n_family']) && isset($contact['n_given'])) { $contact['n_fn'] = $this->fullname($contact); if (isset($contact['org_name'])) $contact['n_fileas'] = $this->fileas($contact); } $to_write = $contact; // (non-admin) user editing his own account, make sure he does not change fields he is not allowed to (eg. via SyncML or xmlrpc) if (!$ignore_acl && !$contact['owner'] && !$this->is_admin($contact)) { foreach($contact as $field => $value) { if (!in_array($field,$this->own_account_acl) && !in_array($field,array('id','owner','account_id','modified','modifier'))) { unset($to_write[$field]); // user is now allowed to change that } } } // we dont update the content-history, if we run inside setup (admin-account-creation) if(!($this->error = parent::save($to_write)) && is_object($GLOBALS['egw']->contenthistory)) { $contact['id'] = $to_write['id']; $GLOBALS['egw']->contenthistory->updateTimeStamp('contacts', $contact['id'],$isUpdate ? 'modify' : 'add', time()); if ($contact['account_id']) // invalidate the cache of the accounts class { $GLOBALS['egw']->accounts->cache_invalidate($contact['account_id']); } // notify interested apps about changes in the account-contact data if (!$to_write['owner'] && $to_write['account_id']) { $to_write['location'] = 'editaccountcontact'; $GLOBALS['egw']->hooks->process($to_write,False,True); // called for every app now, not only enabled ones)); } } return $this->error ? false : $contact['id']; } /** * reads contacts matched by key and puts all cols in the data array * * @param int/string $contact_id * @return array/boolean array with contact data, null if not found or false on no view perms */ function read($contact_id) { if (!($data = parent::read($contact_id))) { return null; // not found } if (!$this->check_perms(EGW_ACL_READ,$data)) { return false; // no view perms } // determine the file-as type $data['fileas_type'] = $this->fileas_type($data); return $data; } /** * Checks if the current user has the necessary ACL rights * * If the access of a contact is set to private, one need a private grant for a personal addressbook * or the group membership for a group-addressbook * * @param int $needed necessary ACL right: EGW_ACL_{READ|EDIT|DELETE} * @param mixed $contact contact as array or the contact-id * @return boolean true permission granted or false for permission denied */ function check_perms($needed,$contact) { if ((!is_array($contact) || !isset($contact['owner'])) && !($contact = parent::read(is_array($contact) ? $contact['id'] : $contact))) { return false; } $owner = $contact['owner']; // allow the user to edit his own account if (!$owner && $needed == EGW_ACL_EDIT && $contact['account_id'] == $this->user && $this->own_account_acl) { return true; } // dont allow to delete own account (as admin handels it too) if (!$owner && $needed == EGW_ACL_DELETE && $contact['account_id'] == $this->user) { return false; } return ($this->grants[$owner] & $needed) && (!$contact['private'] || ($this->grants[$owner] & EGW_ACL_PRIVATE) || in_array($owner,$this->memberships)); } /** * Read (virtual) org-entry (values "common" for most contacts in the given org) * * @param string $org_id org_name:oooooo|||org_unit:uuuuuuuuu|||adr_one_locality:lllllll (org_unit and adr_one_locality are optional) * @return array/boolean array with common org fields or false if org not found */ function read_org($org_id) { if (!$org_id) return false; $org = array(); foreach(explode('|||',$org_id) as $part) { list($name,$value) = explode(':',$part); $org[$name] = $value; } $contacts = parent::search('',$this->org_fields,'','','',false,'AND',false,$org); if (!$contacts) return false; // create a statistic about the commonness of each fields values $fields = array(); foreach($contacts as $contact) { foreach($contact as $name => $value) { $fields[$name][$value]++; } } foreach($fields as $name => $values) { if (!in_array($name,$this->org_fields)) continue; arsort($values,SORT_NUMERIC); list($value,$num) = each($values); //echo "

$name: '$value' $num/".count($contacts)."=".($num / (double) count($contacts))." >= $this->org_common_factor = ".($num / (double) count($contacts) >= $this->org_common_factor ? 'true' : 'false')."

\n"; if ($value && $num / (double) count($contacts) >= $this->org_common_factor) { $org[$name] = $value; } } //echo $org_id; _debug_array($org); return $org; } /** * Return all org-members with same content in one or more of the given fields (only org_fields are counting) * * @param string $org_name * @param array $fields field-name => value pairs * @return array with contacts */ function org_similar($org_name,$fields) { $criteria = array(); foreach($this->org_fields as $name) { if (isset($fields[$name])) { $criteria[$name] = $fields[$name]; } } return parent::search($criteria,false,'n_family,n_given','','',false,'OR',false,array('org_name'=>$org_name)); } /** * Return the changed fields from two versions of a contact (not modified or modifier) * * @param array $from original/old version of the contact * @param array $to changed/new version of the contact * @param boolean $onld_org_fields=true check and return only org_fields, default true * @return array with field-name => value from $from */ function changed_fields($from,$to,$only_org_fields=true) { $changed = array(); foreach($only_org_fields ? $this->org_fields : array_keys($this->contact_fields) as $name) { if (!isset($from[$name]) || in_array($name,array('modified','modifier'))) // never count these { continue; } if ((string) $from[$name] != (string) $to[$name]) { $changed[$name] = $from[$name]; } } return $changed; } /** * Change given fields in all members of the org with identical content in the field * * @param string $org_name * @param array $from original/old version of the contact * @param array $to changed/new version of the contact * @param array $members=null org-members to change, default null --> function queries them itself * @return array/boolean (changed-members,changed-fields,failed-members) or false if no org_fields changed or no (other) members matching that fields */ function change_org($org_name,$from,$to,$members=null) { if (!($changed = $this->changed_fields($from,$to,true))) return false; if (is_null($members) || !is_array($members)) { $members = $this->org_similar($org_name,$changed); } if (!$members) return false; $changed_members = $changed_fields = $failed_members = 0; foreach($members as $member) { $fields = 0; foreach($changed as $name => $value) { if ((string)$value == (string)$member[$name]) { $member[$name] = $to[$name]; //echo "

$member[n_family], $member[n_given]: $name='{$to[$name]}'

\n"; ++$fields; } } if ($fields) { if (!$this->check_perms(EGW_ACL_EDIT,$member) || !$this->save($member)) { ++$failed_members; } else { ++$changed_members; $changed_fields += $fields; } } } return array($changed_members,$changed_fields,$failed_members); } /** * get title for a contact identified by $contact * * Is called as hook to participate in the linking. The format is determined by the link_title preference. * * @param int/string/array $contact int/string id or array with contact * @param string/boolean string with the title, null if contact does not exitst, false if no perms to view it * @return string */ function link_title($contact) { if (!is_array($contact) && $contact) { $contact = $this->read($contact); } if (!is_array($contact)) { return $contact; } $type = $this->prefs['link_title']; if (!$type || $type === 'n_fileas') { if ($contact['n_fileas']) return $contact['n_fileas']; $type = null; } return $this->fileas($contact,$type); } /** * query addressbook for contacts matching $pattern * * Is called as hook to participate in the linking * * @param string $pattern pattern to search * @return array with id - title pairs of the matching entries */ function link_query($pattern) { $result = $criteria = array(); if ($pattern) { foreach($this->columns_to_search as $col) { $criteria[$col] = $pattern; } } if (($contacts = parent::search($criteria,false,'org_name,n_family,n_given','','%',false,'OR'))) { foreach($contacts as $contact) { $result[$contact['id']] = $this->link_title($contact); } } return $result; } /** * Hook called by link-class to include calendar in the appregistry of the linkage * * @param array/string $location location and other parameters (not used) * @return array with method-names */ function search_link($location) { return array( 'query' => 'addressbook.bocontacts.link_query', 'title' => 'addressbook.bocontacts.link_title', 'view' => array( 'menuaction' => 'addressbook.uicontacts.view' ), 'view_id' => 'contact_id', 'add' => array( 'menuaction' => 'addressbook.uicontacts.edit' ), 'add_app' => 'link_app', 'add_id' => 'link_id', 'add_popup' => '850x440', ); } /** * Register contacts as calendar resources (items which can be sheduled by the calendar) * * @param array $args hook-params (not used) * @return array */ function calendar_resources($args) { return array( 'type' => 'c',// one char type-identifiy for this resources ); } /** * Called by delete-account hook, when an account get deleted --> deletes/moves the personal addressbook * * @param array $data */ function deleteaccount($data) { // delete/move personal addressbook parent::deleteaccount($data); } /** * Called by edit-account hook, when an account get edited --> not longer used * * This function is still there, to not give a fatal error, if the hook still exists. * Can be removed after the next db-update, which also reloads the hooks. RalfBecker 2006/09/18 * * @param array $data */ function editaccount($data) { // just force a new registration of the addressbook hooks include(EGW_INCLUDE_ROOT.'/addressbook/setup/setup.inc.php'); $GLOBALS['egw']->hooks->register_hooks('addressbook',$setup_info['addressbook']['hooks']); } /** * Merges some given addresses into the first one and delete the others * * If one of the other addresses is an account, everything is merged into the account. * If two accounts are in $ids, the function fails (returns false). * * @param array $ids contact-id's to merge * @return int number of successful merged contacts, false on a fatal error (eg. cant merge two accounts) */ function merge($ids) { $this->error = false; foreach(self::search(array('id'=>$ids),false) as $contact) // $this->search calls the extended search from ui! { if ($contact['account_id']) { if (!is_null($account)) { echo $this->error = 'Can not merge more then one account!'; return false; // we dont deal with two accounts! } $account = $contact; continue; } $pos = array_search($contact['id'],$ids); $contacts[$pos] = $contact; } if (!is_null($account)) // we found an account, so we merge the contacts into it { $target = $account; unset($account); } else // we found no account, so we merge all but the first into the first { $target = $contacts[0]; unset($contacts[0]); } if (!$this->check_perms(EGW_ACL_EDIT,$target)) { echo $this->error = 'No edit permission for the target contact!'; return 0; } foreach($contacts as $contact) { foreach($contact as $name => $value) { if (!$value) continue; switch($name) { case 'id': case 'tid': case 'owner': case 'private': break; // ignored case 'cat_id': // cats are all merged together if (!is_array($target['cat_id'])) $target['cat_id'] = $target['cat_id'] ? explode(',',$target['cat_id']) : array(); $target['cat_id'] = array_unique(array_merge($target['cat_id'],is_array($value)?$value:explode(',',$value))); break; default: if (!$target[$name]) $target[$name] = $value; break; } } } if (!$this->save($target)) return 0; if (!is_object($GLOBALS['egw']->link)) { require_once(EGW_API_INC.'/class.bolink.inc.php'); $GLOBALS['egw']->link =& new bolink(); } $success = 1; foreach($contacts as $contact) { if (!$this->check_perms(EGW_ACL_DELETE,$contact)) { continue; } foreach($GLOBALS['egw']->link->get_links('addressbook',$contact['id']) as $data) { $GLOBALS['egw']->link->link('addressbook',$target['id'],$data['app'],$data['id'],$data['remark'],$target['owner']); } if ($this->delete($contact['id'])) $success++; } return $success; } /** * Check if user has required rights for a list or list-owner * * @param int $list * @param int $required * @param int $owner=null * @return boolean */ function check_list($list,$required,$owner=null) { if ($list && ($list_data = $this->read_list($list))) { $owner = $list_data['list_owner']; } return !!($this->grants[$owner] & $required); } /** * Adds a distribution list * * @param string $name list-name * @param int $owner user- or group-id * @param array $contacts=array() contacts to add * @return list_id or false on error */ function add_list($name,$owner,$contacts=array()) { if (!$this->check_list(null,EGW_ACL_ADD,$owner)) return false; return parent::add_list($name,$owner,$contacts); } /** * Adds one contact to a distribution list * * @param int $contact contact_id * @param int $list list-id * @return false on error */ function add2list($contact,$list) { if (!$this->check_list($list,EGW_ACL_EDIT)) return false; return parent::add2list($contact,$list); } /** * Removes one contact from distribution list(s) * * @param int $contact contact_id * @param int $list list-id * @return false on error */ function remove_from_list($contact,$list) { if (!$this->check_list($list,EGW_ACL_EDIT)) return false; return parent::remove_from_list($contact,$list); } /** * Deletes a distribution list (incl. it's members) * * @param int/array $list list_id(s) * @return number of members deleted or false if list does not exist */ function delete_list($list) { if (!$this->check_list($list,EGW_ACL_DELETE)) return false; return parent::delete_list($list); } /** * Read data of a distribution list * * @param int $list list_id * @return array of data or false if list does not exist */ function read_list($list) { static $cache; if (isset($cache[$list])) return $cache[$list]; return $cache[$list] = parent::read_list($list); } }