Metadata-Version: 1.0
Name: ftw.mail
Version: 2.2.0
Summary: Provides a mail content type and a mail-in behavior
Home-page: https://github.com/4teamwork/ftw.mail
Author: 4teamwork GmbH
Author-email: mailto:info@4teamwork.ch
License: GPL2
Description: Introduction
        ============
        
        ``ftw.mail`` provides a dexterity based mail contenttype which allows you to
        upload emails to your Plone site.
        This includes extracting of important data of the email, like:
        
        - Attachments
        - Mail header
        - Body text
        - Unwrap attached emails (msg).
        
        
        Mail-Inbound functionality
        ==========================
        
        The major feature of ``ftw.mail`` is the inbound mail functionality.
        Mail inbound allows you to send emails directly to your Plone site.
        An email sent to Plone will be extracted and created as mail contenttype
        automatically.
        
        **Security**
        
        1. There must be a registered user with the sender email address
        2. The user must have enough permissions to add a mail object in the folder
        3. The email will be created with the security context of the sender
        
        **What is the email address?**
        
        The localpart of the email address is a unique identifier that
        identifies the respective folderish object. The default implementations
        uses the object's UUID. The mail-in address will automatically shown in a
        viewlet if `ftw.mail.mail` content type is addable.
        
        
        Installing
        ==========
        
        - Add ``ftw.mail`` to your buildout configuration:
        
        ::
        
            [instance]
            eggs +=
                ftw.mail
        
        - Install the generic setup import profile.
        
        
        **Enable Mail-Inbound Feature**
        
        Install the `mta2plone.py <https://github.com/4teamwork/ftw.mail/blob/master/ftw/mail/mta2plone.py>`_
        script somewhere in the PATH of your server.
        Make sure mta2plone.py is executable (`chmod +x mta2plone.py`).
        
        Example Postfix configuration in `/etc/postfix/virtual`::
        
            inbound.example.org anything
            @inbound.example.org inbound-example
        
        
        Example `/etc/aliases`::
        
            inbound-example: "|/path/to/mta2plone.py http://127.0.0.1:8080/Plone/mail-inbound"
        
        
        Remember to run the ``newaliases`` command (as root) after you update /etc/aliases in order for Postfix to pick up the changes.
        
        
        For local testing it is also possible to start the `mta2plone.py`
        in a console and paste the raw mail to `STDIN`:
        
        .. code:: bash
        
            ./mta2plone.py http://127.0.0.1:8080/Plone/mail-inbound recipient-email
        
        (Since the `mta2plone.py` script will read from STDIN, you'll need to send an EOF using CTRL-D after you pases the mail contents.)
        
        
        Compatibility
        -------------
        
        Runs with `Plone <http://www.plone.org/>`_ `4.1`, `4.2` or `4.3`.
        
        
        Links
        =====
        
        - Main github project repository: https://github.com/4teamwork/ftw.mail
        - Issue tracker: https://github.com/4teamwork/ftw.mail/issues
        - Package on pypi: http://pypi.python.org/pypi/ftw.mail
        - Continuous integration: https://jenkins.4teamwork.ch/search?q=ftw.mail
        
        
        Copyright
        =========
        
        This package is copyright by `4teamwork <http://www.4teamwork.ch/>`_.
        
        ``ftw.mail`` is licensed under GNU General Public License, version 2.
        
        Changelog
        =========
        
        
        2.2.0 (2014-05-28)
        ------------------
        
        - Performance improvements:
        
          - Store the title from the mail subject on the object, so that
            we don't have to read the message for retreiving the title on access.
          - Cache attachment infos on mail object.
          - Cache headers for tabbed view.
        
          [jone]
        
        - Make sure only a *default* value will be set for IMailSettings.mail_domain,
          but an existing value won't be overwritten when running the upgrade step twice.
          [lgraf]
        
        
        2.1.1 (2014-05-12)
        ------------------
        
        - Fix From-/To-/Cc-Header encoding problem with Apple Mail.
          [jone]
        
        - Made primary field also for dexterity-1 installations working.
          [phgross]
        
        - Added French translation by I. Anthenien.
          [lknoepfel]
        
        2.1.0 (2014-03-28)
        ------------------
        
        - Remove "validate_sender" configuration setting.
          We always require the sender to be valid.
          [jone]
        
        - Refactor inbound view so that customization and error-handling
          is easier possible.
          [jone]
        
        - Improve searchable text to index attachments recursively.
          [jone]
        
        - Added registry entry 'mail_domain' in upgrade step to 2000.
          [lknoepfel]
        
        - Fix tests for Plone 4.1.x - 4.2.x by using a compatible ftw.workspace
          version.
          [mathias.leimgruber]
        
        
        2.0 (2013-10-21)
        ----------------
        
        - Make mail tab date parsing robust.
          [jone]
        
        - Disable sorting in mail tab for header information columns.
          Sorting header informations does currently not work because
          the information is not in the catalog.
          When doing it outside the catalog we could run into performance
          issues when we have many mails, therefore we disable it for now.
          [jone]
        
        - Use plone default classes for table styling.
          [Julian Infanger]
        
        - Fixed response content-type in inbound view.
          [lknoepfel]
        
        - Revoke "ftw.mail: Add Mail" permission.
          This permission makes the "mail" type show up in the add menu.
          Only admins (Manager) should be able to add new mails through the
          add menu, the normal use case is sending the mails via inbound.
          Also change the lawgiver hint to ingnore this permission.
          [jone]
        
        - Add ftw.lawgiver support.
          [mathias.leimgruber]
        
        - Add mail tab for ftw.workspace.
          [mathias.leimgruber]
        
        - Implement mail-in as viewlet.
          [mathias.leimgruber]
        
        - Add readme.
          [mathias.leimgruber]
        
        - Add IEmailAddress adapter, so it's easy to change the behavior of generating
          the email address of a destination and getting the destination of a given
          email address.(Dropped the destination resolver)
          [mathias.leimgruber]
        
        - Add uuid support and drop intid.
          [mathias.leimgruber]
        
        - Use view.pt for mail content type's default view.
          [mathias.leimgruber]
        
        - Ungrock the package.
          [mathias.leimgruber]
        
        - Fix test setup for plone 4.3 and intid.
          [mathias.leimgruber]
        
        - Add plone 4.3.x tests cfg and development.cfg.
          [mathias.leimgruber]
        
        
        1.0.4 (2012-09-12)
        ------------------
        
        - Set default values on all fields in the inbound mail creation.
          Issue #222 Metadaten Standort und Sprache
          https://extranet.4teamwork.ch/support/ph-vs/tracker/222/
          [philippegross]
        
        
        1.0.3 (2012-06-18)
        ------------------
        
        - Fixed BeautifulSoup related encoding bug when unwrapping html body.
          [lgraf]
        
        - Fix filename encoding handling.
          [jone]
        
        
        1.0.2 (2012-03-28)
        ------------------
        
        - Inbound mail: Get recipient from env variable set by MTA, not from To header.
          This allows for mails with multiple recipients in the To header, and the
          Plone destination address doesn't need to be listed first anymore.
          Issue #1312 Fehler E-Mail mit mehreren Adressaten
          https://extranet.4teamwork.ch/projects/opengever-kanton-zug/sprint-backlog/1312/
          [lgraf]
        
        - Make intids work in tests (register IIntIds utility explicitely)
          [lgraf]
        
        
        1.0.1 (2012-02-24)
        ------------------
        
        - Added some French translations
          [ttschanz]
        
        1.0 (2011-11-17)
        ----------------
        
        - Fixed msg getter, it works now also with mails without a subject.
          [phgross]
        
        
        1.0a11 (2011-10-04)
        -------------------
        
        - Fixing long subject headers separated by \n\t before creating email.message
          object.
          [lgraf]
        
        - Added test to test mail creation with weird characters in subject.
          [lgraf]
        
        - Normalizing subject before using it as an ID to create a mail object.
          [lgraf]
        
        - Changed default encoding to 'utf-8' for the safe_utf8 method.
          Should fix decoding problem in mail subjects.
          Issue #1209 Falsche Umlaute bei importierten Mails
          https://extranet.4teamwork.ch/projects/opengever-kanton-zug/sprint-backlog/1209
          [phgross]
        
        1.0a10 (2011-09-27)
        -------------------
        
        - changed fallback encoding in the get_payload method for msg objects
          without a correct charset information. So we could fix display errors in mails
          with non-ascii characters in the mail body.
          [phgross]
        
        - changed deprecated grok.CodeView to grok.View
          [eschmutz]
        
        - added test-buildout for plone 4.1
          [eschmutz]
        
        
        1.0a9 (2011-08-24)
        ------------------
        
        - Fix tests
          [eschmutz]
        
        - Implements Blob support, use now NamedBlobFiles instead of NamedFiles
          [phgross]
        
        - Issue #1134 Test Gelb 2.0.3: Nicht korrekte Dateiendung beim Extrahieren eines Dokuments mit Umlaut aus Mail
          https://extranet.4teamwork.ch/projects/opengever-kanton-zug/sprint-backlog/1134/
          added fallback in the get_filename method for allready decoded filenames tuple
          [phgross]
        
        
        1.0a8
        -----
        
        - Fixed message value creation: filename must be in unicode, that it
          works with the new plone.namedfile 1.0.3
          [phgross]
        
        - Added dummy setter for `title` property so it doesn't fail with an AttributeError
          when trying to set the title of a ftw.mail.mail object.
          [lgraf]
        
        - Added missing dependency on collective.dexteritytextindexer in setup.py
          [lgraf]
        
        - Pinned zope.component=3.8.0 in test-plone-4.0.x.cfg to resolve version conflict
          [lgraf]
        
        
        1.0a7
        -----
        
        - Added DynamicTextIndexExtender to add message body to searchableText
          [lgraf]
        
        
        1.0a6
        -----
        
        - Changed minor typo in German translation.
          [phabegger]
        
        
        1.0a5
        -----
        
        - According to rfc 2047, multiple encoded words are seperated by space: fixed tests.
          [jbaumann]
        
        - Created safe_decode_header util function, which handles the encoding
          properly for get_filenames according to rfc 2047.
          This solves a test issue.
          [jbaumann]
        
        - Added support for nested multipart emails where the attachment is within another part
          of the message.
          [jbaumann]
        
        
        1.0a4
        -----
        
        
        1.0a3
        -----
        
        - Removed `save_attachments`: moved to `opengever.mail` since its opengever specific
          [02.11.2010, jbaumann]
        
        - Added `remove_attachments` method
          [01.11.2010, jbaumann]
        
        - Added test for filename encoding problem. Test still fails...
          [Thomas Buchberger]
        
        - Moved unwrapping of attached messages into utility method. Added test.
          [Thomas Buchberger]
        
        - Correctly restore current SecurityManger after mail creation.
          [Thomas Buchberger]
        
        - Added tests for unknown sender
          [Thomas Buchberger]
        
        
        1.0a2
        -----
        
        
        1.0
        ---
        
        - Initial release
        
Platform: UNKNOWN
Classifier: Framework :: Plone
Classifier: Framework :: Plone :: 4.1
Classifier: Framework :: Plone :: 4.2
Classifier: Framework :: Plone :: 4.3
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
