Changes between Version 9 and Version 10 of QuietPlugin

Timestamp:

Dec 16, 2011, 10:38:58 PM (12 years ago)

Author:

Rob Guttman

Comment:

--

QuietPlugin

@@ -37 +37 @@
     }}}
 
+ There are a few additional optional configurations - see below.
+
  4. Add the {{{QUIET_MODE}}} permission to users or groups as appropriate on the Admin > Permissions page.
 
@@ -61 +63 @@
  * I want to make a minor fix to a ticket's description that doesn't call for yet another email to be sent - enter quiet mode!
  * I'm triaging many tickets in a [wiki:QueuesPlugin Queue report] with new positions using [wiki:GridModifyPlugin GridModify] and I don't want an email sent for each change.
+ * I'm managing dependencies using the [wiki:AnalyzePlugin Analyze plugin] and don't want to inundate the team with emails of its fixes.
+
+=== Trigger quiet mode ===
+To help you remember to enter quiet mode for the above use cases (or similar ones), you can create trigger rules on DOM elements that will prompt you to enter or leave quiet mode (if you're not already in that state):
+{{{
+[quiet]
+1.selector = #analyzebutton
+1.action = enter
+
+2.selector = #batchmod_submit
+2.action = enter
+2.submit = true
+
+3.selector = #propertyform[action*=ticket] .buttons input[name=submit]
+3.action = leave
+3.only_if = #comment:first=.+
+3.submit = true
+}}}
+
+The above example defines three trigger rules explained as follows:
+ 1. When the "Analyze.." button is clicked, prompt to enter quiet mode.
+ 1. When the "Batch Modify" button is clicked, prompt to enter quiet mode (and prevent the submission - but then they can submit again).
+ 1. When the "Batch Modify" button is clicked ''and'' there's some text in the comment field, then prompt to enter quiet mode (and prevent the submission - but then they can submit again).
+
+The {{{only_if}}} option can either be just a CSS selector or also include an expected regex value (e.g., the {{{=.+}}} above).  If just a selector, then the selector must exist.  If also an expected rege value, then the selected item's jQuery {{{val()}}} must match the expected value.
 
 == Recent Changes ==