mirror/django-mailbox
1
0
Fork 1
mirror of https://github.com/coddingtonbear/django-mailbox.git synced 2026-07-10 06:48:19 +02:00
Code Activity

Update mailbox_types.rst

Browse source 
Added description for uri param ``folder`` in protocol imap
This commit is contained in:
Dmitry 2015-03-18 23:05:35 +04:00
parent 1862529f2a
commit 0c2b01bb78
1 changed files with 7 additions and 4 deletions
Download patch file Download diff file Expand all files Collapse all files

9
docs/topics/mailbox_types.rst
View file

@ -11,7 +11,7 @@ POP3 and IMAP as well as local file-based mailboxes.
Mailbox Type 'Protocol':// Notes Mailbox Type 'Protocol':// Notes
============ ================ ================================================================================================================================================================= ============ ================ =================================================================================================================================================================
POP3 ``pop3://`` Can also specify SSL with ``pop3+ssl://`` POP3 ``pop3://`` Can also specify SSL with ``pop3+ssl://``
IMAP ``imap://`` Can also specify SSL with ``imap+ssl://``, or specify a folder to save processed messages into by appending ``?archive=my_archive_folder`` to the end of the URI. IMAP ``imap://`` Can also specify SSL with ``imap+ssl://``, specify imap folder to fetch emails with uri param ``folder``, or specify archive folder to store emails after processing in uri param ``archive``. See :ref:`pop3-and-imap-mailboxes` for details.
Gmail IMAP ``gmail+ssl://`` Uses OAuth authentication for Gmail's IMAP transport. See :ref:`gmail-oauth` for details. Gmail IMAP ``gmail+ssl://`` Uses OAuth authentication for Gmail's IMAP transport. See :ref:`gmail-oauth` for details.
Maildir ``maildir://`` Maildir ``maildir://``
Mbox ``mbox://`` Mbox ``mbox://``
@ -29,6 +29,7 @@ POP3 and IMAP as well as local file-based mailboxes.
do not use an e-mail inbox that you would like to share between do not use an e-mail inbox that you would like to share between
applications. applications.
.. _pop3-and-imap-mailboxes:
POP3 and IMAP Mailboxes POP3 and IMAP Mailboxes
----------------------- -----------------------
@ -52,15 +53,17 @@ are deleted from the inbox. To archive emails, add the archive folder
name as a query paremeter to the uri. For example, if your mailbox has a name as a query paremeter to the uri. For example, if your mailbox has a
folder named ``myarchivefolder`` that you would like to copy messages to folder named ``myarchivefolder`` that you would like to copy messages to
after processing, add ``?archive=myarchivefolder`` to the end of the URI. after processing, add ``?archive=myarchivefolder`` to the end of the URI.
Also if you want to fetch new emails from imap folder other than 'INBOX' (for example, Myfolder) you
could specify another uri query parameter: ``?folder=Myfolder``.
For a verbose example, if you have an account named For a verbose example, if you have an account named
``youremailaddress@gmail.com`` with a password ``youremailaddress@gmail.com`` with a password
of ``1234`` on GMail, which uses a IMAP server of ``imap.gmail.com`` (requiring of ``1234`` on GMail, which uses a IMAP server of ``imap.gmail.com`` (requiring
SSL) and you would like to archive all processed emails SSL) and you would like to fetch new emails from folder named `Myfolder` and archive them after processing
into a folder named ``Archived``, you into a folder named ``Archived``, you
would enter the following as your URI:: would enter the following as your URI::
imap+ssl://youremailaddress%40gmail.com:1234@imap.gmail.com?archive=Archived imap+ssl://youremailaddress%40gmail.com:1234@imap.gmail.com?folder=Myfolder&archive=Archived
.. _gmail-oauth: .. _gmail-oauth: