Redmine

h1. Issue Due Date plugin

Issue Due Date will set the Issue due dates to the due dates of versions or deliverables.  It will also track due date so if a Version's due date is changed, all of it's issues with the same due date will also be changed.

h2. Getting the plugin

A copy of the plugin can be downloaded from "Little Stream Software":https://projects.littlestreamsoftware.com/projects/redmine-misc/files or from "GitHub":http://github.com/edavis10/redmine_issue_due_date/tree/master

A forked version for Redmine 2.x.x is also available on "GitHub":git://github.com/railsformers/redmine_issue_due_date.git.

h2. Installation and Setup

# Follow the Redmine plugin installation steps at: http://www.redmine.org/wiki/redmine/Plugins

# Restart your Redmine web servers (e.g. mongrel, thin, mod_rails)

# *(optional step)* If you would like to convert of the existing issues, backup your database and run the rake task:

    @rake issue_due_date_plugin:update_due_dates RAILS_ENV=production@

h2. Usage

h3. Issue edits

When an issue is edited, the plugin will check:

* If the issue's due date has been set on the Issue or

* the deliverable has a due date or

* the version has a due date

If any of those are true, the issue will have it's due date updated.  If multiple of them are true, the first one will be used.

h3. Version or Deliverable edits

The plugin will also hook into Versions so when the version's due date is updated, all issues assigned to the Version will be updated if the issues:

* Do not have a due date or

* Have a due date equal to the Version's old date

Example:

* Version X with a due of 2008-01-01 and issues of

** Issues A (due on 2008-01-01)

** Issue B (due on 2008-02-01)

** Issue C (no due date)

Changing Version X's date to 2008-01-15 will update the due date of:

* Issue A to 2008-01-15. It has the same due date as the version, so it's "following" the version.

* Issue C to 2008-01-15. It did not have a due date so it was given the version's due date.

* Issue B's due date will stay 2008-02-01.

Deliverables follow the exact same behavior.

h3. Version or Deliverable reassignments

When reassigning an issue to a different version, if the issue due date matched the old version date, the issue will change it's due date to match the new version.

Example:

1. I have an issue assigned to Version A with a date that matches Version A

2. If I change the issue to be assigned to Version B, then the date should change to version B's due date.

Deliverables follow the exact same behavior.

h2. License

This plugin is licensed under the GNU GPL v2.  See COPYRIGHT.txt and GPL.txt for details.

h2. Project help

If you need help you can contact the maintainer at the Bug Tracker.  The bug tracker is located at  https://projects.littlestreamsoftware.com

h2. News

"0.1.0 Release Announcement":http://theadmin.org/articles/2009/7/19/redmine-issue-due-date-plugin