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

= SimpleMultiProjectPlugin =

== Description ==

Lets you easily manage multiple projects with one instance of trac. This implements the idea of http://trac.edgewall.org/wiki/TracMultipleProjects/SingleEnvironment.

Experimental version.

You need to define an additional custom ticket field 'project' in your trac.ini, because on creating tickets the milestone combobox shows only milestones appropriately to the chosen project. Furthermore, you can have tickets of certain projects without milestone.

== Future Ideas ==
 - component selection depending on projects
 - version selection depending on projects
 - project category
 - version as date on roadmap
 - roadmap filtering/grouping of projects:
   - only milestones vs. only versions
   - project group boxes on|off
 - project-related timeline filtering of wiki changes (this needs a mapping which wiki part belongs to which project)
 - user-defined field used to define the "project" (e.g. by using component)

== Technical thoughts ==

This plugin adds two new tables to the db:
 1. smp_project: a list of all defined projects
 2. smp_milestone_project: the association of milestones to projects

== Example ==

'''''Admin Interface''''':
[[BR]]

[[Image(http://trac-hacks.org/attachment/wiki/SimpleMultiProjectPlugin/project_admin.png?format=raw,center)]]

----

[[Image(http://trac-hacks.org/attachment/wiki/SimpleMultiProjectPlugin/edit_project.png?format=raw,center)]]

----

'''''Associate a milestone in a project''''':
[[BR]]

[[Image(http://trac-hacks.org/attachment/wiki/SimpleMultiProjectPlugin/edit_milestone.png?format=raw,center)]]

----

'''''Group milestones in the roadmap, and display only projects chosen in the filter box''''':
[[BR]]

[[Image(http://trac-hacks.org/attachment/wiki/SimpleMultiProjectPlugin/roadmap_projects_filter.png?format=raw,center)]]

----

'''''display only tickets in the timeline of projects chosen in the filter box (adapted from TimelineComponentFilterPlugin)''''':
[[BR]]

[[Image(http://trac-hacks.org/attachment/wiki/SimpleMultiProjectPlugin/timeline_projects_filter.png?format=raw,center)]]

== Bugs/Feature Requests == 

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

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

== Download ==

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

== Source ==

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

== Installation ==

 1. Add a custom ticket field 'project' in your trac.ini to give tickets the information to which project they belong. Milestones selection depends on that as well.
   {{{
   [ticket-custom]
   project = text
   project.label = Project
   project.value =
   }}}
 2. Generate the plugin .egg file from sources
   {{{
   python setup.py bdist_egg
   }}}
 3. Copy the plugin to Trac, e.g.
   {{{
   cp dist/SimpleMultiProject-0.0.1-py2.6.egg /instance_trac/plugins/
   }}}
 4. Restart Apache. After installation of this plugin Trac needs a database upgrade!
   {{{
   trac-admin /instance_trac/ upgrade
   }}}


== Recent Changes ==

[[ChangeLog(simplemultiprojectplugin, 3)]]

== Author/Contributors ==

'''Author:''' [wiki:crossroad], [wiki:falkb], T.Doering [[BR]]
'''Maintainer:''' [wiki:crossroad] [[BR]]
'''Contributors:'''