{ "info": { "author": "4teamwork AG", "author_email": "mailto:info@4teamwork.ch", "bugtrack_url": null, "classifiers": [ "Framework :: Plone", "Framework :: Plone :: 4.3", "Intended Audience :: Developers", "Topic :: Software Development :: Libraries :: Python Modules" ], "description": "Introduction\n============\n\n``ftw.mail`` provides a dexterity based mail contenttype which allows you to\nupload emails to your Plone site.\nThis includes extracting of important data of the email, like:\n\n- Attachments\n- Mail header\n- Body text\n- Unwrap attached emails (msg).\n\n\nMail-Inbound functionality\n==========================\n\nThe major feature of ``ftw.mail`` is the inbound mail functionality.\nMail inbound allows you to send emails directly to your Plone site.\nAn email sent to Plone will be extracted and created as mail contenttype\nautomatically.\n\n**Security**\n\n1. There must be a registered user with the sender email address\n2. The user must have enough permissions to add a mail object in the folder\n3. The email will be created with the security context of the sender\n\n**What is the email address?**\n\nThe localpart of the email address is a unique identifier that\nidentifies the respective folderish object. The default implementations\nuses the object's UUID. The mail-in address will automatically shown in a\nviewlet if `ftw.mail.mail` content type is addable.\n\n\nInstalling\n==========\n\n- Add ``ftw.mail`` to your buildout configuration:\n\n::\n\n [instance]\n eggs +=\n ftw.mail\n\n- Install the generic setup import profile.\n\n\n**Enable Mail-Inbound Feature**\n\nInstall the `mta2plone.py `_\nscript somewhere in the PATH of your server.\nMake sure mta2plone.py is executable (`chmod +x mta2plone.py`).\n\nExample Postfix configuration in `/etc/postfix/virtual`::\n\n inbound.example.org anything\n @inbound.example.org inbound-example\n\n\nExample `/etc/aliases`::\n\n inbound-example: \"|/path/to/mta2plone.py http://127.0.0.1:8080/Plone/mail-inbound\"\n\n\nRemember to run the ``newaliases`` command (as root) after you update /etc/aliases in order for Postfix to pick up the changes.\n\n\nFor local testing it is also possible to start the `mta2plone.py`\nin a console and paste the raw mail to `STDIN`:\n\n.. code:: bash\n\n ./mta2plone.py http://127.0.0.1:8080/Plone/mail-inbound recipient-email\n\n(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.)\n\n\nCompatibility\n-------------\n\nRuns with `Plone `_ `4.3`.\n\n\nLinks\n=====\n\n- Github: https://github.com/4teamwork/ftw.mail\n- Issues: https://github.com/4teamwork/ftw.mail/issues\n- Pypi: http://pypi.python.org/pypi/ftw.mail\n- Continuous integration: https://jenkins.4teamwork.ch/search?q=ftw.mail\n\n\nCopyright\n=========\n\nThis package is copyright by `4teamwork `_.\n\n``ftw.mail`` is licensed under GNU General Public License, version 2.\n\nChangelog\n=========\n\n\n2.6.1 (2019-07-08)\n------------------\n\n- Fix upgrade when uninitialized header chaches are present. [deiferni]\n\n\n2.6.0 (2019-03-22)\n------------------\n\n- Drop support for Plone 4.2. [lgraf]\n- Log common errors in inbound mail view. [lgraf]\n\n\n2.5.5 (2018-09-21)\n------------------\n\n- Recurse the sizes of nested multipart attachments. [Rotonen]\n\n\n2.5.4 (2017-11-24)\n------------------\n\n- Fix treatment of invalid mail dates [njohner]\n\n\n2.5.3 (2017-11-23)\n------------------\n\n- Fix sorting on dates for E-mails [njohner]\n\n\n2.5.2 (2017-07-11)\n------------------\n\n- Cleanup: Revert LWSP regex and move changes from v2.5.1 into\n a separate regex since they solve different issues.\n\n\n2.5.1 (2017-05-23)\n------------------\n\n- Remove newlines from headers, even inside encoded words.\n decode_header from the email module splits the header before parsing\n which breaks up encoded words and prevents them from being decoded.\n https://github.com/python/cpython/blob/2.7/Lib/email/header.py#L78\n [lknoepfel]\n\n\n2.5.0 (2017-05-22)\n------------------\n\n- Move functionality to create mailed-in mails to an adapter to allow\n easier customization. [deiferni]\n\n\n2.4.1 (2017-05-22)\n------------------\n\n- Fix setting defaults for choices with named vocabularies on inbound mails.\n [phgross]\n\n\n2.4.0 (2016-07-19)\n------------------\n\n- Mark inbound request with a marker interface.\n [phgross]\n\n- Drop Plone 4.1 support.\n [phgross]\n\n- Fix German and French FTI title of \"ftw.mail.mail\".\n [mbaechtold]\n\n\n2.3.7 (2015-09-08)\n------------------\n\n- Fix broken tags in text/html MIME parts.\n [lgraf]\n\n\n2.3.6 (2015-09-02)\n------------------\n\n- Sort Mailtab so the newest Mail is the first Item.\n [tschanzt]\n\n\n2.3.5 (2015-08-20)\n------------------\n\n- Make upgrade step to fix `message.contentType` more defensive to avoid\n trouble during upgrades caused by caching weirdness.\n [lgraf]\n\n\n2.3.4 (2015-08-19)\n------------------\n\n- Make sure message.contentType is stored as `str`, not `unicode`. Otherwise\n this will result in \"Wrong contained type\" when trying to save the object\n again. Includes Upgrade-Step to fix existing objects.\n [lgraf]\n\n\n2.3.3 (2015-08-03)\n------------------\n\n- get_header(): Fix up RFC 2047 encoded words separated by 'CRLF LWSP'\n (which is fine according to the RFC) by replacing the CRLF with a\n SPACE so decode_header can parse them correctly.\n This works around a bug in decode_header that has been fixed in 3.3.\n See http://bugs.python.org/issue4491 and its duplicate.\n [lgraf]\n\n\n2.3.2 (2015-06-30)\n------------------\n\n- Make RegEx for Apple Partial Encoding regex more specific so we don't\n accidentally remove quotes around header parts that need them.\n [lgraf]\n\n- Added test for zip export.\n [lknoepfel]\n\n\n2.3.1 (2015-03-12)\n------------------\n\n- Refactor mail view to include all HTML parts.\n [jone]\n\n\n2.3.0 (2015-03-02)\n------------------\n\n- Enable referencablebehavior for mails.\n [jone]\n\n\n2.2.3 (2014-10-24)\n------------------\n\n- Parse