| | |
| | | <?php |
| | | |
| | | /* |
| | | /** |
| | | +-----------------------------------------------------------------------+ |
| | | | This file is part of the Roundcube Webmail client | |
| | | | Copyright (C) 2005-2012, The Roundcube Dev Team | |
| | |
| | | } |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Magic getter for backward compat. |
| | | * |
| | |
| | | return $this->{$name}; |
| | | } |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Connect to an IMAP server |
| | |
| | | return false; |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Close IMAP connection. |
| | | * Usually done on script shutdown |
| | |
| | | $this->mcache->close(); |
| | | } |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Check connection state, connect if not connected. |
| | |
| | | return $this->is_connected(); |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Checks IMAP connection. |
| | | * |
| | |
| | | { |
| | | return $this->conn->connected(); |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Returns code of last error |
| | |
| | | return $this->conn->errornum; |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Returns text of last error |
| | | * |
| | |
| | | { |
| | | return $this->conn->error; |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Returns code of last command response |
| | |
| | | } |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Activate/deactivate debug mode |
| | | * |
| | |
| | | $this->conn->setDebug($dbg, array($this, 'debug_handler')); |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Set internal folder reference. |
| | | * All operations will be perfomed on this folder. |
| | | * |
| | | * @param string $folder Folder name |
| | | * @param string $folder Folder name |
| | | */ |
| | | public function set_folder($folder) |
| | | { |
| | | $this->folder = $folder; |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Save a search result for future message listing methods |
| | | * |
| | | * @param array $set Search set, result from rcube_imap::get_search_set(): |
| | | * @param array $set Search set, result from rcube_imap::get_search_set(): |
| | | * 0 - searching criteria, string |
| | | * 1 - search result, rcube_result_index|rcube_result_thread |
| | | * 2 - searching character set, string |
| | |
| | | } |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Return the saved search set as hash array |
| | | * |
| | |
| | | $this->search_sorted, |
| | | ); |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Returns the IMAP server's capability. |
| | |
| | | return $_SESSION[$sess_key]; |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Checks the PERMANENTFLAGS capability of the current folder |
| | | * and returns true if the given flag is supported by the IMAP server |
| | | * |
| | | * @param string $flag Permanentflag name |
| | | * @param string $flag Permanentflag name |
| | | * |
| | | * @return boolean True if this flag is supported |
| | | * @return boolean True if this flag is supported |
| | | */ |
| | | public function check_permflag($flag) |
| | | { |
| | |
| | | return $imap_flag && !empty($perm_flags) && in_array_nocase($imap_flag, $perm_flags); |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Returns PERMANENTFLAGS of the specified folder |
| | | * |
| | | * @param string $folder Folder name |
| | | * @param string $folder Folder name |
| | | * |
| | | * @return array Flags |
| | | */ |
| | |
| | | return $permflags; |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Returns the delimiter that is used by the IMAP server for folder separation |
| | | * |
| | | * @return string Delimiter string |
| | | * @access public |
| | | * @return string Delimiter string |
| | | */ |
| | | public function get_hierarchy_delimiter() |
| | | { |
| | | return $this->delimiter; |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Get namespace |
| | | * |
| | | * @param string $name Namespace array index: personal, other, shared, prefix |
| | | * |
| | | * @return array Namespace data |
| | | * @return array Namespace data |
| | | */ |
| | | public function get_namespace($name = null) |
| | | { |
| | |
| | | unset($ns['prefix']); |
| | | return $ns; |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Sets delimiter and namespaces |
| | |
| | | $_SESSION['imap_delimiter'] = $this->delimiter; |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Get message count for a specific folder |
| | | * |
| | |
| | | * @param boolean $status Enables storing folder status info (max UID/count), |
| | | * required for folder_status() |
| | | * |
| | | * @return int Number of messages |
| | | * @return int Number of messages |
| | | */ |
| | | public function count($folder='', $mode='ALL', $force=false, $status=true) |
| | | { |
| | |
| | | return $this->countmessages($folder, $mode, $force, $status); |
| | | } |
| | | |
| | | |
| | | /** |
| | | * protected method for getting nr of messages |
| | | * Protected method for getting number of messages |
| | | * |
| | | * @param string $folder Folder name |
| | | * @param string $mode Mode for count [ALL|THREADS|UNSEEN|RECENT|EXISTS] |
| | | * @param boolean $force Force reading from server and update cache |
| | | * @param boolean $status Enables storing folder status info (max UID/count), |
| | | * required for folder_status() |
| | | * @param string $folder Folder name |
| | | * @param string $mode Mode for count [ALL|THREADS|UNSEEN|RECENT|EXISTS] |
| | | * @param boolean $force Force reading from server and update cache |
| | | * @param boolean $status Enables storing folder status info (max UID/count), |
| | | * required for folder_status() |
| | | * @param boolean $no_search Ignore current search result |
| | | * |
| | | * @return int Number of messages |
| | | * @see rcube_imap::count() |
| | | */ |
| | | protected function countmessages($folder, $mode='ALL', $force=false, $status=true) |
| | | protected function countmessages($folder, $mode = 'ALL', $force = false, $status = true, $no_search = false) |
| | | { |
| | | $mode = strtoupper($mode); |
| | | |
| | | // count search set, assume search set is always up-to-date (don't check $force flag) |
| | | if ($this->search_string && $folder == $this->folder && ($mode == 'ALL' || $mode == 'THREADS')) { |
| | | // Count search set, assume search set is always up-to-date (don't check $force flag) |
| | | // @TODO: this could be handled in more reliable way, e.g. a separate method |
| | | // maybe in rcube_imap_search |
| | | if (!$no_search && $this->search_string && $folder == $this->folder) { |
| | | if ($mode == 'ALL') { |
| | | return $this->search_set->count_messages(); |
| | | } |
| | | else { |
| | | else if ($mode == 'THREADS') { |
| | | return $this->search_set->count(); |
| | | } |
| | | } |
| | |
| | | return (int)$count; |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Public method for listing message flags |
| | | * |
| | |
| | | return $result; |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Public method for listing headers |
| | | * |
| | |
| | | * @param string $sort_order Sort order [ASC|DESC] |
| | | * @param int $slice Number of slice items to extract from result array |
| | | * |
| | | * @return array Indexed array with message header objects |
| | | * @return array Indexed array with message header objects |
| | | */ |
| | | public function list_messages($folder='', $page=NULL, $sort_field=NULL, $sort_order=NULL, $slice=0) |
| | | { |
| | |
| | | return $this->_list_messages($folder, $page, $sort_field, $sort_order, $slice); |
| | | } |
| | | |
| | | |
| | | /** |
| | | * protected method for listing message headers |
| | | * |
| | |
| | | * @param string $sort_order Sort order [ASC|DESC] |
| | | * @param int $slice Number of slice items to extract from result array |
| | | * |
| | | * @return array Indexed array with message header objects |
| | | * @see rcube_imap::list_messages |
| | | * @return array Indexed array with message header objects |
| | | * @see rcube_imap::list_messages |
| | | */ |
| | | protected function _list_messages($folder='', $page=NULL, $sort_field=NULL, $sort_order=NULL, $slice=0) |
| | | { |
| | |
| | | return array_values($a_msg_headers); |
| | | } |
| | | |
| | | |
| | | /** |
| | | * protected method for listing message headers using threads |
| | | * |
| | | * @param string $folder Folder name |
| | | * @param int $page Current page to list |
| | | * @param int $slice Number of slice items to extract from result array |
| | | * @param string $folder Folder name |
| | | * @param int $page Current page to list |
| | | * @param int $slice Number of slice items to extract from result array |
| | | * |
| | | * @return array Indexed array with message header objects |
| | | * @see rcube_imap::list_messages |
| | | * @return array Indexed array with message header objects |
| | | * @see rcube_imap::list_messages |
| | | */ |
| | | protected function list_thread_messages($folder, $page, $slice=0) |
| | | { |
| | |
| | | /** |
| | | * Method for fetching threads data |
| | | * |
| | | * @param string $folder Folder name |
| | | * @param string $folder Folder name |
| | | * |
| | | * @return rcube_imap_thread Thread data object |
| | | */ |
| | |
| | | return $this->icache['threads'] = $result; |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Method for direct fetching of threads data |
| | | * |
| | | * @param string $folder Folder name |
| | | * @param string $folder Folder name |
| | | * |
| | | * @return rcube_imap_thread Thread data object |
| | | */ |
| | |
| | | $this->options['skip_deleted'] ? 'UNDELETED' : '', true); |
| | | } |
| | | |
| | | |
| | | /** |
| | | * protected method for fetching threaded messages headers |
| | | * |
| | |
| | | * @param int $page List page number |
| | | * @param int $slice Number of threads to slice |
| | | * |
| | | * @return array Messages headers |
| | | * @return array Messages headers |
| | | */ |
| | | protected function fetch_thread_headers($folder, $threads, $page, $slice=0) |
| | | { |
| | |
| | | return array_values($a_msg_headers); |
| | | } |
| | | |
| | | |
| | | /** |
| | | * protected method for setting threaded messages flags: |
| | | * depth, has_children and unread_children |
| | | * |
| | | * @param array $headers Reference to headers array indexed by message UID |
| | | * @param rcube_result_thread $threads Threads data object |
| | | * @param array $headers Reference to headers array indexed by message UID |
| | | * @param rcube_result_thread $threads Threads data object |
| | | * |
| | | * @return array Message headers array indexed by message UID |
| | | */ |
| | |
| | | } |
| | | } |
| | | |
| | | |
| | | /** |
| | | * protected method for listing a set of message headers (search results) |
| | | * |
| | |
| | | * @param int $page Current page to list |
| | | * @param int $slice Number of slice items to extract from result array |
| | | * |
| | | * @return array Indexed array with message header objects |
| | | * @return array Indexed array with message header objects |
| | | */ |
| | | protected function list_search_messages($folder, $page, $slice=0) |
| | | { |
| | |
| | | } |
| | | } |
| | | |
| | | |
| | | /** |
| | | * protected method for listing a set of threaded message headers (search results) |
| | | * |
| | |
| | | * @param int $page Current page to list |
| | | * @param int $slice Number of slice items to extract from result array |
| | | * |
| | | * @return array Indexed array with message header objects |
| | | * @return array Indexed array with message header objects |
| | | * @see rcube_imap::list_search_messages() |
| | | */ |
| | | protected function list_search_thread_messages($folder, $page, $slice=0) |
| | |
| | | |
| | | return $this->fetch_thread_headers($folder, clone $this->search_set, $page, $slice); |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Fetches messages headers (by UID) |
| | |
| | | return $a_msg_headers; |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Returns current status of a folder (compared to the last time use) |
| | | * |
| | |
| | | $old = $this->get_folder_stats($folder); |
| | | |
| | | // refresh message count -> will update |
| | | $this->countmessages($folder, 'ALL', true); |
| | | $this->countmessages($folder, 'ALL', true, true, true); |
| | | |
| | | $result = 0; |
| | | |
| | |
| | | return $result; |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Stores folder statistic data in session |
| | | * @TODO: move to separate DB table (cache?) |
| | |
| | | { |
| | | $_SESSION['folders'][$folder][$name] = $data; |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Gets folder statistic data |
| | |
| | | |
| | | return array(); |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Return sorted list of message UIDs |
| | |
| | | return $this->index_direct($folder, $this->sort_field, $this->sort_order); |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Return sorted list of message UIDs ignoring current search settings. |
| | | * Doesn't uses cache by default. |
| | |
| | | public function index_direct($folder, $sort_field = null, $sort_order = null, $search = null) |
| | | { |
| | | if (!empty($search)) { |
| | | $search = $this->search_set->get_compressed(); |
| | | $search = $search->get_compressed(); |
| | | } |
| | | |
| | | // use message index sort as default sorting |
| | |
| | | return $index; |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Return index of threaded message UIDs |
| | | * |
| | |
| | | return $threads; |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Sort threaded result, using THREAD=REFS method if available. |
| | | * If not, use any method and re-sort the result in THREAD=REFS way. |
| | |
| | | $threads->revert(); |
| | | } |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Invoke search request to IMAP server |
| | |
| | | return $results; |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Direct (real and simple) SEARCH request (without result sorting and caching). |
| | | * |
| | |
| | | |
| | | return $index; |
| | | } |
| | | |
| | | |
| | | /** |
| | | * protected search method |
| | |
| | | return $messages; |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Converts charset of search criteria string |
| | | * |
| | |
| | | return $res; |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Refresh saved search set |
| | | * |
| | |
| | | } |
| | | } |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Return message headers object of a specific message |
| | |
| | | return $headers; |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Fetch message headers and body structure from the IMAP server and build |
| | | * an object structure similar to the one generated by PEAR::Mail_mimeDecode |
| | | * an object structure. |
| | | * |
| | | * @param int $uid Message UID to fetch |
| | | * @param string $folder Folder to read from |
| | | * @param int $uid Message UID to fetch |
| | | * @param string $folder Folder to read from |
| | | * |
| | | * @return object rcube_message_header Message data |
| | | */ |
| | |
| | | $structure[1] = $m[2]; |
| | | } |
| | | else { |
| | | // Try to parse the message using Mail_mimeDecode package |
| | | // We need a better solution, Mail_mimeDecode parses message |
| | | // Try to parse the message using rcube_mime_decode. |
| | | // We need a better solution, it parses message |
| | | // in memory, which wouldn't work for very big messages, |
| | | // (it uses up to 10x more memory than the message size) |
| | | // it's also buggy and not actively developed |
| | |
| | | return $this->icache['message'] = $headers; |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Build message part object |
| | | * |
| | |
| | | * @param int $count |
| | | * @param string $parent |
| | | */ |
| | | protected function structure_part($part, $count=0, $parent='', $mime_headers=null) |
| | | protected function structure_part($part, $count = 0, $parent = '', $mime_headers = null) |
| | | { |
| | | $struct = new rcube_message_part; |
| | | $struct->mime_id = empty($parent) ? (string)$count : "$parent.$count"; |
| | |
| | | for ($i=1; $i<count($part); $i++) { |
| | | if (!is_array($part[$i])) { |
| | | $struct->ctype_secondary = strtolower($part[$i]); |
| | | |
| | | // read content type parameters |
| | | if (is_array($part[$i+1])) { |
| | | $struct->ctype_parameters = array(); |
| | | for ($j=0; $j<count($part[$i+1]); $j+=2) { |
| | | $param = strtolower($part[$i+1][$j]); |
| | | $struct->ctype_parameters[$param] = $part[$i+1][$j+1]; |
| | | } |
| | | } |
| | | |
| | | break; |
| | | } |
| | | } |
| | |
| | | return $struct; |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Set attachment filename from message part structure |
| | | * |
| | | * @param rcube_message_part $part Part object |
| | | * @param string $headers Part's raw headers |
| | | * @param rcube_message_part $part Part object |
| | | * @param string $headers Part's raw headers |
| | | */ |
| | | protected function set_part_filename(&$part, $headers=null) |
| | | protected function set_part_filename(&$part, $headers = null) |
| | | { |
| | | if (!empty($part->d_parameters['filename'])) { |
| | | $filename_mime = $part->d_parameters['filename']; |
| | |
| | | } |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Get charset name from message structure (first part) |
| | | * |
| | | * @param array $structure Message structure |
| | | * @param array $structure Message structure |
| | | * |
| | | * @return string Charset name |
| | | */ |
| | |
| | | * |
| | | * @return string Message/part body if not printed |
| | | */ |
| | | public function get_message_part($uid, $part=1, $o_part=NULL, $print=NULL, $fp=NULL, $skip_charset_conv=false, $max_bytes=0, $formatted=true) |
| | | public function get_message_part($uid, $part = 1, $o_part = null, $print = null, $fp = null, |
| | | $skip_charset_conv = false, $max_bytes = 0, $formatted = true) |
| | | { |
| | | if (!$this->check_connection()) { |
| | | return null; |
| | |
| | | return $body; |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Returns the whole message source as string (or saves to a file) |
| | | * |
| | | * @param int $uid Message UID |
| | | * @param resource $fp File pointer to save the message |
| | | * @param int $uid Message UID |
| | | * @param resource $fp File pointer to save the message |
| | | * @param string $part Optional message part ID |
| | | * |
| | | * @return string Message source string |
| | | */ |
| | | public function get_raw_body($uid, $fp=null) |
| | | public function get_raw_body($uid, $fp=null, $part = null) |
| | | { |
| | | if (!$this->check_connection()) { |
| | | return null; |
| | | } |
| | | |
| | | return $this->conn->handlePartBody($this->folder, $uid, |
| | | true, null, null, false, $fp); |
| | | true, $part, null, false, $fp); |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Returns the message headers as string |
| | | * |
| | | * @param int $uid Message UID |
| | | * @param int $uid Message UID |
| | | * @param string $part Optional message part ID |
| | | * |
| | | * @return string Message headers string |
| | | */ |
| | | public function get_raw_headers($uid) |
| | | public function get_raw_headers($uid, $part = null) |
| | | { |
| | | if (!$this->check_connection()) { |
| | | return null; |
| | | } |
| | | |
| | | return $this->conn->fetchPartHeader($this->folder, $uid, true); |
| | | return $this->conn->fetchPartHeader($this->folder, $uid, true, $part); |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Sends the whole message source to stdout |
| | |
| | | |
| | | $this->conn->handlePartBody($this->folder, $uid, true, null, null, true, null, $formatted); |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Set message flag to one or several messages |
| | |
| | | return $result; |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Append a mail message (source) to a specific folder |
| | | * |
| | |
| | | |
| | | return $saved; |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Move a message from one folder to another |
| | |
| | | return $moved; |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Copy a message from one folder to another |
| | | * |
| | |
| | | |
| | | return $copied; |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Mark messages as deleted and expunge them |
| | |
| | | |
| | | return $deleted; |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Send IMAP expunge command and clear cache |
| | |
| | | return $a_mboxes; |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Method for direct folders listing (LSUB) |
| | | * |
| | | * @param string $root Optional root folder |
| | | * @param string $name Optional name pattern |
| | | * @param string $root Optional root folder |
| | | * @param string $name Optional name pattern |
| | | * |
| | | * @return array List of subscribed folders |
| | | * @see rcube_imap::list_folders_subscribed() |
| | | * @return array List of subscribed folders |
| | | * @see rcube_imap::list_folders_subscribed() |
| | | */ |
| | | public function list_folders_subscribed_direct($root='', $name='*') |
| | | { |
| | |
| | | if (is_array($a_folders) && $name == '*' && !empty($this->conn->data['LIST'])) { |
| | | foreach ($a_folders as $idx => $folder) { |
| | | if (($opts = $this->conn->data['LIST'][$folder]) |
| | | && in_array('\\NonExistent', $opts) |
| | | && in_array_nocase('\\NonExistent', $opts) |
| | | ) { |
| | | $this->conn->unsubscribe($folder); |
| | | unset($a_folders[$idx]); |
| | |
| | | |
| | | return $a_folders; |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Get a list of all folders available on the server |
| | |
| | | return $a_mboxes; |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Method for direct folders listing (LIST) |
| | | * |
| | | * @param string $root Optional root folder |
| | | * @param string $name Optional name pattern |
| | | * @param string $root Optional root folder |
| | | * @param string $name Optional name pattern |
| | | * |
| | | * @return array List of folders |
| | | * @see rcube_imap::list_folders() |
| | | * @return array List of folders |
| | | * @see rcube_imap::list_folders() |
| | | */ |
| | | public function list_folders_direct($root='', $name='*') |
| | | { |
| | |
| | | return $result; |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Fix folders list by adding folders from other namespaces. |
| | | * Needed on some servers eg. Courier IMAP |
| | | * |
| | | * @param array $result Reference to folders list |
| | | * @param string $type Listing type (ext-subscribed, subscribed or all) |
| | | * @param array $result Reference to folders list |
| | | * @param string $type Listing type (ext-subscribed, subscribed or all) |
| | | */ |
| | | protected function list_folders_update(&$result, $type = null) |
| | | { |
| | |
| | | } |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Filter the given list of folders according to access rights |
| | | * |
| | |
| | | return $a_folders; |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Get mailbox quota information |
| | | * |
| | |
| | | |
| | | return false; |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Get folder size (size of all messages in a folder) |
| | |
| | | return $result; |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Subscribe to a specific folder(s) |
| | | * |
| | |
| | | return $this->change_subscription($folders, 'subscribe'); |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Unsubscribe folder(s) |
| | | * |
| | |
| | | // let this common function do the main work |
| | | return $this->change_subscription($folders, 'unsubscribe'); |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Create a new folder on the server and register it in local cache |
| | |
| | | |
| | | return $result; |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Set a new name to an existing folder |
| | |
| | | return $result; |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Remove folder from server |
| | | * |
| | |
| | | return $result; |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Detect special folder associations stored in storage backend |
| | | */ |
| | |
| | | return array_merge($result, $special); |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Set special folder associations stored in storage backend |
| | | */ |
| | |
| | | return true; |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Checks if folder exists and is subscribed |
| | | * |
| | |
| | | if ($subscription) { |
| | | // It's possible we already called LIST command, check LIST data |
| | | if (!empty($this->conn->data['LIST']) && !empty($this->conn->data['LIST'][$folder]) |
| | | && in_array('\\Subscribed', $this->conn->data['LIST'][$folder]) |
| | | && in_array_nocase('\\Subscribed', $this->conn->data['LIST'][$folder]) |
| | | ) { |
| | | $a_folders = array($folder); |
| | | } |
| | |
| | | |
| | | return false; |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Returns the namespace where the folder is in |
| | |
| | | |
| | | return 'personal'; |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Modify folder name according to namespace. |
| | |
| | | return $folder; |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Gets folder attributes from LIST response, e.g. \Noselect, \Noinferiors |
| | | * |
| | |
| | | |
| | | return is_array($opts) ? $opts : array(); |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Gets connection (and current folder) data: UIDVALIDITY, EXISTS, RECENT, |
| | |
| | | |
| | | return $data; |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Returns extended information about the folder |
| | |
| | | return $options; |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Synchronizes messages cache. |
| | | * |
| | |
| | | $mcache->synchronize($folder); |
| | | } |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Get message header names for rcube_imap_generic::fetchHeader(s) |
| | |
| | | return $this->conn->setACL($folder, $user, $acl); |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Removes any <identifier,rights> pair for the |
| | | * specified user from the ACL for the specified |
| | |
| | | return $this->conn->deleteACL($folder, $user); |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Returns the access control list for folder (GETACL) |
| | | * |
| | |
| | | |
| | | return $this->conn->getACL($folder); |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Returns information about what rights can be granted to the |
| | |
| | | return $this->conn->listRights($folder, $user); |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Returns the set of rights that the current user has to |
| | | * folder (MYRIGHTS) |
| | |
| | | |
| | | return $this->conn->myRights($folder); |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Sets IMAP metadata/annotations (SETMETADATA/SETANNOTATION) |
| | |
| | | return false; |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Unsets IMAP metadata/annotations (SETMETADATA/SETANNOTATION) |
| | | * |
| | |
| | | |
| | | return false; |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Returns IMAP metadata/annotations (GETMETADATA/GETANNOTATION) |
| | |
| | | |
| | | // @TODO: Honor MAXSIZE and DEPTH options |
| | | foreach ($queries as $attrib => $entry) { |
| | | if ($result = $this->conn->getAnnotation($folder, $entry, $attrib)) { |
| | | $res = array_merge_recursive($res, $result); |
| | | $result = $this->conn->getAnnotation($folder, $entry, $attrib); |
| | | |
| | | // an error, invalidate any previous getAnnotation() results |
| | | if (!is_array($result)) { |
| | | return null; |
| | | } |
| | | else { |
| | | foreach ($result as $fldr => $data) { |
| | | $res[$fldr] = array_merge((array) $res[$fldr], $data); |
| | | } |
| | | } |
| | | } |
| | | } |
| | |
| | | |
| | | return null; |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Converts the METADATA extension entry name into the correct |
| | |
| | | } |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Getter for messages cache object |
| | | */ |
| | |
| | | return $this->mcache; |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Clears the messages cache. |
| | | * |
| | |
| | | $mcache->clear($folder, $uids); |
| | | } |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Delete outdated cache entries |
| | |
| | | $this->sort_order = strtoupper($sort_order) == 'DESC' ? 'DESC' : 'ASC'; |
| | | } |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Sort folders first by default folders and then in alphabethical order |
| | |
| | | } |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Find UID of the specified message sequence ID |
| | | * |
| | | * @param int $id Message (sequence) ID |
| | | * @param string $folder Folder name |
| | | * @param int $id Message (sequence) ID |
| | | * @param string $folder Folder name |
| | | * |
| | | * @return int Message UID |
| | | */ |
| | |
| | | |
| | | return $uid; |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Subscribe/unsubscribe a list of folders and update local cache |
| | |
| | | return $updated; |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Increde/decrese messagecount for a specific folder |
| | | */ |
| | |
| | | return true; |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Remove messagecount of a specific folder from cache |
| | | */ |
| | |
| | | $this->update_cache('messagecount', $a_folder_cache); |
| | | } |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Converts date string/object into IMAP date/time format |
| | |
| | | |
| | | return $date->format('d-M-Y H:i:s O'); |
| | | } |
| | | |
| | | |
| | | /** |
| | | * This is our own debug handler for the IMAP connection |
| | |
| | | return $this->mod_folder($folder, $mode); |
| | | } |
| | | |
| | | public function mailbox_attributes($folder, $force=false) |
| | | public function mailbox_attributes($folder, $force = false) |
| | | { |
| | | return $this->folder_attributes($folder, $force); |
| | | } |
| | |
| | | return $this->folder_sync($folder); |
| | | } |
| | | |
| | | public function expunge($folder='', $clear_cache=true) |
| | | public function expunge($folder = '', $clear_cache = true) |
| | | { |
| | | return $this->expunge_folder($folder, $clear_cache); |
| | | } |
| | | |
| | | } |