# General Translation Integrations: Contenuti supportati
URL: https://generaltranslation.com/it/docs/integrations/payload/reference/supported-content.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Scopri quali campi di Payload CMS vengono tradotti, mantenuti invariati o ignorati dal plugin. Riferimento per i contenuti supportati da gt-payload.

Il plugin scorre lo schema appiattito dei campi di Payload e traduce solo il testo localizzato. Mantiene la struttura dei campi, così da poter salvare nuovamente i risultati tramite la Local API di Payload.

## Panoramica [#overview]

| Argomento                                      | Descrizione                                                               |
| ---------------------------------------------- | ------------------------------------------------------------------------- |
| [Campi tradotti](#translated-fields)           | Valori localizzati di tipo text, textarea e testo ricco.                    |
| [Contenuti annidati](#nested-content)          | Gruppi, schede, array, blocchi e blocchi di testo ricco.                  |
| [Campi mantenuti invariati](#preserved-fields) | Valori copiati o lasciati invariati.                                      |
| [Esclusione dei campi](#field-opt-out)         | Configurazione per singolo campo per escludere il testo dalla traduzione. |
| [Limiti di caratteri](#character-limits)       | Gestione della lunghezza in Payload e per la SEO.                         |
| [Comportamento del salvataggio](#save-behavior) | Comportamento di bozze, salvataggio diretto e pubblicazione.              |

## Campi tradotti [#translated-fields]

Il plugin traduce i valori non vuoti dei seguenti campi localizzati:

* campi `text`, incluse le liste `hasMany`
* campi `textarea`
* campi `richText` di Lexical

L'impostazione locale predefinita di Payload costituisce la sorgente. Ogni altra impostazione regionale supportata e configurata può essere una destinazione di traduzione.

Il testo rimosso dalla sorgente viene eliminato dall'impostazione regionale tradotta alla successiva esecuzione. Per un'impostazione regionale senza una destinazione richiesta o priva di testo di origine traducibile non viene avviato alcun job di traduzione.

## Contenuto annidato [#nested-content]

I campi traducibili possono trovarsi all'interno di:

* Gruppi e schede con nome
* Array
* Blocchi, inclusi i riferimenti a blocchi
* Campi di blocco e di blocco inline di Lexical

I contenitori localizzati mantengono righe distinte per ciascuna impostazione regionale. Gli array e i blocchi condivisi abbinano le righe in base all'ID di Payload, così il testo tradotto torna nella riga di origine corrispondente.

## Campi mantenuti invariati [#preserved-fields]

Il plugin non traduce:

* I campi senza `localized: true`, a meno che non si trovino all'interno di un contenitore localizzato
* I campi slug di Payload
* I campi di sola lettura, nascosti o virtuali
* I valori `text` riconosciuti come percorsi, URL o indirizzi email (`textarea` e il testo ricco vengono tradotti così come sono)
* I tipi di campo non testuali, come relazioni, upload, date, numeri, caselle di controllo e JSON
* I metadati delle righe di Payload, come gli ID e i nomi dei tipi di blocco

I campi obbligatori non tradotti ricevono il valore di origine quando l'impostazione regionale di destinazione è priva di valore, così che Payload possa salvare l'impostazione regionale. I valori già presenti nell'impostazione regionale di destinazione per i campi mantenuti invariati restano immutati, ove la struttura localizzata di Payload lo consenta.

I nodi di testo ricco conservano annotazioni, link, upload, blocchi e formattazione. Se il markup tradotto non può essere associato in modo sicuro alla struttura del file sorgente, il plugin salta la stringa e segnala `broken_markup`.

## Esclusione dei campi [#field-opt-out]

Imposta `custom.gt.translate` su `false` in un campo per escluderlo dalla traduzione:

```ts title="src/collections/products.ts"
{
  name: 'sku',
  type: 'text',
  localized: true,
  custom: {
    gt: {
      translate: false,
    },
  },
}
```

L'opzione esclude anche i discendenti traducibili quando viene impostata sul campo che li contiene.

## Limiti di caratteri [#character-limits]

Quando una traduzione supera il `maxLength` di un campo, il plugin richiede una traduzione più breve. Se anche questa supera il limite rigido, il plugin la tronca alla fine di una parola e aggiunge il carattere dei puntini di sospensione previsto dall'impostazione regionale.

I campi visualizzati dal plugin SEO di Payload utilizzano questi limiti consigliati:

| Campo            | Lunghezza consigliata | Troncamento rigido                    |
| ---------------- | --------------------- | ------------------------------------- |
| Meta title       | 60 caratteri          | Solo se il campo ha anche `maxLength` |
| Meta description | 150 caratteri         | Solo se il campo ha anche `maxLength` |

I limiti consigliati per la SEO attivano una richiesta di traduzione più breve, ma da soli non comportano alcun troncamento.

## Comportamento del salvataggio [#save-behavior]

Il plugin legge la bozza più recente per l'impostazione regionale di origine e per quella di destinazione, con il fallback dell'impostazione regionale disabilitato. Le scritture avvengono tramite la Local API:

* Se le bozze sono abilitate, salva una bozza.
* Se le bozze non sono abilitate, salva direttamente.
* Non pubblica mai.

Le letture e le scritture avviate dal pannello Admin rispettano le regole di accesso di Payload dell'utente autenticato. Le chiamate programmatiche possono passare un utente Payload per applicare le stesse regole; se non viene passato alcun utente, la Local API di Payload applica il normale comportamento di accesso server-side.

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.