Version 47 (modified by 9 years ago) (diff) | ,
---|
Contents
SimpleMultiProjectPlugin
Description
Lets you easily manage multiple user projects with one Trac instance or, respectively, one Trac database (.db file).
- This is not a meta project in front of several other Trac projects, it just implements the idea of wiki:TracMultipleProjects/SingleEnvironment.
- Milestones and versions are assigned to their projects, and both are displayed on the roadmap. There are several possibilities to filter by projects on that page, and also the timeline.
- Components can be assigned to all or only certain projects.
- 'New Ticket' will just offer the associated milestones, versions and components of the chosen project. This requires a new custom-ticket field 'project'.
This is already running stable in a real production environment.
Note: The Multiple Project feature in the sense of having a meta Trac project on top of several Trac projects is discussed in T:#130 and scheduled for Trac topic-multiproject which is eventually part of Trac next-dev-1.1.x.
Plan
in testing state: No results
work in progress: No results
still just an idea:
Technical thoughts
This plugin adds a new resource 'project' implemented by database table:
- smp_project: a list of all defined projects
Actually, most database tables of Trac core related to resources would need a new column 'project_id'. This way tickets, components, milestones, versions or even wikis could attach to certain projects. Since a plugin just adds stuff but cannot change the core structure, it implements the new dimension 'project' not by adding a new column to each resource table but rather by adding several mapping tables smp_[resource]_project, each one mapping a certain resource to projects:
- smp_milestone_project: the association of milestones to projects
- smp_version_project: the association of versions to projects
- smp_component_project: the association of components to projects
Example
Admin Interface:
Add project summary and description. This is displayed on the roadmap page then:
Associate a milestone in a project:
- From the "Roadmap" Page, find the desired milestone/version and click it.
- Scroll to bottom of page and "Edit" the page. Select the project from the given combobox.
Traps:
- Mapping milestones and versions to a project is not supported via main menu item "Admin" -> "Ticket System" -> "Milestones" / "Versions".
- If you forget to map milestones and versions to a new project, and you try to create a new ticket, it will happen to you that after you have selected a project from its combobox the "New Ticket" form cannot offer any in the comboboxes of milestone and version.
Group milestones and versions on the roadmap by project, show project summary and description in the header of the project box, and display only projects chosen in the filter box:
display only tickets in the timeline of projects chosen in the filter box (adapted from TimelineComponentFilterPlugin):
Bugs/Feature Requests
total issue record:
open issues by type:
defect
0 / 8
enhancement
0 / 15
If you have any issues, create a new ticket.
Download
Download the zipped source from [download:simplemultiprojectplugin here].
Source
You can check out SimpleMultiProjectPlugin from here using Subversion, or browse the source with Trac.
Installation
- 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 = select project.label = Project project.value =
- Generate the plugin .egg file from sources
python setup.py bdist_egg
- Copy the plugin to Trac, e.g.
cp dist/SimpleMultiProject-0.0.1-py2.6.egg /instance_trac/plugins/
- Restart Apache. After installation of this plugin Trac needs a database upgrade!
trac-admin /instance_trac/ upgrade
- Give permissions to certain users. Available permissions are:
PROJECT_SETTINGS_VIEW
- you can see the list of projects with their description and their component mapping on the Admin panelPROJECT_ADMIN
- full access, you can also create and delete projects, and map to milestones, versions and components
- Since plugin version 0.4 we support project-wise restriction of resources to a subset of users (#11367). Switch on the plugin component ProjectTicketsPolicy to activate it, and add the following to your trac.ini
[trac] permission_policies = ProjectTicketsPolicy, ... any other ...
Define a comma-separated list of users or groups in 'Admin' -> 'Manage Projects' -> 'Projects' -> '<project name>' -> 'Retrict to users' to limit the access to certain projects (milestones, versions, tickets).
For example, setjohn, mary, group1, authenticated
to restrict to this set of users!, bob, anonymous, group2
to exclude from the project.
Recent Changes
- 18451 by rjollos on 2021-10-15 17:19:25
-
SimpleMultiProjectPlugin: Release 0.7.4
Refs #14055.
- 18105 by Cinc-th on 2021-03-28 09:25:59
-
SimpleMultiProjectPlugin: fixed Jinja2 errors.
- 18093 by Cinc-th on 2021-03-25 09:45:06
-
SimpleMultiProjectPlugin: fix for test case error with python 3.
- 18092 by Cinc-th on 2021-03-25 07:02:35
-
SimpleMultiProjectPlugin: fix for error with postgres when trying to get the id of the last created project from the database right after insertion of the record.
Closes #13955
- 18091 by Cinc-th on 2021-03-25 06:26:19
-
SimpleMultiProjectPlugin: added test case for version page template.
Refs #13974
(more)
Author/Contributors
Author: crossroad, falkb, thomasd
Maintainer: falkb
Contributors:
Attachments (8)
-
project_admin.png (43.1 KB) - added by 13 years ago.
Project admin Interfaz
-
edit_project.png (33.9 KB) - added by 13 years ago.
Edit Project
-
edit_milestone.png (26.3 KB) - added by 13 years ago.
Edit milestone
-
roadmap_projects.png (35.9 KB) - added by 13 years ago.
Roadmap Projects
-
roadmap_projects_filter.png (54.7 KB) - added by 12 years ago.
roadmap can display project summary+description; project filter displays milestones and versions of certain projects, only
-
admin_projects_modify.png (30.4 KB) - added by 12 years ago.
write project summary and description
-
admin_project.png (31.4 KB) - added by 12 years ago.
project admin interface
-
timeline_projects_filter.png (35.5 KB) - added by 12 years ago.
timeline filter demo
Download all attachments as: .zip