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

= Whiteboard vision of ongoing tickets

== Description

It is a trac plug-in that adds a virtual whiteboard view of active tickets.

This virtual whiteboard ('Ticketsboard') is a table divided in ticket states where each ticket is shown as a sticky note.
Inside the virtual whiteboard, you can:
- Drag&drop a sticky note to another column to change ticket state.
- Directly edit owner and reviewer ticket fields.
- Filter tickets to show only tickets where you are 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 ticket checkbox 'On Ticketsboard' is checked (this checkbox is created by the plug-in).

== Notes

This plug-in 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 needed states.

== !Bugs/Feature Requests

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

If you have any issues, create a 
[http://trac-hacks.org/newticket?component=TicketsBoardPlugin new ticket].

== Download

Download the zipped source:
||Trac||Version||
||0.12||[export:ticketsboardplugin/0.12/tags/1.0.0-trac0.12 1.0.0-trac0.12]||
||0.12||[export:ticketsboardplugin/0.12/tags/1.0.1-trac0.12 1.0.1-trac0.12]||
||0.12||[export:ticketsboardplugin/0.12/tags/1.1.0-trac0.12 1.1.0-trac0.12]||
||0.12||[export:ticketsboardplugin/0.12/tags/1.2.0-trac0.12 1.2.0-trac0.12]||
||0.12||[export:ticketsboardplugin/0.12/tags/1.2.1-trac0.12 1.2.1-trac0.12]||
||0.12||[export:ticketsboardplugin/0.12/trunk trunk]||

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

== Source

You can check out TicketsBoardPlugin from [http://trac-hacks.org/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:
{{{
#!ini
[components]
ticketsboardplugin.* = enabled
}}}

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

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:**

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