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

= Remote Ticket Plugin

== Description

This plugin allows you to link tickets in one Trac instance to tickets in other Trac instances. Links and their behaviour are configurable, for example parents/children, blockers/blockedby.

The plugin 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 
[/newticket?component=RemoteTicketPlugin new ticket].

[[TicketQuery(component=RemoteTicketPlugin&group=type,format=progress)]]

== Download

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

== Source

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

== Installation

General instructions on installing Trac plugins can be found on the [TracPlugins#InstallingaTracplugin TracPlugins] page.

== 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.

{{{#!ini
[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 its parent.
 - A parent ticket may not be closed until all child tickets are closed.

{{{#!ini
[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 no reciprocal link.
 - A ticket may be closed regardless of the link.

{{{#!ini
[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` file:
{{{#!ini
[components]
tracremoteticket.* = enabled
}}}

To configure remote Trac instances create a trac:InterTrac reference and add {{{remote_ticket = true}}} to your `trac.ini` file:
{{{#!ini
[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:''' [[Maintainer]] [[BR]]
'''Contributors:'''