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

= A backlog plugin supporting multiple projects

== Description

This plugin is derived from TracBacklog plugin:

    https://trac-hacks.org/wiki/TracBacklogPlugin

The codebase was
updated to support modern Trac concepts introduced with V0.12 and V1.0.

The plugin now supports multiple projects when using SimpleMultiProjectPlugin. Note that
you may also use this plugin without multiple projects. That means you don't need
to have SimpleMultiProjectPlugin installed.

This plugin is meant to support you with your agile process using Trac by helping with prioritizing a (possibly project specific)  backlog.  That
can normally be difficult to do in Trac, as it doesn't have any way of doing
fine-grained ranking of tickets.  This plugin helps resolve that
short-coming.

MultiProjectBacklogPlugin adds a new navigational element to your navigation bar.
Clicking on it will take you to the unscheduled backlog (all active tickets
of a project that aren't currently assigned to a milestone).  On the right hand side,
is a listing of open milestones.  The idea is that you drag-n-drop tickets
within the list itself to change their rank.  Once you're happy with the
ranking (i.e., you've worked with your customer to prioritize the outstanding
tickets), you drag-n-drop tickets onto a milestone to assign it into the
milestone.  This effectively treats milestones as sprints.

The unscheduled backlog is created from tickets that are not assigned
to any milestone.  You can also view each milestone and see and individual
backlog for it, but all tickets are ranked absolutely (they maintain their
absolute ranking when you drag them in and out of a milestone).  Furthermore,
if you are trying this on an existing project, the initial rank for each
ticket will be it's ticket id.  You'll want to spend some time sorting your
tickets, and you may want to consider pulling them all into the unscheduled
backlog when you do that (so that you can order the all the tickets against
each other).

By using the project drop down list on the top right you may switch your
project. Only tickets and milestones assigned to that project are shown.


== !Bugs/Feature Requests

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

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

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

== Download

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

== Source

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

This plugin is derived from TracBacklog plugin:

    https://trac-hacks.org/wiki/TracBacklogPlugin

with last commit

    https://github.com/jszakmeister/trac-backlog/commit/6e76f506351847189dcbfb26bfcad7889aa76f24

from 2013-10-15. The code from the pull request

    https://github.com/jszakmeister/trac-backlog/pull/12

which adds support for ticket custom fields is included.

Instead of using the Dojo toolkit the plugin now uses jQuery-ui coming with Trac.


== Installation

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

Enable the plugin in trac.ini:

{{{#!ini
[components]
multiprojectbacklog.* = enabled
}}}

You need to run {{{trac-admin <path/to/env> upgrade}}} on your database, since the
plugin needs to create a table and some default values for your ticket ordering.

== Recent Changes

[[ChangeLog(multiprojectbacklogplugin, 3)]]

== !Author/Contributors

**Author:** [wiki:Cinc-th] [[BR]]
**Maintainer:** [[Maintainer]] [[BR]]
**Contributors:**