[[PageOutline(2-5,Contents,Pullout)]] = Extended Version Plugin = == Description == The Trac ticket module has the concept of a version, but it is only visible as a name in a drop-down on a ticket. This plugin adds version description pages, a roadmap-like view of versions, and the ability to assign milestones to versions. Most features are optional. '''This plugin is for Trac 0.12 and later.''' * The version page shows the name, date, description and any assigned milestones. If milestones are assigned, it shows the overall progress for the version and the progress on each milestone. {{{#!NewsFlash **Development status** There is on-going work to provide similar features in the Trac core. See trac:#1233 and trac:#11409. }}} [[Image(version_page.png, 40%)]] * The version roadmap looks very similar to the milestone roadmap. [[Image(version_roadmap.png, 40%)]] * Milestones assigned to versions have the version noted beside the due date. [[Image(milestone_version.png)]] == Bugs/Feature Requests == Existing bugs and feature requests for ExtendedVersionPlugin are [report:9?COMPONENT=ExtendedVersionPlugin here]. If you have any issues, create a [http://trac-hacks.org/newticket?component=ExtendedVersionPlugin&owner=rjollos new ticket]. == Installation & Configuration == === Download === Download the zipped source from [download:extendedversionplugin here]. You can check out ExtendedVersionPlugin from [http://trac-hacks.org/svn/extendedversionplugin here] using Subversion, or [source:extendedversionplugin browse the source] with Trac. === Installation === The easiest way to install the ExtendedVersionPlugin is probably with easy_install: {{{ #!sh easy_install http://trac-hacks.org/svn/extendedversionplugin/trunk }}} Alternatively, download the source and run the usual {{{ #!sh python setup.py install }}} After installing the plugin, enable it for the trac environment in the TracIni file: {{{ #!ini [components] extendedversion.* = enabled }}} This plugin requires some database changes, so upgrade the environment. Trac will prompt you to if you don't. {{{ #!sh trac-admin /path/to/trac upgrade }}} == Configuration == The ExtendedVersionPlugin has several configuration options available in the `[extended_version]` section of TracIni. The default values are: {{{#!ini [extended_version] # component to use to provide group ticket statistics for versions version_stats_provider = DefaultTicketGroupStatsProvider # component to use to provide group ticket statistics for milestones in version page milestone_stats_provider = DefaultTicketGroupStatsProvider # whether to show milestone description for version pages show_milestone_description = false }}} The default configuration adds a `Versions` item to the main navigation bar. To instead change the `Roadmap` item to link to the versions page, set the `roadmap_navigation` to `true`. The `roadmap_navigation` option has been removed in r13314. The equivalent of `roadmap_navigation = true` can be obtained by setting `trac.ticket.roadmap.RoadmapModule = disabled`. Prior to r13314, the following option is available: {{{#!ini # whether to replace the roadmap navigation link or add a versions navigation link roadmap_navigation = false }}} == Recent Changes == [[ChangeLog(extendedversionplugin, 3)]] == Author/Contributors == '''Author:''' [wiki:mestudd] [[BR]] '''Maintainer:''' rjollos [[BR]] '''Contributors:''' [wiki:dcernea], jun66j5 [[BR]] '''License:''' BSD 3-Clause