System configuration

In Vocbench the administrator is the only user authorized to manage some "behind the scene" aspects of the application through the "Configuration" page. The same configuration panel is prompted after the first access to Vocbench, once the administrator user has been registered.

The following system configuration settings are available:

SemanticTurkey data folder: shows the path of the SemanticTurkey data folder. This can be absolute or relative to the SemanticTurkey installation folder.
Preload profiler threshold: tells the threshold file size admitted by the preload profiler during the project creation. If unspecified, or 0, the default size is 1048576 bytes (1 megabyte).

Vocbench Email Configuration: configuration of the Vocbench e-mail service: this service is used to send notifications to the administrators and users. This configuration, even if not mandatory, is particularly important as if it is not properly configured, the system will not be able to notify the administrator when a new user is registered, or users will not be able to eventually complete the procedure for retrieving the password in case they forget it.
A Test button is available to check that the provided info are valid.
- Mail SMTP host: the IP/URL of the SMTP mail server;
- Mail SMTP port: the port of the SMTP mail server;
- Cryptographic protocol: the cryptographic protocol being used: allowed values are SSL, TLS or None if not used;
- SSL protocols: specifies the SSL protocols that will be enabled for SSL connections (prompted only if SSL is chosen as Cryptographic protocol);
- Authentication: specifies if the authentication is required in the mail server;
- Mail from address: the email address used to send administration notifications;
- Mail from password: the password of the above email address (required only if Authentication is Yes;
- Mail from alias: the alias name shown in the sent emails.

Notifications schedule configuration: configuration of the VocBench e-mail notification service. This setting determines the time of day when the system will send a notifications daily digest to the users who have chosen the Email daily digest as notification mode (details here). Here, the administrator user can set the Hour of the day and a Time zone, the latter can be automatically detected from the browser. The Submit button confirms the chosen settings, while Disable reset them and disables the daily digest (note: in this way those users who have chosen Email daily digest as notification mode will not receive any email, they will be able to see notifications only through the notification page)

Registration form fields: allows for the customization of the fields describing users. These fields are prompted in the registration form and shown in the user overview.
- Optional fields: hide/show four optional fields (Office address, Phone, Affiliation and Personal URL).
- Custom fields: allows the administrator to define up to four custom optional fields. For each of them it is possible to indicate a label and a description.
- Email verification: tells if a user must verify the email address in order to complete the registration. Note: email verification is never required when registering the administrator user at the first access or when the administrator creates new user from the users administration page.

The following image shows the registration form resulting with the addition of an additional custom field defined as in the previous image.

Home page content: allows for a basic customization of the home page content by providing a HTML-formatted text content. This could be useful in case the system administrator would like to print a message visible to all users.

Here it is an example of home page customized through the Home page content setting. A further way to customize the home page is described here.

Project creation: allows for the configuration of the default value of some options prompted in the project creation form.
- Default for "Universal access level", see ACL documentation for details about this option.
- Default for "Open at startup", see project creation documentation for details about this option.

Enable experimental features: some new and unstable features of Vocbench might be released as experimental. These features are hidden by default. Through this setting it is possible to enable them.