[[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's action buttons are added to the top left of the ticket:

[[Image(Screen Shot 2014-01-02 at 10.27.50 PM.png, 80%, border=2)]]

A dialog box prompting the user for additional information:

[[Image(Screen Shot 2014-01-02 at 10.28.07 PM.png, 80%, border=2)]]

The dialog box after clicking the Resolve button:

[[Image(Screen Shot 2014-01-02 at 10.39.14 PM.png, border=2)]]

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/trac-hacks/trac-WorkflowActionButtonsPlugin.git here] using Git, or [https://github.com/trac-hacks/trac-WorkflowActionButtonsPlugin browse the source] with Github.

== Installation

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

Enable its components by setting the following in your `trac.ini` file:
{{{#!ini
[components]
workflow_actionbuttons.* = enabled
}}}

== Configuration

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 which is included in the plugin distribution. Font Awesome is itself [http://scripts.sil.org/cms/scripts/page.php?site_id=nrsi&id=OFL SIL Open Font License (OFL)] licensed.

== Recent Changes

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

== !Author/Contributors

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