1
0
Fork 1
mirror of https://github.com/coddingtonbear/django-mailbox.git synced 2026-07-09 22:38:19 +02:00

Added email archiving option to IMAP transport

This commit is contained in:
Daniel 2014-05-23 09:17:14 +01:00
parent 872f4786c7
commit 0e0c6cf170
4 changed files with 49 additions and 14 deletions

View file

@ -7,24 +7,25 @@ POP3 and IMAP as well as local file-based mailboxes.
.. table:: 'Protocol' Options
============ ============== ===============================================
============ ============== ===============================================================
Mailbox Type 'Protocol':// Notes
============ ============== ===============================================
============ ============== ===============================================================
POP3 ``pop3://`` Can also specify SSL with ``pop3+ssl://``
IMAP ``imap://`` Can also specify SSL with ``imap+ssl://``
IMAP ``imap://`` Can also specify SSL and archive with ``imap+ssl://?myarchive``
Maildir ``maildir://``
Mbox ``mbox://``
Babyl ``babyl://``
MH ``mh://``
MMDF ``mmdf://``
Piped Mail *empty* See :ref:`receiving-mail-from-exim4-or-postfix`
============ ============== ===============================================
============ ============== ===============================================================
.. warning::
This will delete any messages it can find in the inbox you specify;
This will delete or move any messages it can find in the inbox you specify;
do not use an e-mail inbox that you would like to share between
applications.
applications. For the IMAP protocol you can specify an archive folder where
emails are moved to.
POP3 and IMAP Mailboxes
@ -44,11 +45,17 @@ Also, if your username or password include any non-ascii characters,
they should be URL-encoded (for example, if your username includes an
``@``, it should be changed to ``%40`` in your URI).
If you have an account named ``youremailaddress@gmail.com`` with a password
of ``1234`` on GMail, which uses a POP3 server of 'pop.gmail.com' and requires
SSL, you would enter the following as your URI::
If you are using an IMAP Mailbox, you can archive all messages before they
are deleted from the inbox. To archive emails, add the archive folder
name as a queryparemeter to the uri (for example, if your mailbox has a
folder called myarchive, add ``?myarchive`` to the uri).
pop3+ssl://youremailaddress%40gmail.com:1234@pop.gmail.com
If you have an account named ``youremailaddress@gmail.com`` with a password
of ``1234`` on GMail, which uses a IMAP server of 'imap.gmail.com', requires
SSL and you want to archive all emails, you would enter the following as
your URI::
pop3+ssl://youremailaddress%40gmail.com:1234@pop.gmail.com?[GMAIL]/All Mail
Local File-based Mailboxes