[[PageOutline(2-5,Content,pullout)]]
= Move Trac tickets from one project to another =

== Description ==

Move Trac tickets from one project to another that resides in the '''same environment directory'''. Install and enable the plugin and in the ticket sidebar controls will be shown to anyone with `TICKET_ADMIN` permission (by default) to move the ticket to another peer project where the user also has `TICKET_ADMIN` permissions.

I probably would have used the DatamoverPlugin (now deprecated), but this didn't work for Trac 0.11. TicketMoverPlugin also handles ticket attachments.

There is a [https://github.com/UnwashedMeme/TicketMoverPlugin fork] of this plugin by UnwashedMeme that implements an `ITicketActionController` for moving tickets. Please open tickets for that version of the plugin in the [https://github.com/UnwashedMeme/TicketMoverPlugin/blob/acceleration/ticketmoverplugin/ticketmover.py GitHub issue tracker].

== Bugs/Feature Requests == 

Existing bugs and feature requests for TicketMoverPlugin are 
[report:9?COMPONENT=TicketMoverPlugin here].

If you have any issues, create a 
[http://trac-hacks.org/newticket?component=TicketMoverPlugin&owner=k0s new ticket].

== Requirements ==

This plugin requires TicketSidebarProviderPlugin and TracSqlHelperScript.

== Installation ==

Download the zipped source from [download:ticketmoverplugin here].

You can also check out TicketMoverPlugin from [http://trac-hacks.org/svn/ticketmoverplugin here] using Subversion, or [source:ticketmoverplugin browse the source] with Trac.

Enable the plugin:

{{{
#!ini
[components]
ticketmoverplugin.ticketmover.ticketmover = enabled
ticketmoverplugin.web_ui.ticketmoverhandler = enabled
ticketmoverplugin.web_ui.ticketmoversidebar = enabled
}}}

Also make sure that the TicketSidebarProviderPlugin is enabled in the `[components]` section of your `trac.ini`:

{{{
#!ini
ticketsidebarprovider.ticketsidebar.ticketsidebarprovider = enabled
}}}

The permission required for moving ticket can be specified (default value is shown):
{{{
#!ini
[ticket]
move_permission = TICKET_ADMIN
}}}

== Project on Remote Server ==

[wiki:lkraav]: I had a use case where I needed to move tickets between Tracs on two different machines. TicketMoverPlugin does not support this natively. To solve this, I mounted remote Trac project directory into a directory residing next to the local project directory over CIFS (certainly NFS or other network FS should work). This makes remote Trac appear local to TicketMoverPlugin and tickets were moved without errors. (10/06/09)

== Example ==

See screenshot:

[[Image(screenshot.png)]]

If you have permissions, a box will show up allowing you to move the current ticket to a different project.  If you check the `delete` checkbox, the ticket will also be deleted from the database, though this is not recommended in most cases.  If you don't delete the ticket, it will be closed with a resolution of `moved`.

== Recent Changes ==

[[ChangeLog(ticketmoverplugin, 3)]]

== Author/Contributors ==

''Originally developed at [http://openplans.org The Open Planning Project]''

'''Author:''' [wiki:k0s] [[BR]]
'''Maintianer:''' ''none'' [[BR]]
'''Contributors:''' UnwashedMeme, jun66j5, rjollos