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

= Back link feature in Trac (trac:#611)

== Description

This plugin provides [trac:wiki:BackLinks back link] feature.

 - Add //Back Links// section to ticket, wiki and milestone views.
 - Update automatically `backlink` table with gathered back links from tickets, wiki pages, milestones and changesets via `*ChangeListner` interfaces.
 - Add `backlink sync` command which updates `backlink` table first.

=== Screen shots
[[Image(example-wiki.png,border=2)]]

[[Image(example-ticket.png,border=2)]]

== !Bugs/Feature Requests

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

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

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

== Download

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

== Source

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

== Installation

 1. Install the plugin:
{{{#!sh
$ easy_install https://trac-hacks.org/svn/tracbacklinkplugin/1.0/
}}}
 2. Enable the plugin in your `trac.ini` file:
 {{{#!ini
[components]
tracbacklink.* = enabled
}}}
 3. Execute `upgrade` command to create `backlink` table:
{{{#!sh
$ trac-admin $ENV upgrade
}}}
 4. Execute `backlink sync` command to synchronize `backlink` table with several tables in Trac:
{{{#!sh
$ trac-admin $ENV backlink sync
}}}

See also [TracPlugins#InstallingaTracplugin TracPlugins] page.

== Recent Changes

[[ChangeLog(tracbacklinkplugin, 3)]]

== !Author/Contributors

**Author:** [http://www.opengroove.com/ OpenGroove,Inc.] and [http://tracpath.com/ tracpath] \\
**Maintainer:** [[Maintainer]] \\
**Contributors:**