[[PageOutline(2-5,Contents,pullout)]]

= Remote Ticket Plugin =

== Description ==

Link tickets in one Trac instance to tickets in other Trac instances. Links and their behaviour are configurable - e.g. parents/children, blockers/blockedby.

The builds on and requires the ticket-links branch of Trac. Currently this means you must be running the remote-ticket branch of Trac from [https://bitbucket.org/moreati/trac-ticketlinks/src/02ddb32fcdaa]. XmlRpcPlugin is also required to perform remote fetching of ticket details.

== Bugs/Feature Requests == 

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

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

== Download ==

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

== Source ==

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

== Example ==

To configure ticket-links for a relationship in which
 - Any ticket may depend on and be dependant on many tickets
 - A ticket may not be closed until all tickets it depends on are closed

{{{
[ticket-links]
dependency = dependson,dependant
dependency.validator = no_cycle
dependant.label = Dependant
dependson.label = Depends on
dependson.blocks = true
}}}

To confgiure a relationship in which 
 - A ticket may have many child tickets, and at most one parent ticket
 - A new child ticket will have it's summary and description pre-populated from it's parent
 - A parent ticket may not be closed until all child tickets are closed

{{{
[ticket-links]
parentchild = parent,children
parentchild.validator = parent_child
children.blocks = true
children.label = Child
children.copy_fields = summary, description
parent.label = Parent
}}}

To configure a relationship in which
 - A ticket may refer to another ticket, and there is not reciprocal link
 - A ticket may be closed regardless of the link

{{{
[ticket-links]
reference = refersto
refersto.label = Refers to
}}}

Many different relationships may be configured at once, relationship names must each be unique.


To enable the remote tickets plugin, add to your trac.ini
{{{
[components]
tracremoteticket.* = enabled
}}}

To configure remote trac instances create a trac:InterTrac reference and add {{{remote_ticket = true}}}
{{{
[intertrac]
example.remote_ticket = true
example.title = Bravo
example.url = http://trac.example.org/
}}}

Install XmlRpcPlugin and grant {{{XML_RPC}}} to {{{anonymous}}}.

Configure the an trac:InterTrac reference, the same ticket-links relationships and the same XmlRpcPlugin grant in the remote Trac instance.

== Recent Changes ==

[[ChangeLog(remoteticketplugin, 3)]]

== Author/Contributors ==

'''Author:''' [wiki:moreati] [[BR]]
'''Maintainer:''' [wiki:moreati] [[BR]]
'''Contributors:'''