Skip to content

Language configuration and timezone

Jonas Breder edited this page Jun 23, 2026 · 3 revisions

Language configuration

The user interface of hroot can be used in different languages. System defaults are defined in config/application.rb and environment files, but administrators can also manage languages and translate strings dynamically directly within the web UI.

File-Based Configuration (System Setup)

Developers and system administrators can customize the available locales in the backend via config/application.rb:

config.locales = [:en, :de]
config.locale_names = {:en => 'English (en)', :de => 'Deutsch (de)'}

If you only want to provide an English user interface, change this to:

config.locales = [:en]
config.locale_names = {:en => 'English (en)'}

You can set the default locale with:

config.i18n.default_locale = :en   # English as default

or:

config.i18n.default_locale = :de   # German as default

When a user visits hroot for the first time, the default locale is chosen. The language choice of the user is stored in a cookie, in case the user opts for a different locale.

UI-Based Language Management & Live-Edit Mode

Administrators can configure translations dynamically via the Site Settings under the Translations & Languages tab.

  • Manage & Add Languages: Add new languages (such as Spanish or French) by providing a locale code, native name, and selecting a template language to copy strings from. Custom languages can be activated/deactivated, renamed, or deleted directly in the UI.
  • Live-Edit Mode: Allows administrators to translate UI elements in real-time. When enabled, pencil icons appear next to translatable strings. Clicking them opens an interface where you can save changes as a Database Override or write them directly into the underlying YAML locale files.

For a detailed setup guide, see the Translations & Languages section on the Settings page.

Time zone of the server

You can set the timezone of the server with

config.time_zone = 'Berlin'

You can run rake time:zones:all to see all possible time zone values.

HROOT - Hamburg Registration and Organization Online Tool

  1. Installation

    1. System Requirements and Prerequisites

    2. Docker (precompiled)

    3. Docker (self-compiled)

    4. Manual Deployment

    5. First steps after installation

    6. Environment Configuration

    7. Backup and Maintenance

    8. Starting a local server and running automated tests

    9. Basic configuration

    10. Language configuration and timezone

    11. Custom field definitions

  2. Updating an existing installation

  3. Overview

    1. Roles: Users, Admins, Experimenters, Banking‐Administrators
    2. Experiments, Sessions, session types
  4. Subject pool and user management

    1. Browsing the pool
    2. Exporting data
    3. Adding users
    4. Deleting users
    5. Finding duplicate users
    6. More user management
  5. Experiment management

    1. Managing Experiments
    2. Adding Sessions
    3. Experiment and Session Inheritance
    4. Reserving locations (booking)
    5. Assign participants from the pool
    6. Inviting participants
    7. Session management
    8. Waiting list
    9. Invitations Scheduling and Digests
  6. Admission

    1. QR Code Admission
    2. Online Waiting Room
    3. Online Surveys and Completion Links
  7. Calendar

  8. Sending messages

    1. Invitation emails
    2. Confirmation emails
    3. Session reminder emails
    4. Default locale and date formats
    5. SMS and Push Notifications
  9. Settings

    1. Shibboleth Integration
    2. Kimai Integration
  10. Staff Management

  11. Finance

  12. Pools Management

Clone this wiki locally