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

= Nicely display list of Trac projects

== Description

This plugin lists the links to multiple projects in a scalable, indexed, table-oriented format, given an environment parent directory, such as the {{{PythonOption TracEnvParentDir}}} directive in Trac's Apache configuration. This macro was created to address the problem of trying to host multiple Trac instances within a single site.

== Bugs/Feature Requests

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

If you have any issues, create a 
[http://trac-hacks.org/newticket?component=ListTracProjectsMacro&owner=mathomas new ticket].

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

== Download

Download the zipped source from [download:listtracprojectsmacro here].

== Source

You can check out ListTracProjectsMacro from [http://trac-hacks.org/svn/listtracprojectsmacro here] using Subversion, or [source:listtracprojectsmacro browse the source] with Trac.

== Installation

Copy the `.py` file into the plugins directory of your Trac environment. Delete the corresponding `.pyc` file if exist (for upgrade).
Restart apache if applicable.

== Example

You must edit and change the variable ENV_PARENT_DIR (or DIR for 0.11 branch) in the script to point to your environment's parent directory, eg {{{/usr/local/www/trac/}}}.
The 0.11 version, which is quite simple for now, seems to work with 0.12 too.

A sample call to the macro:
{{{
[[ListTracProjects()]]
}}}

== Recent Changes

[[ChangeLog(listtracprojectsmacro, 3)]]

== Author/Contributors

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