| | |
| | | abstract function get_record($id, $assoc=false); |
| | | |
| | | /** |
| | | * Returns the last error occured (e.g. when updating/inserting failed) |
| | | * Returns the last error occurred (e.g. when updating/inserting failed) |
| | | * |
| | | * @return array Hash array with the following fields: type, message |
| | | */ |
| | |
| | | public function validate(&$save_data, $autofix = false) |
| | | { |
| | | $rcube = rcube::get_instance(); |
| | | $valid = true; |
| | | |
| | | // check validity of email addresses |
| | | foreach ($this->get_col_values('email', $save_data, true) as $email) { |
| | |
| | | if (!rcube_utils::check_email(rcube_utils::idn_to_ascii($email))) { |
| | | $error = $rcube->gettext(array('name' => 'emailformaterror', 'vars' => array('email' => $email))); |
| | | $this->set_error(self::ERROR_VALIDATE, $error); |
| | | return false; |
| | | $valid = false; |
| | | break; |
| | | } |
| | | } |
| | | } |
| | | |
| | | return true; |
| | | // allow plugins to do contact validation and auto-fixing |
| | | $plugin = $rcube->plugins->exec_hook('contact_validate', array( |
| | | 'record' => $save_data, |
| | | 'autofix' => $autofix, |
| | | 'valid' => $valid, |
| | | )); |
| | | |
| | | if ($valid && !$plugin['valid']) { |
| | | $this->set_error(self::ERROR_VALIDATE, $plugin['error']); |
| | | } |
| | | |
| | | if (is_array($plugin['record'])) { |
| | | $save_data = $plugin['record']; |
| | | } |
| | | |
| | | return $plugin['valid']; |
| | | } |
| | | |
| | | /** |
| | |
| | | * @param array Assoziative array with save data |
| | | * Keys: Field name with optional section in the form FIELD:SECTION |
| | | * Values: Field value. Can be either a string or an array of strings for multiple values |
| | | * @return boolean True on success, False on error |
| | | * |
| | | * @return mixed On success if ID has been changed returns ID, otherwise True, False on error |
| | | */ |
| | | function update($id, $save_cols) |
| | | { |
| | |
| | | |
| | | /** |
| | | * Mark all records in database as deleted |
| | | * |
| | | * @param bool $with_groups Remove also groups |
| | | */ |
| | | function delete_all() |
| | | function delete_all($with_groups = false) |
| | | { |
| | | /* empty for read-only address books */ |
| | | } |
| | |
| | | $fn = join(' ', array($contact['surname'], $contact['firstname'], $contact['middlename'])); |
| | | else if ($compose_mode == 1) |
| | | $fn = join(' ', array($contact['firstname'], $contact['middlename'], $contact['surname'])); |
| | | else |
| | | else if ($compose_mode == 0) |
| | | $fn = !empty($contact['name']) ? $contact['name'] : join(' ', array($contact['prefix'], $contact['firstname'], $contact['middlename'], $contact['surname'], $contact['suffix'])); |
| | | else { |
| | | $plugin = rcube::get_instance()->plugins->exec_hook('contact_listname', array('contact' => $contact)); |
| | | $fn = $plugin['fn']; |
| | | } |
| | | |
| | | $fn = trim($fn, ', '); |
| | | |
| | |
| | | } |
| | | |
| | | return $fn; |
| | | } |
| | | |
| | | /** |
| | | * Build contact display name for autocomplete listing |
| | | * |
| | | * @param array Hash array with contact data as key-value pairs |
| | | * @param string Optional email address |
| | | * @param string Optional name (self::compose_list_name() result) |
| | | * @param string Optional template to use (defaults to the 'contact_search_name' config option) |
| | | * |
| | | * @return string Display name |
| | | */ |
| | | public static function compose_search_name($contact, $email = null, $name = null, $templ = null) |
| | | { |
| | | static $template; |
| | | |
| | | if (empty($templ) && !isset($template)) { // cache this |
| | | $template = rcube::get_instance()->config->get('contact_search_name'); |
| | | if (empty($template)) { |
| | | $template = '{name} <{email}>'; |
| | | } |
| | | } |
| | | |
| | | $result = $templ ?: $template; |
| | | |
| | | if (preg_match_all('/\{[a-z]+\}/', $result, $matches)) { |
| | | foreach ($matches[0] as $key) { |
| | | $key = trim($key, '{}'); |
| | | $value = ''; |
| | | |
| | | switch ($key) { |
| | | case 'name': |
| | | $value = $name ?: self::compose_list_name($contact); |
| | | break; |
| | | |
| | | case 'email': |
| | | $value = $email; |
| | | break; |
| | | } |
| | | |
| | | if (empty($value)) { |
| | | $value = strpos($key, ':') ? $contact[$key] : self::get_col_values($key, $contact, true); |
| | | if (is_array($value)) { |
| | | $value = $value[0]; |
| | | } |
| | | } |
| | | |
| | | $result = str_replace('{' . $key . '}', $value, $result); |
| | | } |
| | | } |
| | | |
| | | $result = preg_replace('/\s+/', ' ', $result); |
| | | $result = preg_replace('/\s*(<>|\(\)|\[\])/', '', $result); |
| | | $result = trim($result, '/ '); |
| | | |
| | | return $result; |
| | | } |
| | | |
| | | /** |
| | |
| | | // 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)); |
| | | return (($value = rcube_utils::anytodatetime($value)) |
| | | && ($search = rcube_utils::anytodatetime($search)) |
| | | && $value->format('Ymd') == $search->format('Ymd')); |
| | | } |
| | | |
| | | // composite field, e.g. address |