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

= Add streamlined workflow-action buttons to the top of a ticket

== Description

This plugin adds a row of "action buttons" to the top of every ticket detail page. These buttons allow you to quickly act on a ticket (with a workflow action like "reassign", "resolve", "reopen", etc) without scrolling down to the Actions section. When a button is pressed, a modal dialog opens up with a small form prompting the user for any additional information, eg resolution when resolving the ticket, or new owner when reassigning, and an optional comment.

The plugin does nothing if Javascript is disabled.

== !Bugs/Feature Requests

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

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

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

== Download

Download the zipped source from the Python Package Index [pypi:trac-WorkflowActionButtons here].

== Source

You can check out WorkflowActionButtonsPlugin from [https://github.com/ejucovy/trac-WorkflowActionButtonsPlugin.git here] using Git, or [https://github.com/ejucovy/trac-WorkflowActionButtonsPlugin browse the source] with Github.

== Installation

Install the plugin and then enable its components by setting `workflow_actionbuttons.* = enabled` in your `trac.ini` `[components]` section.

You can customize the labels and icons displayed for each button. To do this, create a new `trac.ini` section `[ticket-workflow-action-buttons]`:
{{{#!ini
[ticket-workflow-action-buttons]
accept.title = Accept
accept.icon = fa-thumbs-o-up
leave.title = Comment
leave.icon = fa-comments-o
leave.comment = required
assign.title = Reassign
assign.icon = fa-random
reopen.title = Reopen
reopen.icon = fa-minus-square-o
resolve.title = Close
resolve.icon = fa-check-square-o
}}}

The icons are implemented with [http://fontawesome.io/icons/ Font Awesome]; a copy of Font Awesome is included in the plugin distribution.

== Screenshots 

Screenshot of the plugin's action buttons added to the top of the ticket:

[[Image(Screen Shot 2014-01-02 at 10.27.50 PM.png, 800, 600)]]

Screenshot of the dialog box prompting the user for additional information:

[[Image(Screen Shot 2014-01-02 at 10.28.07 PM.png, 800, 600)]]

Screenshot of the dialog box after clicking the Resolve button:

[[Image(Screen Shot 2014-01-02 at 10.39.14 PM.png, 800, 600)]]

== Recent Changes

[https://github.com/ejucovy/trac-WorkflowActionButtonsPlugin/commits/master View] the log on GitHub.

== !Author/Contributors

'''Author:''' [wiki:ejucovy] [[BR]]
'''Maintainer:''' [[Maintainer]] [[BR]]
'''Contributors:'''