[[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 http://trac.edgewall.org/wiki/TracDev/Proposals/BatchModification. === Future Releases === * '''0.7:''' Updated UI to more closely match how custom query filters are added. (#7303) ---- == Download == '''Note:''' Python 2.4 eggs are not provided simply because I do not have it installed on my machine. If you build a 2.4 egg for a release feel free to cook one up and send to me. I will add it to repository and the download list. ||Trac||Python||Version||Date|| ||0.12||2.5||[http://trac-hacks.org/browser/batchmodifyplugin/0.12/tags/BatchModify-0.6.0_trac0.12-py2.5.egg 0.6.0]||6-18-2010|| ||0.12||2.6||[http://trac-hacks.org/browser/batchmodifyplugin/0.12/tags/BatchModify-0.6.0_trac0.12-py2.6.egg 0.6.0]||6-18-2010|| ||0.11||2.5||[http://trac-hacks.org/browser/batchmodifyplugin/0.11/tags/BatchModify-0.6.0_trac0.11-py2.5.egg 0.6.0]||6-18-2010|| ||0.11||2.6||[http://trac-hacks.org/browser/batchmodifyplugin/0.11/tags/BatchModify-0.6.0_trac0.11-py2.6.egg 0.6.0]||6-18-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:''' The way the plugin handles ticket statuses and and resolutions isn't very good. Setting a status to closed does not actually close the ticket. You must also set the resolution. This will be fixed in a future release. Patches are always welcome though. == Screenshots == [[Image(BatchModifyScreenshot.png, width=900px, 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:'''