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

= Backlinks for tickets in comment history

== Description

This plugin enables intra-Trac references between tickets. Example: when a comment on ticket A references ticket B, a comment is made on ticket B letting you know that ticket A has referenced it.

See also: BackLinksMacro

=== Usage scenario

If developer A is working on ticket 1 and developer B is working on ticket 2 and writes some notes (on ticket 2) how it's related to ticket 1, it automatically makes a (ticket-2)-to-(ticket 1) link that's easy to follow to get more details. So far so good. However, developer A has no idea her ticket has just been discussed on ticket 2, and tinkers on blithely unaware of what is going on around her, because there is no reciprocal (ticket 1)-to-(ticket 2) link.

How can we automatically indicate that tickets are being discussed at other tickets? This plugin creates that reciprocal (ticket 1)-to-(ticket 2) link so that anyone looking at ticket 1 can see it has been talked about on ticket 2 as well.

== Bugs/Feature Requests

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

If you have any issues, create a 
[/newticket?component=TracBacksPlugin new ticket].

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

== Download and Source

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

== Source

Check out TracBacksPlugin using Subversion from [/svn/tracbacksplugin here] or [source:tracbacksplugin browse the source] with Trac.

== Installation

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

== Example

'''Note''': This plugin will not retroactively create trackbacks for existing comments.

Adding the following comment in ticket A:

[[Image(TicketA.png)]]

Results in the following trackback in ticket B:

[[Image(TicketB.bmp)]]

== Recent Changes

[[ChangeLog(tracbacksplugin, 3)]]

== Author/Contributors

'''Author:''' [wiki:mchua] [[BR]]
'''Maintainer:''' [[Maintainer]] [[BR]]
'''Contributors:''' [wiki:tcoulter] (original proposer), Doug Mayle, [wiki:magicbronson], [wiki:k0s], [wiki:rjollos] [[BR]]

Originally written at [http://topp.openplans.org The Open Planning Project].