Deutsch
|
English

PORTALTITLE - Detailed description

FM-Portal

IC12619
FM-Portal

Overview

Parameters: PORTALTITLE
Category: Custom
Default value: "" (empty)
Product: eTASK.Other (Custom)


What does this parameter do?

This parameter defines the text displayed as the main heading in the upper-left area of the portal. If the parameter is empty or has not been set, the portal automatically displays the current version number. The text appears prominently in the header and is also used as the browser tab title and in SAML authentication dialogs.


What is this parameter used for?

  • Displaying a custom portal name instead of the version number

  • Branding the portal with a company name or project name

  • Customizing the browser tab label for better identification

  • Defining the description in SAML authentications

  • Distinguishing between multiple portal instances using custom names


Technical Details (for Administrators)

Format: Free text (string)
Default value: "" (empty)

Important notes:

  • If the value is empty, the current portal version is displayed automatically (e.g., "eTASK.FM Portal 10.5.0")

  • Leading and trailing spaces are automatically removed from the text

  • The parameter affects multiple display areas simultaneously (header, browser tab, SAML)

  • Changes will only become visible after logging in again or reloading the page

  • HTML tags are not interpreted but displayed as plain text

  • The text should be short and concise for optimal display in the header

Interaction with other parameters:

  • INFOLOGIN: Defines the welcome text on the login page (separate function, no connection to PORTALTITLE)

  • HEADER_ALIGN: Controls the alignment of the header (may affect the display of the title)


When should you change this value?

Fill in the value (display custom title) if:

  • The portal is to be individually branded

  • A specific company name or project name needs to be displayed

  • Multiple portal instances are operated in parallel and must be distinguishable

  • The version number should not be prominently visible

  • A consistent corporate design is to be implemented

  • Users should be able to identify the portal more easily in browser tabs

Leave this field blank (display version number) if:

  • The current portal version should be prominently visible

  • No specific branding is required

  • Support requests should be facilitated with version information

  • The default appearance should be retained

  • Development or test environments should be clearly identifiable as such


Important Notes

  1. Multiple uses
    The parameter is used in several places within the portal: header logo, browser tab title, SAML description, and social media metadata. A change affects all of these areas.

  2. Changes take time to appear
    After changing the parameter, users must log in again or fully reload the page for the change to take effect. Users who are already logged in will continue to see the old value.

  3. Fallback to version number
    If the parameter is empty, the portal automatically displays the version number. This is intentional fallback behavior and not a malfunction.

  4. Note the length
    Very long texts can interfere with the display in the header and may be truncated. A maximum of 30 characters is recommended for optimal readability.


Security

Does changing this parameter affect security?

No, this parameter has no direct security implications.


Practical example

Initial situation:
A company operates the eTASK FM portal with the current version 10.5.0. The header reads "eTASK.FM Portal 10.5.0." The company wants to brand the portal with its own company name and make the version number less prominent. Several employees have different browser tabs open and cannot clearly identify the portal.

Configuration:
The administrator sets the PORTALTITLE parameter to:
"FacilityPro - Beispiel GmbH"

After the change:

  • The header now displays "FacilityPro - Example Inc." instead of the version number

  • Browser tabs have the unique title "FacilityPro - Example Inc."

  • SAML dialogs display the company name as the description

  • The portal looks more professional and tailored to the company

  • Employees can immediately identify the portal in their browser tabs

Result:
The portal is now clearly branded and more easily identifiable for users. The version number remains available in the system information but is no longer prominently visible in the header.


For standard installations: "" (blank) or custom company/project name

Reason:

  • In development and test environments, displaying the version number is helpful for support and debugging

  • In production environments with multiple clients or instances, a custom title improves clarity

  • The empty default value automatically displays the version and is informative for technical teams

Exceptions (custom title recommended):

  • Production environments with external users or customers

  • Multi-tenant scenarios with multiple portal instances

  • Companies with strict corporate design requirements

  • Environments where version numbers should not be visible

Tip: Keep the title short and meaningful. Combinations such as "Company Name - Portal" or "Project Name FM" work well. Avoid very long texts exceeding 30 characters.

War dieser Artikel hilfreich?