/functions/imap_mailbox.php

Description

imap_mailbox.php

This implements all functions that manipulate mailboxes

Includes
require_once (SM_PATH.'functions/imap_utf7_local.php') (line 16)

UTF7 support

Functions
check_is_noselect (line 51)
  • return: whether this is a Noselect mailbox.
bool check_is_noselect ( $lsub_line)
  • $lsub_line
find_mailbox_name (line 39)
void find_mailbox_name ( $mailbox)
  • $mailbox
isBoxBelow (line 77)

Check if $subbox is below the specified $parentbox

void isBoxBelow ( $subbox,  $parentbox)
  • $subbox
  • $parentbox
isDraftMailbox (line 160)

Detects if mailbox is a Drafts folder or subfolder of Drafts

  • return: whether this is a Draft folder
  • since: 1.4.0
bool isDraftMailbox (string $box, [boolean $include_subs = true])
  • string $box: mailbox name
  • boolean $include_subs: (since 1.5.2 and 1.4.9) if true, subfolders of system folders are special. if false, subfolders are not special mailboxes.
isSentMailbox (line 145)

Detects if mailbox is a Sent folder or subfolder of Sent

  • return: whether this is a Sent folder
  • since: 1.4.0
bool isSentMailbox (string $box, [boolean $include_subs = true])
  • string $box: mailbox name
  • boolean $include_subs: (since 1.5.2 and 1.4.9) if true, subfolders of system folders are special. if false, subfolders are not special mailboxes.
isSpecialMailbox (line 110)

Defines special mailboxes: given a mailbox name, it checks if this is a "special" one: INBOX, Trash, Sent or Draft.

Since 1.2.5 function includes special_mailbox hook.
Since 1.4.3 hook supports more than one plugin.

  • since: 1.2.3
boolean isSpecialMailbox (string $box, [boolean $include_subs = true])
  • string $box: mailbox name
  • boolean $include_subs: (since 1.5.2 and 1.4.9) if true, subfolders of system folders are special. if false, subfolders are not special mailboxes unless they are tagged as special in 'special_mailbox' hook.
isTrashMailbox (line 130)

Detects if mailbox is a Trash folder or subfolder of Trash

  • return: whether this is a Trash folder
  • since: 1.4.0
bool isTrashMailbox (string $box, [boolean $include_subs = true])
  • string $box: mailbox name
  • boolean $include_subs: (since 1.5.2 and 1.4.9) if true, subfolders of system folders are special. if false, subfolders are not special mailboxes.
mailtree_sort (line 548)

Mailboxes with some chars (like -) can mess up the order, this fixes it

void mailtree_sort ( &$lsub)
  • &$lsub
readMailboxParent (line 60)

If $haystack is a full mailbox name, and $needle is the mailbox

separator character, returns the second last part of the full mailbox name (i.e. the mailbox's parent mailbox)

void readMailboxParent ( $haystack,  $needle)
  • $haystack
  • $needle
sortSpecialMbx (line 20)
void sortSpecialMbx ( $a,  $b)
  • $a
  • $b
sqimap_mailbox_create (line 268)

Creates a folder.

void sqimap_mailbox_create ( $imap_stream,  $mailbox,  $type)
  • $imap_stream
  • $mailbox
  • $type
sqimap_mailbox_delete (line 300)

Deletes the given folder

void sqimap_mailbox_delete ( $imap_stream,  $mailbox)
  • $imap_stream
  • $mailbox
sqimap_mailbox_exists (line 198)

Checks whether or not the specified mailbox exists

void sqimap_mailbox_exists ( $imap_stream,  $mailbox)
  • $imap_stream
  • $mailbox
sqimap_mailbox_expunge (line 170)

Expunges a mailbox, ie. delete all contents.

void sqimap_mailbox_expunge ( $imap_stream,  $mailbox, [ $handle_errors = true], [ $id = ''])
  • $imap_stream
  • $mailbox
  • $handle_errors
  • $id
sqimap_mailbox_is_subscribed (line 320)

Determines if the user is subscribed to the folder or not

void sqimap_mailbox_is_subscribed ( $imap_stream,  $folder)
  • $imap_stream
  • $folder
sqimap_mailbox_list (line 566)

Returns sorted mailbox lists in several different ways.

See comment on sqimap_mailbox_parse() for info about the returned array.

void sqimap_mailbox_list ( $imap_stream, [ $force = false])
  • $imap_stream
  • $force
sqimap_mailbox_list_all (line 720)

Returns a list of all folders, subscribed or not

void sqimap_mailbox_list_all ( $imap_stream)
  • $imap_stream
sqimap_mailbox_option_list (line 492)

Returns list of options (to be echoed into select statement based on available mailboxes and separators Caller should surround options with <select ...> </select> and any formatting.

$imap_stream - $imapConnection to query for mailboxes $show_selected - array containing list of mailboxes to pre-select (0 if none) $folder_skip - array of folders to keep out of option list (compared in lower) $boxes - list of already fetched boxes (for places like folder panel, where you know these options will be shown 3 times in a row.. (most often unset). $flag - flag to check for in mailbox flags, used to filter out mailboxes. 'noselect' by default to remove unselectable mailboxes. 'noinferiors' used to filter out folders that can not contain subfolders. NULL to avoid flag check entirely. $use_long_format - override folder display preference and always show full folder name.

void sqimap_mailbox_option_list ( $imap_stream, [ $show_selected = 0], [ $folder_skip = 0], [ $boxes = 0], [ $flag = 'noselect'], [ $use_long_format = false])
  • $imap_stream
  • $show_selected
  • $folder_skip
  • $boxes
  • $flag
  • $use_long_format
sqimap_mailbox_parse (line 399)

Formats a mailbox into parts for the $boxesall array

The parts are:

raw - Raw LIST/LSUB response from the IMAP server formatted - nicely formatted folder name unformatted - unformatted, but with delimiter at end removed unformatted-dm - folder name as it appears in raw response unformatted-disp - unformatted without $folder_prefix

void sqimap_mailbox_parse ( $line,  $line_lsub)
  • $line
  • $line_lsub
sqimap_mailbox_rename (line 333)

Renames a mailbox.

void sqimap_mailbox_rename ( $imap_stream,  $old_name,  $new_name)
  • $imap_stream
  • $old_name
  • $new_name
sqimap_mailbox_select (line 210)

Selects a mailbox

void sqimap_mailbox_select ( $imap_stream,  $mailbox)
  • $imap_stream
  • $mailbox
sqimap_subscribe (line 284)

Subscribes to an existing folder.

void sqimap_subscribe ( $imap_stream,  $mailbox)
  • $imap_stream
  • $mailbox
sqimap_unsubscribe (line 292)

Unsubscribes from an existing folder

void sqimap_unsubscribe ( $imap_stream,  $mailbox)
  • $imap_stream
  • $mailbox
user_strcasecmp (line 472)

Sorting function used to sort mailbox names.

  • Original patch from [email protected]
  • Allows case insensitivity when sorting folders
  • Takes care of the delimiter being sorted to the end, causing subfolders to be listed in below folders that are prefixed with their parent folders name.
For example: INBOX.foo, INBOX.foobar, and INBOX.foo.bar Without special sort function: foobar between foo and foo.bar With special sort function: foobar AFTER foo and foo.bar :)

void user_strcasecmp ( $a,  $b)
  • $a
  • $b

Documentation generated on Sat, 07 Oct 2006 16:31:40 +0300 by phpDocumentor 1.3.0RC6