Metadata-Version: 1.0
Name: poi.receivemail
Version: 1.3
Summary: Receive email in the Poi issue tracker
Home-page: http://svn.plone.org/svn/collective/poi.receivemail
Author: Maurits van Rees
Author-email: maurits@vanrees.org
License: GPL
Description: Introduction
        ============
        
        This package defines a browser view ``@@poimail`` that reads an email
        from the request and creates an issue for that or adds a response to
        an issue.  It is a bridge between smtp2zope_ and `Products.Poi`_.
        
        .. _smtp2zope: http://pypi.python.org/pypi/smtp2zope
        .. _`Products.Poi`: http://pypi.python.org/pypi/Products.Poi
        
        
        Compatibility
        -------------
        
        This has been tested with Plone 3.3.5 and Products.Poi 1.2.11.  Should
        work fine with Plone 4.x and Poi 2.x as well.
        
        
        Usage
        -----
        
        A standard setup would look like this:
        
        - You have a Plone Site at http://example.org/.
        
        - This Plone Site has ``Products.Poi`` and ``poi.receivemail`` in its
        eggs.
        
        - The site has a Poi tracker at http://example.org/tracker.
        
        - You have installed ``smtp2zope`` on the same machine (possibly in
        the same buildout, but a virtualenv is fine too) and its script is
        available at ``/path/to/smtp2zope``.
        
        - You have a mail server on this machine that has an alias like this::
        
        helpdesk@example.org "|/path/to/smtp2zope http://example.org/tracker/@@poimail"
        
        or this::
        
        helpdesk@example.org "|/path/to/smtp2zope http://admin:secret@example.org/tracker/@@poimail 1000000"
        
        - Now when someone sends an email to helpdesk@example.org a new issue
        is created in the tracker.  When the subject of the email matches an
        existing issue, it is added as response to that issue.
        
        - When a user is found in the Plone Site that matches the sender
        address, we pretend to be that user when creating the issue or
        response.  Otherwise, the Creator is anonymous or is the user that
        is identified through basic authentication in the url that is passed
        as argument to ``smtp2zope``.
        
        Changelog
        =========
        
        1.3 (2011-05-11)
        ----------------
        
        - Added FAKE_MANAGER option (default is True) to determine if we
        should fake a Manager role to be sure that a post succeeds.
        [maurits]
        
        - While switching users: if 'email' is not in the properties (say:
        ldap), we can get far too many results; so we do a double check.
        [maurits]
        
        
        1.2 (2011-05-09)
        ----------------
        
        - Ignore mails with the email_from_address as From address, as this
        too easily means that a message sent by Poi ends up being added as a
        reply on an issue that we have just created.
        [maurits]
        
        
        1.1 (2011-05-05)
        ----------------
        
        - Handle encoded subject lines better.
        [maurits]
        
        
        1.0 (2011-05-05)
        ----------------
        
        - Initial release
        
Platform: UNKNOWN
Classifier: Framework :: Plone
Classifier: Programming Language :: Python
