=== Plugin Name === Contributors: pkthree Donate link: http://www.theblog.ca Tags: collaboration, post, posts, admin, email, editor, author, status Requires at least: 3.0 Tested up to: 3.2 Stable tag: trunk This plugin enables automatic e-mails to the relevant users during the collaboration workflow. == Description == Enhance the "Submit for Review" feature for Contributor users. This plugin enables automatic e-mails to the relevant users at the different post status transitions: when posts are pending; when they are approved or scheduled; and when their statuses are changed from "pending" back to "draft". = Features = * When a Contributor user submits an article for review: The plugin e-mails a list of approvers of your choice, letting them know that there is a post ready for review, and giving them a link to edit the post. * When a post is approved: The original Contributor user gets an e-mail saying that their post has been approved and who it was approved by. If the post was directly published, the author is given a link to read the post as the whole world sees it. If the post is scheduled to be published, the author is informed of the time that their post will go live. When the post does go live, the author will get another e-mail informing him / her of that. * When a post's status is changed back to "draft" from "pending": The original Contributor user gets an e-mail saying that their post has been reverted back to a draft, along with a link to edit and re-submit the post. * When used with [Peter's Post Notes](http://www.theblog.ca/wordpress-post-notes "From Peter's Useful Crap"), users can leave notes to accompany the e-mails for each step in the workflow. = Translations = * es\_ES translation by Guillermo Jimeno Espinosa of http://www.webcomics.es/ * it\_IT translation by Massimo Santi * fr\_FR translation by Romain * ja translation by Kazuhiro Terada * pt\_BR translation by Murillo Ferrari * ro\_RO translation by Gabriel Berzescu * pl\_PL translation by Michal Rozmiarek * de\_DE translation by Rian Klijn of http://www.creditriskmanager.com/ * nl\_NL translation by Rene of http://wpwebshop.com * ru\_RU translation by Doktor Bro of http://doktorbro.net * tr translation by Can Kaya = Requirements = * WordPress 3.0 or higher == Installation == Unzip the peters\_collaboration\_emails folder to your WordPress plugins folder. Details about the e-mails sent (who the sender should be; whether the contributor should know who approved his/her post; and so on) are configured by editing the top of the plugin file itself. The default settings should be sufficient for most implementations. Moderator rules are configured in the Settings > Collaboration e-mails admin menu. Moderators are Administrator or Editor users who should be notified whenever a post is submitted for review. You can create groups of Contributor users and assign different moderators for each group. In other words, different users can be notified based on who wrote a post. You can also assign moderators based on various taxonomies (such as tags, categories, and more) on post, pages, and custom post types. If a Contributor user belongs to multiple groups and/or a post has multiple taxonomy values, all moderators who have been assigned to the relevant groups or who match the post type rules are e-mailed. == Troubleshooting == For version 1.4.0 and lower of the plugin, note that if you are using SMTP to send e-mails, WordPress up to and including version 2.9 has a bug in sending to multiple recipients. A fix is described at http://www.theblog.ca/wordpress-smtp == Screenshots == 1. Management page. == Frequently Asked Questions == Please visit the plugin page at http://www.theblog.ca/wordpress-collaboration-emails with any questions. == Changelog == = 1.6.2 = * 2011-09-22: Minor code edit for WordPress 3.3 compatibility. = 1.6.1 = * 2011-08-13: Minor code cleanup to remove unnecessary error notices. = 1.6.0 = * 2011-06-19: Added settings to disable any of the e-mails. = 1.5.0 = * 2010-11-27: Support for custom post types and taxonomies = 1.4.0 = * 2010-09-02: Added ability to specify contributor and moderator roles for sites with custom roles and capabilities = 1.3.5 = * 2010-04-25: E-mails are now all encoded in UTF-8 = 1.3.4 = * 2010-01-11: Plugin now removes its database tables when it is uninstalled, instead of when it is deactivated. This prevents the collaboration rules from being deleted when upgrading WordPress automatically. = 1.3.3 = * 2009-09-22: Maintenance release to remove unnecessary code calls and increase security. = 1.3.2 = * 2009-06-27: Minor fixes for translations. = 1.3.1 = * 2009-06-19: Updated for WordPress 2.8 so that the approver doesn't get an e-mail if they simply save an already pending post. = 1.3.0 = * 2009-02-16: Added e-mails at the "pending-to-future" and "future-to-publish" transitions. = 1.2.2 = * 2009-02-06: Backwards translation support for WordPress 2.5 = 1.2.1 = * 2009-01-03: Added .po and .mo files for translators. = 1.2.0 = * 2008-12-10: Added another e-mail trigger: when a pending post's status is changed back to a draft. Also added interoperability with Peter's Post Notes (for WordPress 2.7 and up; http://www.theblog.ca/wordpress-post-notes) so that users can leave descriptive notes at each step in the workflow. = 1.1.0 = * 2008-09-18: You can specify moderators per category. This update also includes several bug fixes to the management page functionality. = 1.0.1 = * 2008-08-07: Database table names no longer use a fixed prefix. They now use whatever your WordPress installation uses ("wp\_" by default). = 1.0.0 = * 2008-07-22: You can specify moderators per user. This is managed in the Settings section of the WordPress admin interface. = 0.2.0 = * 2007-11-11: You can specify a name and e-mail address for the sender of all collaboration e-mails or have the sender information default to the user performing the action. You can also toggle whether the post author should be told which user approved their post. = 0.1.0 = * 2007-10-31: You can e-mail multiple moderators when a post is submitted for review. Also, the author is e-mailed when one of their posts is approved.