[[PageOutline(2-5,Contents,pullout)]] = Toggle sending Announcer emails = == Description == This plugin provides a link (in the contextual nav) to toggle on and off sending emails for your ticket changes. The purpose is to reduce superfluous emails for changes the author deems unworthy. [[Image(quiet.png)]] This plugin is dependent upon the [wiki:AnnouncerPlugin Announcer plugin] (which must already be installed) and Javascript. The toggling is handled via ajax so you can remain on the same page and not disrupt any current work. The toggle link will appear on {{{/newticket}}}, {{{/ticket}}}, {{{/query}}}, and {{{/report}}} pages since ticket changes are possible on all of these (e.g., via [wiki:BatchModifyPlugin BatchModify] or [wiki:GridModifyPlugin GridModify]). == Configuration == 1. Install the plugin (after downloading and unzipping): {{{ cd quietplugin/0.12 sudo python setup.py install }}} See [http://trac.edgewall.org/wiki/TracPlugins TracPlugins] for more installation details and options. You'll likely need to restart Trac's web server after installation. 2. Enable the plugin ''and'' '''disable''' {{{announcer.distributors.mail.EmailDistributor}}} in {{{trac.ini}}}: {{{ [components] announcer.* = enabled announcer.distributors.mail.EmailDistributor = disabled quiet.* = enabled }}} You can alternatively use the Trac Web Admin GUI. The above is because the quietplugin provides its own email distributor which effectively wraps the announcer's !EmailDistributor with an extra check to see if the user entered quiet mode or not. 3. (Optional) Customize the quiet mode labels: {{{ [quiet] enter_label = Enter Quiet Mode leave_label = Leave Quiet Mode }}} 4. Add the {{{QUIET_MODE}}} permission to users or groups as appropriate on the Admin > Permissions page. == Bugs/Feature Requests == Existing bugs and feature requests for QuietPlugin are [report:9?COMPONENT=QuietPlugin here]. If you have any issues, create a [http://trac-hacks.org/newticket?component=QuietPlugin&owner=robguttman new ticket]. == Download == Download the zipped source from [download:quietplugin here]. == Source == You can check out QuietPlugin from [http://trac-hacks.org/svn/quietplugin here] using Subversion, or [source:quietplugin browse the source] with Trac. == Examples == * During planning, I can now avoid barraging people with emails when I move large batches of tickets from one milestone to another using [wiki:BatchModifyPlugin BatchModify]. * 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. == Recent Changes == [[ChangeLog(quietplugin, 3)]] == Author/Contributors == '''Author:''' [wiki:robguttman] [[BR]] '''Maintainer:''' [wiki:robguttman] [[BR]] '''Contributors:'''