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

= Support for Pending Tickets

== Description

This plugin allows an administrator to mark a Ticket as "Pending" to indicate that information has been requested from the reporter. If the reporter doesn't reply within the allotted timeframe, the ticket will be closed automatically.

This works well when combined with the SimpleTicketPlugin.

== Bugs/Feature Requests

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

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

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

== Download

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

== Source

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

== Installation

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

You will also need to enable the Plugin in your `trac.ini` file:
{{{#!ini
[components]
removepending.* = enabled
}}}

Set up your ticket workflow to include a 'pending' status, for example in your `trac.ini` file:
{{{#!ini
[ticket-workflow]
pending = new,assigned,accepted,reopened -> pending
pending.permissions = TICKET_MODIFY
}}}

Specify the status for tickets when 'pending' is removed:
{{{#!ini
[ticket]
pending_removal_status = new
}}}

To enable the automatic closing of tickets, you'll need to set up a script to be run by cron.
{{{#!sh
#!/bin/bash

TRAC_ENV=/somewhere/trac/project
SCRIPT_DIR=$TRAC_ENV/localscripts
LOGFILE=$SCRIPT_DIR/close_old_pending.log

date >> $LOGFILE

python $SCRIPT_DIR/close_old_pending.py -p $TRAC_ENV -d 14 >> $LOGFILE 2>&1
}}}

== Recent Changes

[[ChangeLog(pendingticketplugin, 3)]]

== Author/Contributors

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