[[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.

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, border=2)]]

And the component admin page looks like this:

[[Image(Subcomponents-admin.png, border=2)]]

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 also available and there is no functional difference between these 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.

See also the [https://github.com/trac-hacks Github-hosted source].

The repo of the original author may be found here: https://github.com/nielx/trac-subcomponents

== 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.

== Recent Changes

[[ChangeLog(subcomponentsplugin, 3)]]

== Author/Contributors

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