# Helpdesk translation

## **Feature Presentation**

The **"Helpdesk translations"** feature is a major new addition in GLPI 11 that allows for the translation of all customizable elements of the helpdesk interface into different languages. This feature is particularly useful for multinational organizations with users speaking various languages.

## **Translatable Elements**

This feature allows for the translation of:

1. **Helpdesk Tiles**:
   * Custom tile titles
   * Tile descriptions
   * Rich text content of tiles
2. **Entity Configuration**:
   * Custom titles for the helpdesk homepage
   * Custom welcome messages
   * Other entity-configurable texts
3. **Embedded Forms**:
   * Titles and descriptions of forms linked to tiles

## **Accessing the Feature**

### **Prerequisites**

* Administration rights on GLPI
* Access to the **Configuration** menu
* At least one alternative language configured in GLPI

### **Navigation**

1. Log in to GLPI as an administrator
2. Navigate to the **Configuration** menu
3. Click on **General**
4. Select the **"Helpdesk translations"** tab

<div align="left"><figure><img src="https://3503800744-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIiEHKRx5AeABNDLcRlWX%2Fuploads%2FdosNxYXacL1aKg5XzUIs%2Fhelpdesk-translation.png?alt=media&#x26;token=298895f6-8dc5-4908-92c3-566085d4c6e1" alt="" width="563"><figcaption><p>Access to translations Helpdesk</p></figcaption></figure></div>

## **Translation Management Interface**

### **Overview**

The helpdesk translation interface is presented as a table listing:

* **Language**: The translation language with its full name
* **Translated**: Percentage of translation completed (progress bar)
* **Translations to do**: Number of untranslated items
* **Obsolete translations**: Number of translations to review

<figure><img src="https://3503800744-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIiEHKRx5AeABNDLcRlWX%2Fuploads%2FkTO6TM1M4IiDbFZoCImr%2Fview_translation.png?alt=media&#x26;token=ed9060c4-ef31-449c-af99-42a98caf8777" alt=""><figcaption><p>Main translation interface</p></figcaption></figure>

### **Adding a Language**

The **"Add language"** button at the top of the interface allows you to initiate translation for a new language.

### **Procedure for Adding a New Language**

### **Language Selection**

1. Click the **"Add language"** button
2. A modal window opens with a dropdown list
3. Select the desired language from the list
4. Click **"Add"**

<figure><img src="https://3503800744-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIiEHKRx5AeABNDLcRlWX%2Fuploads%2FHBEnWOhMaXFYRwe1LozI%2Fadd_translation.png?alt=media&#x26;token=8fdf03d3-b06a-44b7-9fdd-63514cd02426" alt=""><figcaption><p>Language addition method</p></figcaption></figure>

{% hint style="info" %}
Only languages not yet configured for translations appear in the list.
{% endhint %}

### **Creating Initial Translations**

Once the language is added:

* GLPI automatically creates empty translation records
* The language appears in the main table
* The status indicates 0% translation completed
* All translations are marked as "to do"

### **Translating Elements**

#### **Accessing the Translation Interface**

1. In the main table, click on the **language name** you wish to edit
2. A modal window opens with the detailed translation interface

<figure><img src="https://3503800744-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIiEHKRx5AeABNDLcRlWX%2Fuploads%2F6xn7NuD5ABUBLdfEJP99%2Ftranslation_elements.png?alt=media&#x26;token=3a776119-2ca5-454f-8935-ad57bc6d006b" alt=""><figcaption><p>Detailed translation interface</p></figcaption></figure>

#### **Structure of the Translation Interface**

The translation interface is organized in a table with three columns:

1. **Type/Name**: Description of the element to be translated
2. **Default (\[default language])**: Original value in GLPI's default language
3. **\[Target Language]**: Input field for the translation

**Categories of Translatable Elements**

Elements are grouped by categories:

**Entities**

* **Custom homepage title**: Title displayed at the top of the helpdesk page
* **Welcome message**: Custom welcome text (rich text)

**Helpdesk Tiles**

For each configured tile:

* **Title**: Title displayed on the tile
* **Description**: Description displayed below the title (rich text possible)

**Other elements**

Depending on the configuration, other elements may appear (forms, etc.)

#### **Entering Translations**

**Simple Text Fields**

1. Click in the target language translation field
2. Enter your translation
3. The text is automatically saved upon submission

**Rich Text Fields (with editor)**

1. Fields with a rich text editor allow for formatting
2. Use the editor's tools to format the text
3. You can include links, bold, italics, etc.

<figure><img src="https://3503800744-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIiEHKRx5AeABNDLcRlWX%2Fuploads%2FTEUqSpyet37VnTBifsed%2Frich_text.png?alt=media&#x26;token=b0f13250-7dcd-46b4-ba51-f3a7829da38a" alt=""><figcaption><p>Example of seizures</p></figcaption></figure>

#### **Result Example**

<figure><img src="https://3503800744-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIiEHKRx5AeABNDLcRlWX%2Fuploads%2F3gHZcbIQYxwBCcOvaStF%2Fexample.png?alt=media&#x26;token=924cba8b-ba19-4208-80cc-50886956c2ac" alt=""><figcaption><p>Tiles translated in the Helpdesk</p></figcaption></figure>

#### **Visual Indicators**

**Obsolete Translations**

* A yellow ⚠️ icon appears next to fields whose default value has changed since the last translation
* A tooltip indicates: "The default value has changed since the last translation"
* These translations need to be reviewed

<figure><img src="https://3503800744-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIiEHKRx5AeABNDLcRlWX%2Fuploads%2FMh33wW1vPKuEx2LBQF7F%2Fobsolete_translation.png?alt=media&#x26;token=0fc7f392-bc0b-43cf-860b-55a018e7418c" alt=""><figcaption><p>Obsolete translation</p></figcaption></figure>

### **Deleting a Translation Language**

### **Deletion Procedure**

1. Open the translation interface for the language to be deleted
2. Click the **"Delete"** button (trash can icon)
3. All translations for this language will be permanently deleted

<figure><img src="https://3503800744-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIiEHKRx5AeABNDLcRlWX%2Fuploads%2FHCWrEkVIdx4JqnabBc29%2Fdelete_translation.png?alt=media&#x26;token=1f687364-2b52-4720-b8c0-b5487db3631f" alt=""><figcaption><p>Delete button</p></figcaption></figure>

{% hint style="danger" %}
This action is irreversible. All translations for the language will be lost.
{% endhint %}