# Lingue degli ospiti e traduzioni

Il portale ospiti parla otto lingue: **English, Deutsch, Italiano, Français, Español, Nederlands, Polski e Malti**.

## Come viene scelta la lingua

- Il portale si apre nella lingua dello smartphone o del browser dell'ospite.
- Se quella lingua non è disponibile, viene usato l'inglese.
- Gli ospiti possono cambiare lingua in qualsiasi momento con il pulsante della lingua in alto nel portale; la scelta viene ricordata su quel dispositivo.

Date e importi usano il formato dell'ospite; in maltese le date sono scritte in maltese.

## Cosa viene tradotto

- **Sempre** — ogni schermata, pulsante e messaggio del portale, il modulo di check-in online, i passaggi di pagamento e i testi standard di Guestbud (spiegazioni su deposito cauzionale ed eco-contribution, tipi di rifiuti, consigli predefiniti).
- **I tuoi testi** — messaggio di benvenuto, istruzioni di arrivo, consigli sul Wi-Fi, regole della casa, consigli locali, extra e altro — una volta tradotti automaticamente o da te.

I testi senza traduzione vengono mostrati in inglese.

## Tradurre la tua guida del soggiorno

1. Apri **Properties → Guide editor → Translations** (Strutture → Editor guida → Traduzioni).
2. Scegli una lingua. Ogni testo è elencato con l'originale inglese e uno stato:
   - **Automatic** — tradotto dalla piattaforma;
   - **Edited by you** — scritto o corretto da te;
   - **Built in** — traduzione di Guestbud di un testo standard;
   - **English changed — check** — il testo inglese è cambiato dopo la traduzione;
   - **Not translated — shown in English** — non tradotto, mostrato in inglese.
3. Scrivi o correggi le traduzioni e clicca **Save**. Le tue traduzioni non vengono mai sovrascritte automaticamente.
4. Clicca **Translate missing automatically** (indica quante ne mancano) per colmare le lacune (solo se l'operatore della piattaforma ha configurato la traduzione automatica).

Se la traduzione automatica è configurata, i testi nuovi e modificati vengono tradotti in background ogni volta che salvi la guida.

## Per gli operatori della piattaforma

La traduzione automatica si configura una sola volta per la piattaforma in **Admin → Translation**: Google Cloud Translation, DeepL (senza maltese) o Anthropic Claude, con una chiave API conservata in forma cifrata.

## Tramite API

`GET`/`PUT /api/v1/properties/{id}/translations` e `POST /api/v1/properties/{id}/translations/auto`. Invia l'header `X-GP-Lang: de` per ricevere la vista ospite in una determinata lingua. Vedi il [riferimento API](/developers/api).

## Domande frequenti

### In quale lingua devo scrivere la mia guida?

In inglese. Le traduzioni vengono generate a partire dai tuoi testi in inglese.

### Posso disattivare una lingua?

Al momento no — gli ospiti vedono sempre i testi di Guestbud nella propria lingua; i tuoi testi restano in inglese finché non vengono tradotti.