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

= Subtickets support for Trac tickets

== Description

This plugin offers sub-ticket feature for managing tickets.

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

[[Image(trac-subtickets-plugin_001.png)]]

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

== Bugs/Feature Requests

Existing bugs and feature requests for SubticketsPlugin are [https://github.com/trac-hacks/trac-subtickets-plugin/issues here].

If you have any issues, create a [https://github.com/trac-hacks/trac-subtickets-plugin/issues new issue ticket].

== Download

You can download zipped source from [https://github.com/trac-hacks/trac-subtickets-plugin/zipball/master here].

== Source

You can check out the source for SubticketsPlugin from [https://github.com/trac-hacks/trac-subtickets-plugin.git here] using Git, or browse the source with [https://github.com/trac-hacks/trac-subtickets-plugin GitHub].

== Installation

 1. Download the [https://github.com/trac-hacks/trac-subtickets-plugin/zipball/master zip file], unpack it and run:
 {{{#!sh
python setup.py bdist_egg
 }}}
 1. Install it in one of the following ways:
 {{{#!sh
cp dist/*.egg path/to/trac/env/plugins
 }}}
 {{{#!sh
easy_install dist/*.egg
 }}}
 1. Enable the plugin in your `trac.ini` file as follows:
 {{{#!ini
[components]
tracsubtickets.api.* = enabled
tracsubtickets.web_ui.* = enabled
 }}}
 1. Upgrade your Trac environment:
 {{{#!sh
trac-admin <env> upgrade
 }}}

== 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 [TracPluginTranslation Trac plugin l10n project] at [https://www.transifex.com/projects/p/Trac_Plugin-L10N/resource/tracsubtickets Transifex] or
 2. do it yourself, see the [t:CookBook/PluginL10N#Dotranslatorswork 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 [TracPluginTranslation Trac plugin l10n project] via [http://www.transifex.net/projects/p/Trac_Plugin-L10N/ Transifex]:

Top translations: Trac_Plugin-L10N » [https://www.transifex.com/projects/p/Trac_Plugin-L10N/resource/tracsubtickets tracsubtickets][[BR]]
 [[Image(http://www.transifex.net/projects/p/Trac_Plugin-L10N/resource/tracsubtickets/chart/image_png, title=Go to Trac_Plugin-L10N project page on Transifex.net, link=http://www.transifex.net/projects/p/Trac_Plugin-L10N/resource/tracsubtickets/)]]

Kindly provided by [[Image(https://ds0k0en9abmn1.cloudfront.net/static/charts/images/tx-logo-micro.png, link=http://www.transifex.net/, title=the open translation platform, valign=bottom)]]

== Author/Contributors

'''Author:''' [wiki:itota] [[BR]]
'''Maintainer:''' thenor57 [[BR]]
'''Contributors:''' [wiki:hasienda]