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

= Trac Subcomponents

== Description

This plugin alters Trac's behavior so that the interface supports multiple layers of components. In projects with lots of components, rearranging these components into several layers can clear up the list of components. The component does not change the data model of the components; it merely manipulates the user interface. See below for an example.

An alternative plugin targeting the same problem is ComponentHierarchyPlugin. 

== Bugs/Feature Requests

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

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

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

== Download

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

Older versions of this plugin are available below.
There is no functional difference between the 3 versions.

||'''Trac version'''||'''Plugin version'''||'''Download link'''||
||Trac 0.11||Subcomponents 1.0.1||[http://hg.haiku-os.org/trac/trac-subcomponents/archive/aaf5b8884d95.tar.bz2 bz2] [http://hg.haiku-os.org/trac/trac-subcomponents/archive/aaf5b8884d95.zip zip]||
||Trac 0.12||Subcomponents 1.1.2||[http://hg.haiku-os.org/trac/trac-subcomponents/archive/fb35c463e72d.tar.bz2 bz2] [http://hg.haiku-os.org/trac/trac-subcomponents/archive/fb35c463e72d.zip zip]||
||Trac 1.0||Subcomponents 1.2.0||[http://hg.haiku-os.org/trac/trac-subcomponents/archive/46e3b20788ed.tar.bz2 bz2] [http://hg.haiku-os.org/trac/trac-subcomponents/archive/46e3b20788ed.zip zip]||

== Source

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

== Installation

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

After activating the plugin in the `trac.ini` configuration file or through the plugins page, it does not require any further configuration.

== Example

To create a component that has subcomponents, you have to add these subcomponents using the standard component admin page. For example, if you enter the following components:

 * `Web`
 * `Web/Frontend`
 * `Web/Backend`

then the user interface will show the `Frontend` and `Backend` as a subcomponent of the `Web` component.  

An example of the query page after enabling this plugin:

[[Image(Subcomponents-query.png)]]

And the component admin page looks like this:

[[Image(Subcomponents-admin.png)]]

== Recent Changes

[[ChangeLog(subcomponentsplugin, 3)]]

In version 1.2.0 of this plugin, the following was changed:
 * Updated for Trac 1.0, add support for the ''Bulk changes'' functionality.
 * Javascript code rewritten to utilize jQuery.

For the older versions of this plugin, see the [http://hg.haiku-os.org/trac/trac-subcomponents/shortlog log] of the repository for a detailed list of changes.

== Author/Contributors

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