collective.contentrules.mailtolocalrole
An action for the contentrules framework to send email to users having a local role on the object that triggered the rule.
Current release
No stable release available yet.
Experimental releases
Upcoming and alpha/beta/candidate releases
- Alpha releases should only be used for testing and development.
- Beta releases and Release Candidates are normally released for production testing, but should not be used on mission-critical sites.
- Always install on a separate test server first, and make sure you have proper backups before installing.
Project Description
Using content rules in Plone 3 it's very easy to register for certain events and perform actions upon occurrence. One of these actions provided by Plone 3 is a mail action.
A limitation in the default mail action is that one can only provide a fixed number of 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 obvious use case and motivation for creation of this package is the reviewer role. If an object in a certain location of the site is created, 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 you would have had to create a python script and attach it to the workflow of the content types involved.
This package adds a new action 'Send email to users with local role' in the content rules editing page. You can select a local role available in the site and select if acquired roles should also be considered'. The e-mail address is taken from the user in the site.
Current Status
Beta: the action is in production use at a customer in a different package, this is the stand alone version. It works in testing, tests pass. Feedback is welcome!
Installation
Add collective.contentrules.mailtolocalrole to your buildout as an egg or from source. No (Generic Setup) site installation is necessary, the action is registered using ZCML. So do add the package to the zcml slug list of your [instance] section.
Author
Fred van Dijk at Zest Software.
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, fetching the e-mail To addresses from the user objects, modification of the control panel action, translations and tests.
