Changes between Version 23 and Version 24 of WorkflowNotificationPlugin

Timestamp:

May 18, 2017, 2:01:02 PM (7 years ago)

Author:

ethan.jucovy@…

Comment:

Clarify watchful_user example, add "emailing all commenters" feature

WorkflowNotificationPlugin

@@ -137 +137 @@
 ticket_changed = *
 ticket_changed.body = View the ticket here: ${link}
-ticket_changed.recipients = watchful_user, another_watchful_user
+ticket_changed.recipients = username, another_username
 ticket_changed.subject = Ticket ${ticket.id} has changed!
 }}}
@@ -183 +183 @@
 Meanwhile, if there are any newlines whatsoever in your `.subject` configuration, the plugin will replace them with spaces. This ensures that your email will have a valid subject (email subjects cannot contain newlines).
 
+
+=== Emailing all commenters on a ticket 
+
+You can access a list of all users who have participated on a ticket (leaving
+a comment, changing a field value) as well as the actions they took with the
+variable `change_history`. This will contain a list of dicts, each with an
+"author" key, as well as "field", "oldvalue", "newvalue", and "time", ordered
+from oldest to newest.
+
+This can be used to construct a recipient list for everyone who has left a comment
+on a ticket:
+
+{{{#!ini
+[ticket-workflow-notifications]
+ticket_changed = *
+ticket_changed.recipients = ${','.join(list(set(i['author'] for i in change_history if i['author'] != 'anonymous' and i['field'] == 'comment' and i['newvalue'])))}
+}}}
+
+Or you can email everyone who has ever participated on the ticket at all:
+{{{#!ini
+[ticket-workflow-notifications]
+ticket_changed = *
+ticket_changed.recipients = ${','.join(list(set(i['author'] for i in change_history if i['author'] != 'anonymous')))}
+}}}
+
+Or you can email everyone who has ever updated a particular field on the ticket:
+
+{{{#!ini
+[ticket-workflow-notifications]
+ticket_changed = *
+ticket_changed.recipients = ${','.join(list(set(i['author'] for i in change_history if i['author'] != 'anonymous' and i['field'] == 'milestone')))}
+}}}
+
+This can also be used in the email subject, body, and condition templates.
+
 == Recent Changes