wiki:SubticketsPlugin

Version 26 (modified by Theodor Norup, 17 months ago) (diff)

Dropped support for 0.11 and 0.12. Added description of workflow interaction

Subtickets support for Trac tickets

Description

This plugin offers sub-ticket feature for managing tickets. Subtickets are useful for when several tickets are developed and released under one master ticket. The master ticket, in the example below called the Root ticket, has multiple subtickets defined under it.

The following screenshot demonstrates how the subtickets are displayed below the Description section of a ticket:

Relations between tickets are stored in a table called Subtickets with just two columns: parent, child and that eases reporting considerably when compared to ChildTicketsPlugin (which currently has more configuration options). For further information on reporting, see SubticketsPlugin/Reporting.

Bugs/Feature Requests

Existing bugs and feature requests for SubticketsPlugin are here.

If you have any issues, create a new issue.

Download

You can download zipped source from here.

Source

You can check out the source for SubticketsPlugin from here using Git, or browse the source with GitHub.

Installation

  1. Download the zip file, unpack it and run:
    python setup.py bdist_egg
    
  2. Install it in one of the following ways:
    cp dist/*.egg path/to/trac/env/plugins
    
    easy_install dist/*.egg
    
    python setup.py install
    
  3. Enable the plugin in your trac.ini file as follows:
    [components]
    tracsubtickets.api.* = enabled
    tracsubtickets.web_ui.* = enabled
    
  4. Upgrade your Trac environment:
    trac-admin <env> upgrade
    

Configuration

This plugin shares some of the configurations with ChildTicketsPlugin. Most settings are ticket type dependent, such as defect and task in the example below:

# Select column headings in child listing
# Id and summary are always displayed
defect.table_columns = priority,keywords,owner
task.table_columns   = # display id and summary only

# Control which fields are inherited from parent to child when creating child
defect.child_inherits = keywords,milestone
task.child_inherits   = version,cc

# Control the visual appearance of the create subticket link. Config value shall be one of "button" and "link"
add_style = button

Interaction with ticket workflows

If the ticket workflow includes actions resolve and reopen, they will block and show an error message when:

  • trying to resolve a ticket with one or more non-closed children
  • trying to reopen or modify fields of a closed ticket with one or more closed parents.

About i18n/l10n support

This plugin is prepared for localization. The patched version is available at the Git repo now.

The English message texts are still the (POSIX) default. If this isn't your preferred language, you can:

  1. check if it is already available from the Trac plugin l10n project at Transifex or
  2. do it yourself, see the l10n cookbook page for Trac plugins for more details.

Contributing your translation is highly appreciated! You could send it to the plugin's maintainer or contribute to Trac plugin l10n project via Transifex:

Top translations: Trac_Plugin-L10N » tracsubtickets

http://www.transifex.net/projects/p/Trac_Plugin-L10N/resource/tracsubtickets/chart/image_png

Kindly provided by https://ds0k0en9abmn1.cloudfront.net/static/charts/images/tx-logo-micro.png

Author/Contributors

Author: itota
Maintainer: thenor
Contributors: hasienda, Chris Nelson

Attachments (1)

Download all attachments as: .zip