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

= Whiteboard vision of ongoing tickets

== Description

This plugin adds a virtual whiteboard view of active tickets. The virtual whiteboard ('Ticketsboard') is a table divided in ticket states where each ticket is shown as a sticky note.

Key features:
- Drag & drop a sticky note to another column to change ticket state.
- Directly edit owner and reviewer of a ticket.
- Filter tickets to show only tickets where you are the owner or reviewer (link on top right).

As the amount of tickets could be significant:
- Tickets have different colors according to there types (red for defects, yellow for enhancements, blue for tasks).
- Ticketsboard shows only tickets where the checkbox 'On Ticketsboard' is checked (this checkbox is created by the plugin).

This plugin is divided in two parts:

- Reviewer field: [[BR]]
  This part adds, in tickets, a new textbox field 'reviewer' that will contain the name of the reviewer.
  This new field could also be managed in the ticket workflow. So, each change on ticket state can be combined with a control on the reviewer field (set_reviewer, del_reviewer).

- Virtual whiteboard ('Ticketsboard'): [[BR]]
  It adds a new tab in the mainnav bar.
  This tab shows a dedicated html page that represents the virtual whiteboard.
  A user can change tickets states through a drag and drop system. As there are restrictions on some states (set_owner, set_reviewer), changes could be rejected.
  This part adds the checkbox 'On Ticketsboard' and checks that the ticket workflow contains the required states.

This plugin is based on the WhiteboardPlugin by [wiki:CuriousCurmudgeon].

== !Bugs/Feature Requests

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

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

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

== Download

Download the zipped source:
||Trac||Version||
||0.12||[export:ticketsboardplugin/tags/1.2.2-trac0.12 1.2.2-trac0.12]||
||0.12||[export:ticketsboardplugin/trunk trunk]||

Download the zipped global sources from [export:ticketsboardplugin here].

== Source

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

== Installation

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

== Configuration

Activate the whole plugin by adding the following to your `trac.ini` file:
{{{#!ini
[components]
ticketsboardplugin.* = enabled
}}}

Activate separately the two different parts of the plugin:
{{{#!ini
[components]
ticketsboardplugin.assignreviewer.* = enabled
ticketsboardplugin.web_ui.* = enabled
}}}

Add a //reviewing// state to the TracWorkflow.

Configure statuses ''(showing default configuration)'':
to set the tickets states to show.
{{{#!ini
[ticketsboard]
statuses = new,assigned,reviewing,closed
}}}

Configure fields ''(showing default configuration)'':
to set ticket fields to show on ticket sticky notes.
{{{#!ini
[ticketsboard]
fields = owner,reviewer
}}}

== Recent Changes

[[ChangeLog(ticketsboardplugin, 3)]]

== !Author/Contributors

**Author:** [wiki:jpsave] [[BR]]
**Maintainer:** [[Maintainer]] [[BR]]
**Contributors:**