Directory & Settings

General Settings¶

Customize general settings¶

Administrators can access various global level settings found at Directory > Show More > Settings.

On the VNCdirectory homepage, click Directory.
In the left navigation bar, click Show more > Settings.
At the top, click any tab and customize the settings.
Click SAVE.

Tabs¶

General tab¶

Under Settings on the General tab, you can configure the following options.

Application title that is displayed in the top panel of the application.
Welcome text that is displayed on the application start page.
Objects per page options define the options of how many objects (issues, commits, etc.) will be displayed on one page. Default: 25, 50, 100.
Search results per page determines the number of search results that are displayed per page. Default: 20.
The number of search results which are displayed per page. Default: 20.
Days displayed on project activity determines the amount of days of which the project(s) activity is shown per page in the activity tab.
Host name and path defines the hostname of the application.
Protocol used to generate links in email notifications.
Text formatting determines the type of text in the "description" fields of the issues, news, and documents. You can select Textile (default) or Markdown.
Wiki history compression allows to activate compression for wiki history storage (reduces database size). Default: none.
Maximum number of items in Atom feeds defines the maximum number of records contained in Atom feeds. Default: 15.
Cache formatted text allows to save the formatted text in the cache.

Display tab¶

Under Settings on the Display tab, you can configure the following options.

Theme. Choose the custom theme you want to activate for your system.
Default language. Choose the language which you want to activate for your system.
Force default language for anonymous users. Check the box to disable automatic language detection based on browser settings and force default language for anonymous users.
Force default language for logged-in users. Check the box to force default language for logged-in users.
Start calendars on. Choose what date the week starts. The default value is Based on user's language.
Date format. Choose how the date is displayed.
Time format. Choose how time is displayed.
Time span format. Choose what format of timespans (estimated time, spent time, etc) is displayed.
Users display format. Choose how usernames are displayed.
Use Gravatar user icons. Check the box to enable users' Gravatars (globally recognized avatar).
Default Gravatar image. The image to use for users who don't have a Gravatar.
Display attachment thumbnails. Check the box, if you want that thumbnails of attached images are displayed below the list of attached files.
Thumbnails size. The size of thumbnail images in pixels when the "Display attachment thumbnails" option is enabled. Default: 100.
Project menu tab for creating new objects. Allows adding a tab for creating new objects to the tab menu of your projects.

Authentication tab¶

Under Settings on the Authentication tab, you can configure the following options.

Authentication required. If you select Yes, no page of the application will be visible to the general public without logging in. Default: No.
Autologin. This option lets users use the auto-login feature. Default: Disabled.
Self-registration. Select one of the following options:
- disabled means users are not allowed to register.
- account activation by email means the user receives an email and needs to confirm the activation.
- manual account activation means that a system administrator needs to manually activate the newly registered user.
- automatic account activation means the new users can log in as soon as they have registered.
Show custom fields on registration. If enabled, non-mandatory custom user fields will also appear on the registration form. If a custom user field is marked as "required", it will appear in the form regardless of this option.
Minimum password length. Define the minimum length of the password.
Require password change after. Choose the maximum password age from 6 options between 7 and 365 days.
Allow password reset via email. If enabled, you give users the ability to change or reset their password by email.
Allow OpenID login and registration. Provides the admin a way to disable OpenID logins and registrations.
Under the Session expiration section, you can define:
- Session maximum lifetime.
- Session inactivity timeout.

API tab¶

Under Settings on the API tab, you can configure the following options.

Enable REST web service. Check the box to work with VNCdirectory API.
Enable JSONP support. Check the box to get results not only in XML, but in JSON also.

Projects tab¶

Under Settings on the Projects tab, you can configure the following options.

New projects are public by default means that users who don't have an account can access the project without login.
Default enabled modules for new projects. Check the box next to the modules that will be activated for newly created projects.
Default trackers for new projects. Check the box next to the trackers to be part of newly created projects.
Generate sequential project identifiers. This setting will let VNCdirectory propose sequential project identifiers for you.
Role given to a non-admin user who creates a project. Select which role is given by default to a non-admin user who creates a project. This makes sense when a user receives permission to create a new project via a global role.

Users tab¶

Under Settings on the Users tab, you can configure the following options.

Users required fields. Check the box next to the field you want to make mandatory while creating a new user.
DOB start year means that you can define the start year of birth.
Maximum number of additional email addresses means that you can define the maximum number of additional email addresses.
Storage quota** means the amount of space a user has to store files.
Allow users to delete their own account. If enabled, a user can delete their own account.
Hide my email address. If enabled, there is an option to keep the email address private.
Default notification options. Define the events about which users will be notified by email.
Time zone. Define the time zone that will be applied to all user profiles.

Issue tracking tab¶

Under Settings on the Issue tracking tab, you can configure the following options.

Allow cross-project issue relations. If enabled, relations between issues from different projects can be created. Default: No.
Link issues on copy. Depending on this option, a copied issue will contain a link to the original one. If this is set to "Ask", upon copying the user will have the option to choose.
Allow cross-project subtasks. Define some limits for subtasking. Options are:
- disabled: a parent task can only have subtasks in the same project.
- With all projects: a parent task can have subtasks in any other project.
- With project tree (default): a parent task can have subtasks in the same project, ancestor projects, and all their descendants (e.g. also "sibling projects", "cousin projects", etc.).
- With project hierarchy: a parent task can have subtasks in the same project, subprojects, or ancestor projects.
- With subprojects: a parent task can only have subtasks in the same project or subprojects (not in parent projects or unrelated projects).
Close duplicate issues automatically. If enabled, duplicated issues will be closed automatically.
Allow issue assignment to groups. If enabled, the Assignee of an issue can also be a user group, instead of a single user only.
Use current date as start date for new issues. If enabled, the Start date field in the new issue creation form will initially have the current date, otherwise it will not specify a date.
Display subprojects issues on main projects by default. If enabled, subproject issues will be displayed by default on the issue list, calendar, and Gantt of the main projects. Default: Yes.
Calculate the issue done ratio with. Define how the Issue Done Percentage is set.
Non-working days. Select non-working days of the week.
Issues export limit. the Maximum number of issues contained in CSV and PDF exports. Default: 500.
Maximum number of items displayed on the Gantt chart. Gantt chart of the project will display up to so many items. If there are more, they will be truncated.
Under the Parent tasks attributes section, you can set:
- Start date/ Due date: The start date of the parent task will be set to the earliest one among the subtasks. The due date of the parent task will be set to the latest one among the subtasks.
- Priority: The priority of the parent task will be set to the highest priority among non-closed subtasks.
- % Done: The % Done of the parent task will be proportional to the number of subtasks closed.
Under the Issues list defaults section, you can define default columns displayed on the issue list. The Totals checkboxes, Estimated time and Spent time, cause a respective total of all issues on the page to be displayed in the upper right corner of the table.

Time tracking tab¶

Under Settings on the Time tracking tab, you can configure the following options.

Required fields for time logs. Check the box next to the time log components you want to make mandatory.
Required fields for time logs. Check the box next to the time log components you want to make mandatory.
Maximum hours that can be logged per day and user. Define the maximum number of hours per day for a user.
Accept time logs with 0 hours. If the box is checked, you allow users to log zero hours.

Files tab¶

Under Settings on the Files tab, you can configure the following options.

Maximum attachment size. Define the maximum size of uploaded files.
Allowed extensions. Specify allowed extensions for file uploads (multiple values allowed, comma separated). If a user attempts to upload a file with another extension a prompt will appear and the attempt will fail. Leave empty to allow all extensions.
Disallowed extensions. Specify disallowed extensions for file uploads (multiple values allowed, comma separated). If a user attempts to upload a file with an extension of this list a prompt will appear and the attempt will fail. Leave empty to allow all extensions.
Maximum size of text files displayed inline. Use this to limit the maximum size of text files that are displayed inline.
Max number of diff lines displayed. Use this to limit the maximum number of diff lines that are displayed by Redmine.
Attachments and Repositories encodings. This option lets you specify preferred encodings for repository files (multiple values allowed, comma separated).

Email notifications tab¶

Under Settings on the Email notifications tab, you can configure the following options.

Emission mail address. Email address that will appear in the "From" field of notification messages sent to users.
Blind carbon copy recipients (bcc). If enabled, an email notification will be sent as a Blind carbon copy.
Plain text mail. If enabled, emails are sent in plain text only (no HTML).
Under the Select actions for which email notifications should be sent section, you can select the event about which you want to be notified by email.
Emails header. Enter some text that will appear at the beginning of the emails sent by the application.
Emails footer. Enter some text that will be appended to the emails sent by the application.

Incoming emails tab¶

Under Settings on the Incoming emails tab, you can configure the following options.

Truncate emails after one of these lines. Use this setting to remove signatures from incoming emails. You can also check the box next to *Enable regular expressions and use regular expressions to specify sets of lines at once.
Exclude attachments by name. Use this field to create a blacklist for attachments that will be removed from the message.
Incoming email WS API key. Generate a secret key used for the issue creation or comments via the email feature.

Registration notification tab¶

Under Settings on the Registration notification tab, you can configure the following options.

Notify administators on registrations means that when a new user registers, a short email with basic user info will be sent to all administrators.