Metadata-Version: 1.1
Name: collective.contentrules.mailtorole
Version: 1.6
Summary: Send e-mail to users having a role on the object
Home-page: http://plone.org/products/collective.contentrules.mailtorole
Author: Zest Software (Fred van Dijk)
Author-email: info@zestsoftware.nl
License: GPL
Description: Introduction
        ============
        
        Using content rules (available since Plone 3) it's very easy to register for
        certain events and perform actions upon occurrence. One of these actions
        provided by Plone is a mail action. 
        
        A limitation in the supplied mail action is that one can only provide fixed
        email addresses. But sometimes you'd like to send an email to a user having a
        certain role on the object that was involved in triggering the content rule.
        
        An examplary use case and reason for creation of this package is the reviewer 
        role. If an object in a certain location of the site is submitted for
        publication, you would like to inform the user that has the 'reviewer' role
        on this area of the site that a new document/object is available for review.
        
        Before contentrules was available in Plone the place to add this functionality
        was to to create a python script and attach it to the workflow 'submit' 
        transition that was used for the objects.
        
        .. Note::
           This product supercedes collective.contentrules.mailtolocalrole_. 
           Extending that product's functionality with sending mail to global roles
           made it logical to rename the package. 
        
        Installation
        ============
        
        Add collective.contentrules.mailtorole to your buildout as an egg or
        from source. No (generic setup) installation is necessary.
        
        Usage
        =====
        
        Go to the Plone Control Panel, select Content Rules and add a new Rule. 
        Under 'actions' you now have a new option: Send email to users with role.
        
        The checkboxes "Acquire roles" and "Global roles" are worth noting:
        
        - If both are unchecked, mail will only be sent to members having a local role 
          on the object.
        
        - Checking "Acquire roles" will also send mail to users that have acquired the
          specified role from a parent of the object, ie. from higher up in the site.
        
        - Checking "Global roles" will also send mail to users that have the specified
          role globally, that is in the entire site.
        
        Credits
        =======
        
        Most of this package has been directly copied from the plone.app.contentrules
        mail action. Additions have been made to check for directly assigned local
        roles, acquired roles, global roles, fetching the e-mail To addresses from the
        user objects, modification of the control panel action, translations and tests.
         
        .. _collective.contentrules.mailtolocalrole: http://plone.org/products/collective-contentrules-mailtolocalrole/
        
        Changes
        =======
        
        1.6 (2013-02-14)
        ----------------
        
        - Updated message and title to stringinterpolation, like in plone.app.contentrules
        
        
        1.5 (2012-10-18)
        ----------------
        
        - Moved to
          https://github.com/collective/collective.contentrules.mailtorole
          [maurits]
        
        
        1.4 (2012-01-23)
        ----------------
        
        - Fix Plone3 compatibility [toutpt]
        - Add french translation [toutpt]
        
        
        1.3 (2011-12-23)
        ----------------
        
        - Check if member exists before getting mailaddress [gborelli]
        
        
        1.3a1 (2011-10-28)
        ------------------
        
        - Add checkbox for including members with global roles in mail (fixes
          http://plone.org/products/collective-contentrules-mailtolocalrole/issues/4)
          [khink]
        - Rename to `collective.contentrules.mailtorole`
        
        .. Note::
           Prior to version 1.3, the product was called
           `collective.contentrules.mailtolocalrole`.
           That product's history is included below for completeness.
        
        1.2 (2011-10-28)
        ----------------
        
        - use z3c.autoinclude plugin
        - Plone 4.1 compatibility (fixes
          http://plone.org/products/collective-contentrules-mailtolocalrole/issues/5)
          [khink]
        
        
        1.1 (2011-01-07)
        ----------------
        
        - Fix the email from header that is generated from the portal owner if no from
          address is specified. Backported from plone.app.contentrules 4.0.2
          [fredvd]
        
        - Add subgroups support. If a group contains a subgroup that has members,
          these members will also be checked for having the local role.
          [lzdych]
        
        
        1.0 (2010-12-04)
        ----------------
        
        - Fixed error when used on Plone 4: passing 'From' to secureSend is
          not needed in Plone 3 and breaks in Plone 4.
          [maurits]
        
        
        0.7 (2008-12-05 Sinterklaas)
        ----------------------------
        
        - Added Italian localization [paulox]
        
        - Added Owner to role's vocabulary [paulox]
        
        - Add check for empty user email address [fredvd]
        
        - If the localrole is added to a group, add all members of that group to
          the recipients list [Craig Swank]
        
        
        0.6 (2008-10-02)
        ----------------
        
        - Fixed and added tests [fredvd]
        
        - Updated locales [fredvd]
        
        
        0.5 unreleased
        --------------
        
        - Add locales [fredvd]
        
        - Fix acquired roles checking & look up email addresses [fredvd]
        
        - Add checking for acquired roles [fredvd]
        
        - Import basic version from a client project [fredvd]
        
Keywords: plone contentrules action mail
Platform: UNKNOWN
Classifier: Framework :: Plone
Classifier: Framework :: Plone :: 3.2
Classifier: Framework :: Plone :: 3.3
Classifier: Framework :: Plone :: 4.0
Classifier: Framework :: Plone :: 4.1
Classifier: Framework :: Plone :: 4.2
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development :: Libraries :: Python Modules
