Overview

Packages

  • IMP

Classes

  • IMP
  • IMP_Ajax_Addresses
  • IMP_Ajax_Application
  • IMP_Ajax_Application_Compose
  • IMP_Ajax_Application_Handler_Common
  • IMP_Ajax_Application_Handler_ComposeAttach
  • IMP_Ajax_Application_Handler_Draft
  • IMP_Ajax_Application_Handler_Dynamic
  • IMP_Ajax_Application_Handler_ImageUnblock
  • IMP_Ajax_Application_Handler_Mboxtoggle
  • IMP_Ajax_Application_Handler_Passphrase
  • IMP_Ajax_Application_Handler_Remote
  • IMP_Ajax_Application_Handler_RemotePrefs
  • IMP_Ajax_Application_Handler_Search
  • IMP_Ajax_Application_Handler_Smartmobile
  • IMP_Ajax_Application_ListMessages
  • IMP_Ajax_Application_ShowMessage
  • IMP_Ajax_Application_Viewport
  • IMP_Ajax_Application_Viewport_Error
  • IMP_Ajax_Imple_ImportEncryptKey
  • IMP_Ajax_Imple_ItipRequest
  • IMP_Ajax_Imple_PassphraseDialog
  • IMP_Ajax_Imple_VcardImport
  • IMP_Ajax_Queue
  • IMP_Api
  • IMP_Application
  • IMP_Auth
  • IMP_Basic_Base
  • IMP_Basic_Compose
  • IMP_Basic_Contacts
  • IMP_Basic_Error
  • IMP_Basic_Folders
  • IMP_Basic_Listinfo
  • IMP_Basic_Mailbox
  • IMP_Basic_Message
  • IMP_Basic_Pgp
  • IMP_Basic_Saveimage
  • IMP_Basic_Search
  • IMP_Basic_Searchbasic
  • IMP_Basic_Smime
  • IMP_Basic_Thread
  • IMP_Block_Newmail
  • IMP_Block_Summary
  • IMP_Compose
  • IMP_Compose_Attachment
  • IMP_Compose_Attachment_Linked_Metadata
  • IMP_Compose_Attachment_Metadata
  • IMP_Compose_Attachment_Storage
  • IMP_Compose_Attachment_Storage_AutoDetermine
  • IMP_Compose_Attachment_Storage_Temp
  • IMP_Compose_Attachment_Storage_VfsLinked
  • IMP_Compose_Exception
  • IMP_Compose_Exception_Address
  • IMP_Compose_HtmlSignature
  • IMP_Compose_Link
  • IMP_Compose_LinkedAttachment
  • IMP_Compose_Ui
  • IMP_Compose_View
  • IMP_Contacts
  • IMP_Contacts_Avatar_Addressbook
  • IMP_Contacts_Avatar_Gravatar
  • IMP_Contacts_Avatar_Unknown
  • IMP_Contacts_Flag_Host
  • IMP_Contacts_Image
  • IMP_Contents
  • IMP_Contents_InlineOutput
  • IMP_Contents_View
  • IMP_Crypt_Pgp
  • IMP_Crypt_Smime
  • IMP_Dynamic_AddressList
  • IMP_Dynamic_Base
  • IMP_Dynamic_Compose
  • IMP_Dynamic_Compose_Common
  • IMP_Dynamic_Helper_Base
  • IMP_Dynamic_Mailbox
  • IMP_Dynamic_Message
  • IMP_Exception
  • IMP_Factory_AuthImap
  • IMP_Factory_Compose
  • IMP_Factory_ComposeAtc
  • IMP_Factory_Contacts
  • IMP_Factory_Contents
  • IMP_Factory_Flags
  • IMP_Factory_Ftree
  • IMP_Factory_Identity
  • IMP_Factory_Imap
  • IMP_Factory_Mail
  • IMP_Factory_MailAutoconfig
  • IMP_Factory_Mailbox
  • IMP_Factory_MailboxCache
  • IMP_Factory_MailboxList
  • IMP_Factory_Maillog
  • IMP_Factory_MimeViewer
  • IMP_Factory_Pgp
  • IMP_Factory_PrefsSort
  • IMP_Factory_Quota
  • IMP_Factory_Search
  • IMP_Factory_Sentmail
  • IMP_Factory_Smime
  • IMP_Factory_Spam
  • IMP_Filter
  • IMP_Flag_Base
  • IMP_Flag_Imap
  • IMP_Flag_Imap_Answered
  • IMP_Flag_Imap_Deleted
  • IMP_Flag_Imap_Draft
  • IMP_Flag_Imap_Flagged
  • IMP_Flag_Imap_Forwarded
  • IMP_Flag_Imap_Junk
  • IMP_Flag_Imap_NotJunk
  • IMP_Flag_Imap_Seen
  • IMP_Flag_System_Attachment
  • IMP_Flag_System_Encrypted
  • IMP_Flag_System_HighPriority
  • IMP_Flag_System_List
  • IMP_Flag_System_LowPriority
  • IMP_Flag_System_Match_Address
  • IMP_Flag_System_Match_Flag
  • IMP_Flag_System_Match_Header
  • IMP_Flag_System_Personal
  • IMP_Flag_System_Signed
  • IMP_Flag_System_Unseen
  • IMP_Flag_User
  • IMP_Flags
  • IMP_Ftree
  • IMP_Ftree_Account
  • IMP_Ftree_Account_Imap
  • IMP_Ftree_Account_Inboxonly
  • IMP_Ftree_Account_Remote
  • IMP_Ftree_Account_Vfolder
  • IMP_Ftree_Element
  • IMP_Ftree_Eltdiff
  • IMP_Ftree_Iterator
  • IMP_Ftree_Iterator_Ancestors
  • IMP_Ftree_IteratorFilter
  • IMP_Ftree_IteratorFilter_Children
  • IMP_Ftree_IteratorFilter_Containers
  • IMP_Ftree_IteratorFilter_Expanded
  • IMP_Ftree_IteratorFilter_Invisible
  • IMP_Ftree_IteratorFilter_Mailboxes
  • IMP_Ftree_IteratorFilter_Nonimap
  • IMP_Ftree_IteratorFilter_Polled
  • IMP_Ftree_IteratorFilter_Remote
  • IMP_Ftree_IteratorFilter_Special
  • IMP_Ftree_IteratorFilter_Subscribed
  • IMP_Ftree_IteratorFilter_Vfolder
  • IMP_Ftree_Prefs
  • IMP_Ftree_Prefs_Expanded
  • IMP_Ftree_Prefs_Poll
  • IMP_Ftree_Select
  • IMP_Images
  • IMP_Imap
  • IMP_Imap_Acl
  • IMP_Imap_Cache_Wrapper
  • IMP_Imap_Config
  • IMP_Imap_Exception
  • IMP_Imap_Password
  • IMP_Imap_PermanentFlags
  • IMP_Imap_Remote
  • IMP_Indices
  • IMP_Indices_Mailbox
  • IMP_LoginTasks_SystemTask_GarbageCollection
  • IMP_LoginTasks_SystemTask_Upgrade
  • IMP_LoginTasks_SystemTask_UpgradeAuth
  • IMP_LoginTasks_Task_Autocreate
  • IMP_LoginTasks_Task_DeleteAttachmentsMonthly
  • IMP_LoginTasks_Task_DeleteSentmailMonthly
  • IMP_LoginTasks_Task_FilterOnLogin
  • IMP_LoginTasks_Task_PurgeSentmail
  • IMP_LoginTasks_Task_PurgeSpam
  • IMP_LoginTasks_Task_PurgeTrash
  • IMP_LoginTasks_Task_RecoverDraft
  • IMP_LoginTasks_Task_RenameSentmailMonthly
  • IMP_Mailbox
  • IMP_Mailbox_List
  • IMP_Mailbox_List_Pop3
  • IMP_Mailbox_List_Thread
  • IMP_Mailbox_List_Virtual
  • IMP_Mailbox_SessionCache
  • IMP_Mailbox_Ui
  • IMP_Maillog
  • IMP_Maillog_Log_Base
  • IMP_Maillog_Log_Forward
  • IMP_Maillog_Log_Mdn
  • IMP_Maillog_Log_Redirect
  • IMP_Maillog_Log_Reply
  • IMP_Maillog_Log_Replyall
  • IMP_Maillog_Log_Replylist
  • IMP_Maillog_Message
  • IMP_Maillog_Storage_Base
  • IMP_Maillog_Storage_Composite
  • IMP_Maillog_Storage_History
  • IMP_Maillog_Storage_Mdnsent
  • IMP_Maillog_Storage_Null
  • IMP_Mbox_Generate
  • IMP_Mbox_Import
  • IMP_Mbox_Size
  • IMP_Message
  • IMP_Message_Date
  • IMP_Message_Ui
  • IMP_Mime_Headers
  • IMP_Mime_Status
  • IMP_Mime_Status_RenderIssue
  • IMP_Mime_Status_RenderIssue_Display
  • IMP_Mime_Viewer_Alternative
  • IMP_Mime_Viewer_Appledouble
  • IMP_Mime_Viewer_Audio
  • IMP_Mime_Viewer_Enriched
  • IMP_Mime_Viewer_Externalbody
  • IMP_Mime_Viewer_Html
  • IMP_Mime_Viewer_Images
  • IMP_Mime_Viewer_Itip
  • IMP_Mime_Viewer_Mdn
  • IMP_Mime_Viewer_Partial
  • IMP_Mime_Viewer_Pdf
  • IMP_Mime_Viewer_Pgp
  • IMP_Mime_Viewer_Plain
  • IMP_Mime_Viewer_Related
  • IMP_Mime_Viewer_Rfc822
  • IMP_Mime_Viewer_Smil
  • IMP_Mime_Viewer_Smime
  • IMP_Mime_Viewer_Status
  • IMP_Mime_Viewer_Vcard
  • IMP_Mime_Viewer_Video
  • IMP_Mime_Viewer_Zip
  • IMP_Minimal_Base
  • IMP_Minimal_Compose
  • IMP_Minimal_Error
  • IMP_Minimal_Folders
  • IMP_Minimal_Mailbox
  • IMP_Minimal_Message
  • IMP_Minimal_Messagepart
  • IMP_Minimal_Search
  • IMP_Notification_Event_Status
  • IMP_Notification_Handler_Decorator_ImapAlerts
  • IMP_Notification_Handler_Decorator_NewmailNotify
  • IMP_Perms
  • IMP_Prefs_AttribText
  • IMP_Prefs_Identity
  • IMP_Prefs_Sort
  • IMP_Prefs_Sort_FixedDate
  • IMP_Prefs_Sort_None
  • IMP_Prefs_Sort_Sortpref
  • IMP_Prefs_Sort_Sortpref_Locked
  • IMP_Prefs_Special_Acl
  • IMP_Prefs_Special_ComposeTemplates
  • IMP_Prefs_Special_Drafts
  • IMP_Prefs_Special_Encrypt
  • IMP_Prefs_Special_Flag
  • IMP_Prefs_Special_HtmlSignature
  • IMP_Prefs_Special_ImageReplacement
  • IMP_Prefs_Special_InitialPage
  • IMP_Prefs_Special_Mailto
  • IMP_Prefs_Special_NewmailSound
  • IMP_Prefs_Special_PgpPrivateKey
  • IMP_Prefs_Special_PgpPublicKey
  • IMP_Prefs_Special_Remote
  • IMP_Prefs_Special_Searches
  • IMP_Prefs_Special_Sentmail
  • IMP_Prefs_Special_SmimePrivateKey
  • IMP_Prefs_Special_SmimePublicKey
  • IMP_Prefs_Special_Sourceselect
  • IMP_Prefs_Special_Spam
  • IMP_Prefs_Special_SpecialMboxes
  • IMP_Prefs_Special_Trash
  • IMP_Quota
  • IMP_Quota_Hook
  • IMP_Quota_Imap
  • IMP_Quota_Null
  • IMP_Quota_Ui
  • IMP_Remote
  • IMP_Remote_Account
  • IMP_Script_Package_Autocomplete
  • IMP_Script_Package_ComposeBase
  • IMP_Script_Package_DynamicBase
  • IMP_Script_Package_Editor
  • IMP_Script_Package_Imp
  • IMP_Search
  • IMP_Search_Element
  • IMP_Search_Element_Attachment
  • IMP_Search_Element_Autogenerated
  • IMP_Search_Element_Bulk
  • IMP_Search_Element_Contacts
  • IMP_Search_Element_Daterange
  • IMP_Search_Element_Flag
  • IMP_Search_Element_Header
  • IMP_Search_Element_Mailinglist
  • IMP_Search_Element_Or
  • IMP_Search_Element_Personal
  • IMP_Search_Element_Recipient
  • IMP_Search_Element_Size
  • IMP_Search_Element_Text
  • IMP_Search_Element_Within
  • IMP_Search_Filter
  • IMP_Search_Filter_Attachment
  • IMP_Search_Filter_Autogenerated
  • IMP_Search_Filter_Builtin
  • IMP_Search_Filter_Bulk
  • IMP_Search_Filter_Contacts
  • IMP_Search_Filter_Mailinglist
  • IMP_Search_Filter_Personal
  • IMP_Search_IteratorFilter
  • IMP_Search_Query
  • IMP_Search_Ui
  • IMP_Search_Vfolder
  • IMP_Search_Vfolder_Builtin
  • IMP_Search_Vfolder_Vinbox
  • IMP_Search_Vfolder_Vtrash
  • IMP_Sentmail
  • IMP_Sentmail_Mongo
  • IMP_Sentmail_Null
  • IMP_Sentmail_Sql
  • IMP_Smartmobile
  • IMP_Spam
  • IMP_Spam_Email
  • IMP_Spam_Null
  • IMP_Spam_Program
  • IMP_Test
  • IMP_Tree_Flist
  • IMP_Tree_Jquerymobile
  • IMP_Tree_Simplehtml
  • IMP_View_Subinfo

Interfaces

  • IMP_Compose_Attachment_Linked
  • IMP_Contacts_Avatar_Backend
  • IMP_Contacts_Flag_Backend
  • IMP_Spam_Base
  • Overview
  • Package
  • Class
  • Tree

Class IMP_Api

IMP external API interface.

This file defines IMP's external API interface. Other applications can interact with IMP through this API.

Horde_Registry_Api
Extended by IMP_Api
Package: IMP
Category: Horde
Copyright: 2009-2014 Horde LLC
License: GPL
Author: Michael Slusarz slusarz@horde.org
Located at Api.php
Methods summary
public Horde_Url
# compose( string|array $args = array(), array $extra = array() )

Returns a compose window link.

Returns a compose window link.

Parameters

$args
<p>List of arguments to pass to compose page. If this is passed in as a string, it will be parsed as a toaddress?subject=foo&amp;cc=ccaddress (mailto-style) string.</p>
$extra
<p>Hash of extra, non-standard arguments to pass to compose page.</p>

Returns

Horde_Url
The link to the message composition screen.
public array
# batchCompose( string|array $args = array(), array $extra = array() )

Return a list of compose window links.

Return a list of compose window links.

Parameters

$args
<p>List of arguments to pass to compose page. If this is passed in as a string, it will be parsed as a toaddress?subject=foo&amp;cc=ccaddress (mailto-style) string.</p>
$extra
<p>List of hashes of extra, non-standard arguments to pass to compose page.</p>

Returns

array

The list of Horde_Url objects with links to the message composition screen.

public array
# mailboxList( )

Returns the list of mailboxes.

Returns the list of mailboxes.

Returns

array

The list of IMAP mailboxes. A list of arrays with the following keys: - d: (string) The namespace delimiter. - label: (string) Human readable label (UTF-8). - level: (integer) The child level of this element. - ob: (Horde_Imap_Client_Mailbox) A mailbox object. - subscribed: (boolean) True if mailbox is subscribed (@since 6.2.0).

public Horde_Imap_Client_Mailbox
# createMailbox( string $mbox, array $options = array() )

Creates a new mailbox.

Creates a new mailbox.

Parameters

$mbox
The name of the mailbox to create (UTF-8).
$options
<p>Additional options: - full: (boolean) If true, $mbox is a full mailbox name. If false, $mbox will be created in the default namespace. DEFAULT: false</p>

Returns

Horde_Imap_Client_Mailbox

The mailbox name created or false on failure.

Throws

IMP_Exception
public integer|boolean
# deleteMessages( string $mailbox, array $indices )

Deletes messages from a mailbox.

Deletes messages from a mailbox.

Parameters

$mailbox
The name of the mailbox (UTF-8).
$indices
The list of UIDs to delete.

Returns

integer|boolean

The number of messages deleted if successful, false if not.

public boolean
# copyMessages( string $mailbox, array $indices, string $target )

Copies messages to a mailbox.

Copies messages to a mailbox.

Parameters

$mailbox
The name of the source mailbox (UTF-8).
$indices
The list of UIDs to copy.
$target
The name of the target mailbox (UTF-8).

Returns

boolean
True if successful, false if not.
public boolean
# moveMessages( string $mailbox, array $indices, string $target )

Moves messages to a mailbox.

Moves messages to a mailbox.

Parameters

$mailbox
The name of the source mailbox (UTF-8).
$indices
The list of UIDs to move.
$target
The name of the target mailbox (UTF-8).

Returns

boolean
True if successful, false if not.
public boolean
# flagMessages( string $mailbox, array $indices, array $flags, boolean $set )

Flag messages.

Flag messages.

Parameters

$mailbox
The name of the source mailbox (UTF-8).
$indices
The list of UIDs to flag.
$flags
The flags to set.
$set
True to set flags, false to clear flags.

Returns

boolean
True if successful, false if not.
public
# addFlags( array $flags )

Ensures a list of user-defined IMAP flag(s) for the current user exist. Silently ignores any flags that are already defined.

Ensures a list of user-defined IMAP flag(s) for the current user exist. Silently ignores any flags that are already defined.

Parameters

$flags
An array of user-defined flag names.

Since

6.3.0
public array
# searchMailbox( string $mailbox, Horde_Imap_Client_Search_Query $query )

Perform a search query on the remote IMAP server.

Perform a search query on the remote IMAP server.

Parameters

$mailbox
<p>The name of the source mailbox (UTF-8).</p>
$query
The query object.

Returns

array
The search results (UID list).
public mixed
# server( )

Returns information on the currently logged on IMAP server.

Returns information on the currently logged on IMAP server.

Returns

mixed

An array with the following entries: - hostspec: (string) The server hostname. - port: (integer) The server port. - protocol: (string) Either 'imap' or 'pop'. - secure: (string) Either 'none', 'ssl', or 'tls'.

public array
# favouriteRecipients( integer $limit, array $filter = array('new', 'forward', 'reply', 'redirect') )

Returns the list of favorite recipients.

Returns the list of favorite recipients.

Parameters

$limit
Return this number of recipients.
$filter
<p>A list of messages types that should be returned. Valid types: 'forward', 'mdn', 'new', 'reply', and 'redirect'. A value of null returns all message types.</p>

Returns

array
A list with the $limit most favourite recipients.

Throws

IMP_Exception
public
# logRecipient( string $reason, string|array $recipients, string $message_id, boolean $success = true )

Log an entry to the IMP_Sentmail system.

Log an entry to the IMP_Sentmail system.

Parameters

$reason
<p>$action The performed action. One of: - forward - mdn - new - redirect - reply</p>
$recipients
The message recipients.
$message_id
The Message-ID.
$success
Was the message successfully sent?
public Horde_Imap_Client_Base
# imapOb( )

Returns the Horde_Imap_Client object created using the IMP credentials.

Returns the Horde_Imap_Client object created using the IMP credentials.

Returns

Horde_Imap_Client_Base
The imap object.
public array
# flagList( string $mailbox = null )

Return the list of user-settable IMAP flags.

Return the list of user-settable IMAP flags.

Parameters

$mailbox
<p>If set, returns the list of flags filtered by what the mailbox allows (UTF-8).</p>

Returns

array
A list of IMP_Flag_Base objects.

Since

6.3.0
public @see
# getSpecialMailboxes( )

Return the list of special mailboxes.

Return the list of special mailboxes.

Returns

@see
IMP_Mailbox::getSpecialMailboxes()
public Horde_History_Log
# getMaillog( string $mid )

Obtain the Maillog for a given message.

Obtain the Maillog for a given message.

Parameters

$mid
The Message-ID to obtain the log for.

Returns

Horde_History_Log
The log object.

Since

6.1.0
public
# logMaillog( string $action, string $mid, string $data = null )

Log an entry in the Maillog.

Log an entry in the Maillog.

Parameters

$action
The action to log.
$mid
The Message-ID.
$data
Additional data.

Since

6.1.0
public array
# getMaillogChanges( integer $ts )

Returns a list of Message-IDs that have been added to the Maillog since the specified timestamp.

Returns a list of Message-IDs that have been added to the Maillog since the specified timestamp.

Parameters

$ts
<p>The timestamp to start searching from. Only entries after this timestamp will be returned.</p>

Returns

array
An array of Message-IDs that have been changed since $ts.

Since

6.1.0
API documentation generated by ApiGen