| | |
| | | public $sort_col = 'name'; |
| | | public $sort_order = 'ASC'; |
| | | public $coltypes = array('name' => array('limit'=>1), 'firstname' => array('limit'=>1), 'surname' => array('limit'=>1), 'email' => array('limit'=>1)); |
| | | public $date_cols = array(); |
| | | |
| | | protected $error; |
| | | |
| | |
| | | return true; |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Create a new contact record |
| | | * |
| | |
| | | * List all active contact groups of this source |
| | | * |
| | | * @param string Optional search string to match group name |
| | | * @param int Matching mode: |
| | | * 0 - partial (*abc*), |
| | | * 1 - strict (=), |
| | | * 2 - prefix (abc*) |
| | | * |
| | | * @return array Indexed list of contact groups, each a hash array |
| | | */ |
| | | function list_groups($search = null) |
| | | function list_groups($search = null, $mode = 0) |
| | | { |
| | | /* empty for address books don't supporting groups */ |
| | | return array(); |
| | |
| | | /** |
| | | * Add the given contact records the a certain group |
| | | * |
| | | * @param string Group identifier |
| | | * @param array List of contact identifiers to be added |
| | | * @return int Number of contacts added |
| | | * @param string Group identifier |
| | | * @param array|string List of contact identifiers to be added |
| | | * |
| | | * @return int Number of contacts added |
| | | */ |
| | | function add_to_group($group_id, $ids) |
| | | { |
| | |
| | | /** |
| | | * Remove the given contact records from a certain group |
| | | * |
| | | * @param string Group identifier |
| | | * @param array List of contact identifiers to be removed |
| | | * @return int Number of deleted group members |
| | | * @param string Group identifier |
| | | * @param array|string List of contact identifiers to be removed |
| | | * |
| | | * @return int Number of deleted group members |
| | | */ |
| | | function remove_from_group($group_id, $ids) |
| | | { |
| | |
| | | /* empty for address books don't supporting groups */ |
| | | return array(); |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Utility function to return all values of a certain data column |
| | |
| | | |
| | | return $out; |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Normalize the given string for fulltext search. |
| | |
| | | return $fn; |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Compose the name to display in the contacts list for the given contact record. |
| | | * This respects the settings parameter how to list conacts. |
| | |
| | | return $fn; |
| | | } |
| | | |
| | | /** |
| | | * Create a unique key for sorting contacts |
| | | */ |
| | | public static function compose_contact_key($contact, $sort_col) |
| | | { |
| | | $key = $contact[$sort_col] . ':' . $contact['sourceid']; |
| | | |
| | | // add email to a key to not skip contacts with the same name (#1488375) |
| | | if (!empty($contact['email'])) { |
| | | $key .= ':' . implode(':', (array)$contact['email']); |
| | | } |
| | | |
| | | return $key; |
| | | } |
| | | |
| | | /** |
| | | * Compare search value with contact data |
| | | * |
| | | * @param string $colname Data name |
| | | * @param string|array $value Data value |
| | | * @param string $search Search value |
| | | * @param int $mode Search mode |
| | | * |
| | | * @return bool Comparision result |
| | | */ |
| | | protected function compare_search_value($colname, $value, $search, $mode) |
| | | { |
| | | // The value is a date string, for date we'll |
| | | // use only strict comparison (mode = 1) |
| | | // @TODO: partial search, e.g. match only day and month |
| | | if (in_array($colname, $this->date_cols)) { |
| | | return (($value = rcube_utils::strtotime($value)) |
| | | && ($search = rcube_utils::strtotime($search)) |
| | | && date('Ymd', $value) == date('Ymd', $search)); |
| | | } |
| | | |
| | | // composite field, e.g. address |
| | | foreach ((array)$value as $val) { |
| | | $val = mb_strtolower($val); |
| | | switch ($mode) { |
| | | case 1: |
| | | $got = ($val == $search); |
| | | break; |
| | | |
| | | case 2: |
| | | $got = ($search == substr($val, 0, strlen($search))); |
| | | break; |
| | | |
| | | default: |
| | | $got = (strpos($val, $search) !== false); |
| | | } |
| | | |
| | | if ($got) { |
| | | return true; |
| | | } |
| | | } |
| | | |
| | | return false; |
| | | } |
| | | |
| | | } |
| | | |