[[TOC]] = Batch modification of tickets = == Description == Allows users to modify several tickets together in one shot. == Bugs/Feature Requests == Existing bugs and feature requests for BatchModifyPlugin are [query:status!=closed&component=BatchModifyPlugin&order=priority here]. When submitting a new bug report, including the following will greatly increase the odds of your bug getting fixed: * Browser version * Browser plugins * Trac version * Trac plugins * Any stack trace you received. If you have any issues, create a [/newticket?component=BatchModifyPlugin&owner=CuriousCurmudgeon new ticket]. == Roadmap == There is a proposal page on the official Trac wiki for incorporating batch modification functionality into Trac. Feel free to contribute at trac:wiki:TracDev/Proposals/BatchModification. === Breaking Changes === * [9374] changed the default list connector string from a comma to a space. This was needed to resolve #7384. Some users wished to use a space as their connector, but Trac would not allow them to do this through configuration. This change is currently only on the trunk, but will be included in the next release. === Future Releases === * '''0.9:''' Custom workflow integration. See #7709 ---- == Download == ||Trac||Python||Version||Date|| ||0.12||2.6||[http://trac-hacks.org/browser/batchmodifyplugin/0.12/tags/BatchModify-0.8.0_trac0.12-py2.6.egg 0.8.0]||10-28-2010|| ||0.11||2.6||[http://trac-hacks.org/browser/batchmodifyplugin/0.11/tags/BatchModify-0.8.0_trac0.11-py2.6.egg 0.8.0]||10-28-2010|| ||0.12||2.5||[http://trac-hacks.org/browser/batchmodifyplugin/0.12/tags/BatchModify-0.8.0_trac0.12-py2.5.egg 0.8.0]||10-28-2010|| ||0.11||2.5||[http://trac-hacks.org/browser/batchmodifyplugin/0.11/tags/BatchModify-0.8.0_trac0.11-py2.5.egg 0.8.0]||10-28-2010|| Please see the [http://trac-hacks.org/browser/batchmodifyplugin/CHANGELOG CHANGELOG] for details on each release. Older releases can be found in the tags directory for Trac versions [http://trac-hacks.org/browser/batchmodifyplugin/0.11/tags 0.11] and [http://trac-hacks.org/browser/batchmodifyplugin/0.12/tags 0.12]. Download the zipped trunk from [download:batchmodifyplugin here]. == Install == Simply drop the egg in the plugins directory and enable through the admin UI. There is also an [http://people.debian.org/~jps/lenny unofficial Debian package] for Trac 0.11. == Configuration == Batch modification of tickets requires the TICKET_BATCH_MODIFY permission. If a user does not have this permission, the plugin behaves like the default "Custom Query" module. {{{ permission add ashwin_phatak TICKET_BATCH_MODIFY }}} === Options === You can set the following options in Trac.ini under [batchmod]. (default in parentheses) * '''fields_as_list''' (keywords): Sets the fields that will be treated as a list of items. * '''list_separator_regex''' ([,\s]+): The regex that defines the separator between items in a field that is treated as a list. By default they are separated by any whitespace character or a comma. * '''list_connector_string''' (,): The character that is used as the separator between items in a list after processing. For example, by default if you enter the keywords "foo bar", they will be added to the ticket as "foo, bar". Notice the comma instead of the space. ---- == Usage == * To modify a set a tickets just check the box next to each ticket in your query results you wish to modify. Then select each field you want to change in the batch modify section underneath the query results. * To add keywords simply include them in the modifications, separated by any whitespace character or comma be default. You can change this separator in trac.ini. If a keyword already exists on a ticket it will not be duplicated. * To remove keywords simply prefix them with "-". For example, to remove the "foo" keyword from all selected tickets, you would put "-foo" in the keywords field. ('''Note: This feature is currently not released. If you need it, please build from the trunk.''') == FAQ == '''Q:''' Checkboxes don't appear next to tickets for me! [[BR]] '''A:''' There was a bug with Trac prior to 0.11.6 that prevented the checkboxes from being added. Some people also have path problems that prevent JQuery from being loaded. See #6466 for details. '''Q:''' This plugin lets me put tickets into a nonsensical state! [[BR]] '''A:''' These problems should be mostly resolved in 0.7.0. Please open a ticket if you still have problems. '''Q:''' The plugin doesn't use my custom workflow! [[BR]] '''A:''' This is a big problem and needs addressed. If you have a custom workflow you are willing to share, please add it to #7709. This will help me in making the plugin workflow-aware. == Screenshots == [[Image(batchmod_screenshot.png, border=3)]] ---- == Source == You can check out BatchModifyPlugin from [http://trac-hacks.org/svn/batchmodifyplugin here] using Subversion, or [source:batchmodifyplugin browse the source] with Trac. == Recent Changes == [[ChangeLog(batchmodifyplugin, 3)]] == Author/Contributors == '''Author:''' [wiki:ashwin_phatak] [[BR]] '''Maintainer:''' [wiki:CuriousCurmudgeon] [[BR]] '''Contributors:'''