Administration

User Administration

Users can be administered on the administration page accessible through the Users menu.

Existing users can be deleted using the actions column on the far right side. In addition users can be promoted to administrators by activating the corresponding “Admin” checkbox. It is possible to set a user "inactive" by toggling the corresponding checkbox.

Bildschirm­foto 2023-01-31 um 10.41.11.png

On this page it is also possible to create new users by expanding the “Create user” section:

It is necessary to provide the name, E-mail address and a password for the new user. We recommend to use the random password generator next to the password field to always generate unique new passwords for every new user. By activating the “Admin” checkbox, a new user can instantly be promoted to the administrator role.

Claiming Admin Rights

Administration

image.png

By default, no administrator is defined for every new titra instance setup. However, if no administrator is currently defined, every registered user on that instance can manually claim admin rights (first come, first serve). This is done to prevent bots claiming admins rights from newly created titra instances in cloud environments before the owner can do it. Additional users can be promoted to admins using the User administration.


Claim Administrator Rights

If you are a long time titra user (i.e. before version 0.9.X), you might have already registered a user. Or, you might have removed the admin flag from your own user. Luckily, there is a way out of this deadlock – whenever there are no admin users registered on a titra environment, you will be able to (re-) claim admin rights using the relative url /claim/admin. However, if a user tries to claim admin rights when there is already another admin user, the following warning will be displayed:

Global Settings

The titra Global settings (defaults) are available in the user menu > Administration.


All settings are defaults which can be overruled by user specific settings. They can be currently either of type Number or String. No validation of values is taking place so it is up to the administrator to use proper values.

By entering a request in the search bar, in this example "Date" the corresponding Settings-Block is displayed:

Bildschirm­foto 2023-01-31 um 10.48.37.png

Customization Settings

image.png

Here the admin can customize several settings, for example it is possible to integrate Custom CSS or HTML Data.

The Custom logo setting allows an admin to provide a URL or Data URI to replace the default titra logo, an example is depicted in the screenshot above.

Inserting a Custom Place Holder Content, will use the specified place holder content on the overview page in a dedicated card underneath "All projects".

This setting is followed by 4 Options that can be turned on/off by the toggle (grey = off, green = on) 

If you wish to reset a single input, clicking on the reset button in the desired line, will do the trick:

Bildschirm­foto 2023-01-31 um 10.12.10.png

Date Settings

Bildschirm­foto 2023-01-31 um 12.53.25.png

This will setup the default data shown in the users titra. See the following point, for all formatting options:

Date formats

titra uses dayjs under the hood and thus supports all formatting options listed in the Format (opens in a new tab)” rel=”noreferrer noopener” class=”rank-math-link”>Display > Format section.

E-mail

Bildschirm­foto 2023-01-31 um 12.59.47.png

The mail addresses can be configured under this setting option.

Globals

Bildschirm­foto 2023-01-31 um 13.01.21.png

The admin can set a default Cost Unit and choose if public projects will be displayed or not.
Most used cost symbols are:  $ ¥ £ € ¢ ¤


Holidays

Bildschirm­foto 2023-01-31 um 13.08.33.png

These fields are filled in with the legal holidays of the country, the users are working in, they should be filled in accordingly by the administrator.

Interfaces

Bildschirm­foto 2023-01-31 um 13.10.19.png

Here the different Interface Integrations can be toggled on and off. 

How to set up the different Interfaces can be found here: Gitlab, Zammad, Wekan.

Login

Bildschirm­foto 2023-01-31 um 13.19.43.png

Login specifics are configured in this section.  -> --------- -<

Security

Bildschirm­foto 2023-01-31 um 13.23.45.png

The X-Frame-Options HTTP response header can be used to indicate whether or not a browser should be allowed to render a page in a <frame> , <iframe> , <embed> or <object>. Use this to avoid click-jacking attacks, by ensuring that their content is not embedded into other sites.

https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Frame-Options?retiredLocale=de

Time tracking

Bildschirm­foto 2023-01-31 um 13.29.26.png

Admins can change the number of projects/tasks displayed in the project/task section (default is 5).

The timetracking rule for creation and modification is set to true  by default. 

Theres also an option to Track the start time of users.

User defaults

Bildschirm­foto 2023-01-31 um 13.37.00.png

User default settings can be customized in this section, see the following link for format options: Date formats

Workingtime view defaults

Bildschirm­foto 2023-01-31 um 13.44.41.png

This last configurable section deals with the working time view default settings. Seen above are the default values, these can be changed by the administrator to better fit the users working and break times.

It is always possible to revert back to the default values using the “Reset” button.

Do not forget to save changes made by clicking the "Save" button before exiting the administration page.

Environment Information

Users with the administrator role can view interesting information about the host environment using the About page in the user menu:

Bildschirm­foto 2023-01-31 um 14.28.21.png

Under the option 'titra changelog' you can display more details about the current version:

This information includes the runtime information of the software used (versions) as well as information about the operating system, uptime and total/free memory. The titra changelog can be retrieved on demand directly from GitHub to stay up to date with the latest developments/releases of titra.

Pro tipp: if you care about performance, make sure that (OpLog enabled) is displayed next to the MongoDB version. If this is not the case you can for example refer to this guide.

@faburem

Bildschirm­foto 2023-01-31 um 14.23.02.png

Interfaces

Interfaces

Siwapp Invoice Export




Interfaces

Zammad Ticket Import



Interfaces

Wekan Kanban Board Cards Import

Interfaces

GitLab Issues Import

Titra requires an API token for GitLab which can be created in the top right user menu and selecting the Preferences entry:

image.png

In the User Settings, navigate to Access Tokens and create a new Personal Access Token. Titra requires one of the scopes read_api or read_user. Both will work but obviously offer different degrees of access rights in regards to issue data.

image.png

After the API token has been created, it can be added in titra in the Settings menu.

image.png

At the bottom, in the "Integrations" section, the GitLab Instance URL (e.g. https://gitlab.com/) can be specified along with the GitLab API token created before.

image.png

The GitLab interface is working for both self-hosted and SaaS versions of GitLab, for self-hosted instances make sure the CORS headers are set properly to allow API connections from your titra host.

Custom Fields


In the Custom fields page of the Administration menu, new custom fields can be created by the administrator.

Bildschirm­foto 2023-01-31 um 14.33.17.png

First of all, a class for the new field has to be chosen, the options are: Project or Time entry:

Bildschirm­foto 2023-01-31 um 14.34.55.png

After selecting the class, the fields for Name, Description, Type and Possible values have to be filled in.

No spaces or special characters are allowed for the Name!

Bildschirm­foto 2023-01-31 um 14.38.09.png

By clicking on "Create", the new custom field will be displayed, as shown below

bildschirmfoto-2023-01-31-um-14-42-47.png

It is possible to edit and delete a created custom field by clicking on the corresponding icon under the Actions Section