RedmineProjectSettings » History » Version 14

Jean-Philippe Lang, 2010-01-09 15:12
move the screenshot to the proper location

1 1 Jean-Philippe Lang
h1. Project Settings
2 1 Jean-Philippe Lang
3 10 Mischa The Evil
{{>toc}}
4 1 Jean-Philippe Lang
5 10 Mischa The Evil
h2. Information
6 1 Jean-Philippe Lang
7 1 Jean-Philippe Lang
In this screen you can configure the basic (though important) settings for the selected project.
8 1 Jean-Philippe Lang
9 14 Jean-Philippe Lang
!project-settings_information-tab.jpg!
10 14 Jean-Philippe Lang
11 10 Mischa The Evil
h3. General settings
12 10 Mischa The Evil
13 10 Mischa The Evil
The following general settings are available:
14 1 Jean-Philippe Lang
* *Name*: project display name (must be unique).
15 10 Mischa The Evil
16 14 Jean-Philippe Lang
* *Subproject of*: lets you define the parent project. The projects hierarchy is limited to 2 levels. A parent project cannot be itself a sub-project. Starting from version version#6 projects can be unlimitedly nested.
17 10 Mischa The Evil
18 7 Jean-Philippe Lang
* *Description*: description that appears on the project overview.
19 1 Jean-Philippe Lang
20 10 Mischa The Evil
* *Identifier*: used by the application for various things (eg. in URLs). It must be unique. Once the project is created, this identifier cannot be modified.
21 1 Jean-Philippe Lang
22 10 Mischa The Evil
* *Homepage*: homepage-link that appears on the project overview.
23 1 Jean-Philippe Lang
24 10 Mischa The Evil
* *Public*: if checked, the project can be viewed by all the users, including those who are not members of the project. If unchecked, only the project members have access to it, according to their role.
25 10 Mischa The Evil
26 10 Mischa The Evil
If there are any custom fields of the type "Project" configured by the administrator, they'll show up behind the "Public"-setting noted above.
27 10 Mischa The Evil
28 10 Mischa The Evil
h3. Trackers
29 10 Mischa The Evil
30 10 Mischa The Evil
Redmine lets you define which of the configured trackers (thus also their respective workflows) you are able to use within this specific project.
31 10 Mischa The Evil
32 10 Mischa The Evil
* *Trackers*: select the trackers that you want to use for issues of the project. Only the administrator can define new trackers.
33 10 Mischa The Evil
34 10 Mischa The Evil
h3. Custom fields
35 10 Mischa The Evil
36 10 Mischa The Evil
* *Custom fields*: select the custom fields (of the type @issues@) that you want to use for issues of the project. Only the administrator can define new custom fields.
37 10 Mischa The Evil
38 10 Mischa The Evil
Note that some of these custom fields can be only configured (e.g. unchecked) if the issue custom field is _not_ defined as a _global_ issue custom field (which can be done by the administrator by checking the "For all projects" checkbox in the custom field create/edit view).
39 10 Mischa The Evil
40 1 Jean-Philippe Lang
h2. Modules
41 1 Jean-Philippe Lang
42 10 Mischa The Evil
This screen lets you choose the modules you want to use for the project. 
43 1 Jean-Philippe Lang
44 10 Mischa The Evil
Disabling a module doesn't delete the associated data. It only prevents users from accessing it. After a module was disabled, it can be re-enabled with all its data.
45 1 Jean-Philippe Lang
You can for example disable 'Issue tracking' module for a single project. Existing issues are not deleted, you will be able to access them if you re-enable the module.
46 1 Jean-Philippe Lang
47 10 Mischa The Evil
Additional modules can be added to the system using [[Plugins|Redmine plugins]]. Plugins can only be installed by the administrator.
48 10 Mischa The Evil
49 1 Jean-Philippe Lang
h2. Members
50 1 Jean-Philippe Lang
51 13 Jean-Philippe Lang
This screen lets you define project members and their roles. You can add a user or a group, with one or multiple role(s) in a given project.
52 10 Mischa The Evil
53 1 Jean-Philippe Lang
h2. Versions
54 8 Mischa The Evil
55 10 Mischa The Evil
Projects versions allow you to track and plan changes. You can assign issues to versions and then view the list of assigned issues for each version on the [[RedmineRoadmap|roadmap]].
56 10 Mischa The Evil
You can also assign a wikipage to a version which will be added to the [[RedmineRoadmap|roadmap]] and the [[RedmineVersion|version overview]].
57 9 Felix Dominguez
58 10 Mischa The Evil
The following properties are configurable for (each of the) versions:
59 10 Mischa The Evil
* *Name*: The text you want to be displayed to identify the version. _This field is required._
60 1 Jean-Philippe Lang
61 10 Mischa The Evil
* *Description*: A short description to describe the version. _This field is optional._
62 1 Jean-Philippe Lang
63 12 Jean-Philippe Lang
* *Status* (added in 0.9): the status lets you control how issues can be assigned to the version:
64 12 Jean-Philippe Lang
65 12 Jean-Philippe Lang
  * open: no restriction (default)
66 12 Jean-Philippe Lang
  * locked: can not assign new issues to the version
67 12 Jean-Philippe Lang
  * closed: can not assign new issues and can not reopen assigned issues
68 12 Jean-Philippe Lang
69 12 Jean-Philippe Lang
70 10 Mischa The Evil
* *Wiki Page*: The name of a wikipage assigned to the version. _This field is optional._
71 1 Jean-Philippe Lang
72 10 Mischa The Evil
* *Date*: The due date for the version to be completed. _This field is optional._
73 1 Jean-Philippe Lang
74 12 Jean-Philippe Lang
* *Sharing* (added in 0.9): this option lets you share the version with other projects, so that issues from these other projects can be assigned to the shared versions. Each version can be shared with:
75 12 Jean-Philippe Lang
76 12 Jean-Philippe Lang
  * subprojects: all the descendant projects
77 12 Jean-Philippe Lang
  * projects in the project hierarchy: ancestors + descendants (needs versions management permission on the root project)
78 12 Jean-Philippe Lang
  * projects in the project tree: root project + all its descendants (same as above)
79 12 Jean-Philippe Lang
  * all projects (can be set by admin users only)
80 12 Jean-Philippe Lang
81 12 Jean-Philippe Lang
Sharing a version of a private project with public projects will make its name visible to everyone.
82 12 Jean-Philippe Lang
83 12 Jean-Philippe Lang
From the versions list, you can click on *Close completed versions* to automatically set the status of all the completed versions (due date reached and no open issues) to _closed_.
84 10 Mischa The Evil
85 1 Jean-Philippe Lang
h2. Issue categories
86 1 Jean-Philippe Lang
87 9 Felix Dominguez
Issue categories let you to organize issues. Categories can for example correspond to the different components of your project.
88 1 Jean-Philippe Lang
89 10 Mischa The Evil
You are able to configure your own set of issue categories for each individual project. It is also possible to auto-assign new issues to a specific user based on the chosen category for newly created issues.
90 10 Mischa The Evil
91 10 Mischa The Evil
The following properties are configurable for (each of the) issue categories:
92 10 Mischa The Evil
* *Name*: The text you want to be displayed to identify the issue category. _This field is required._
93 10 Mischa The Evil
94 10 Mischa The Evil
* *Assigned to*: The project member to who you want to auto-assign newly created issues in this category. _This field is optional._
95 10 Mischa The Evil
96 3 Jean-Philippe Lang
h2. Wiki
97 4 Jean-Philippe Lang
98 10 Mischa The Evil
Each project can have its own wiki. To activate it, give a name for the main page and click 'Save'. You are able to edit the chosen name for the main page here also.
99 4 Jean-Philippe Lang
100 10 Mischa The Evil
Note: starting from unscheduled version version#6 you don't have to activate the main wikipage any longer.
101 10 Mischa The Evil
102 1 Jean-Philippe Lang
h2. Repository
103 3 Jean-Philippe Lang
104 10 Mischa The Evil
A SCM repository can be associated with each project. Once the repository is configured, you can browse it and view the changesets. The changesets also appear in the [[RedmineProjectActivity|Activity view]].
105 10 Mischa The Evil
See [[RedmineRepositories|the following page]] for details about how to configure your repository in Redmine.
106 3 Jean-Philippe Lang
107 3 Jean-Philippe Lang
h2. Forums
108 4 Jean-Philippe Lang
109 10 Mischa The Evil
Each project can have one or more discussion forums. Each forum has the following properties:
110 10 Mischa The Evil
* *Name*: The text you want to be displayed to identify the discussion forum. _This field is required._
111 10 Mischa The Evil
112 10 Mischa The Evil
* *Description*: A short description to describe the subject of the specific forum. _This field is required._