# General Translation Integrations: Contenu pris en charge
URL: https://generaltranslation.com/fr/docs/integrations/payload/reference/supported-content.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Découvrez les champs Payload CMS traduits, préservés ou ignorés par le plugin. Référence du contenu pris en charge par gt-payload.

Le plugin parcourt le schéma de champs aplati de Payload et traduit uniquement le texte localisé. Il préserve la structure des champs afin que les résultats puissent être réenregistrés via la Local API de Payload.

## Vue d’ensemble [#overview]

| Sujet                                             | Description                                                                   |
| ------------------------------------------------- | ----------------------------------------------------------------------------- |
| [Champs traduits](#translated-fields)             | Valeurs localisées de type texte, zone de texte et texte enrichi.             |
| [Contenu imbriqué](#nested-content)               | Groupes, onglets, tableaux, blocs et blocs de texte enrichi.                  |
| [Champs préservés](#preserved-fields)             | Valeurs copiées ou laissées telles quelles.                                   |
| [Exclusion de champs](#field-opt-out)             | Configuration par champ pour exclure du texte de la traduction.               |
| [Limites de caractères](#character-limits)        | Gestion des longueurs dans Payload et pour le SEO.                            |
| [Comportement à l’enregistrement](#save-behavior) | Comportement des brouillons, de l’enregistrement direct et de la publication. |

## Champs traduits [#translated-fields]

Le plugin traduit les valeurs non vides des champs localisés suivants :

* champs `text`, y compris les listes `hasMany`
* champs `textarea`
* champs `richText` Lexical

Les paramètres régionaux par défaut de Payload servent de source. Chacun des autres paramètres régionaux pris en charge et configurés peut être une cible de traduction.

Le texte supprimé de la source est également supprimé des paramètres régionaux traduits lors de l'exécution suivante. Aucune tâche de traduction n'est lancée pour un paramètre régional sans cible demandée ou sans texte source traduisible.

## Contenu imbriqué [#nested-content]

Les champs traduisibles peuvent se trouver dans :

* Les groupes et les onglets nommés
* Les tableaux
* Les blocs, y compris les références de blocs
* Les champs de blocs et de blocs inline Lexical

Les conteneurs localisés conservent leurs propres lignes pour chaque paramètre régional. Les tableaux et blocs partagés associent les lignes par ID Payload, de sorte que le texte traduit revienne dans la ligne source correspondante.

## Champs préservés [#preserved-fields]

Le plugin ne traduit pas :

* Les champs sans `localized: true`, sauf s'ils se trouvent dans un conteneur localisé
* Les champs slug de Payload
* Les champs en lecture seule, masqués ou virtuels
* Les valeurs `text` reconnues comme des chemins, des URL ou des adresses e-mail (les champs `textarea` et le texte enrichi sont traduits tels qu'ils sont rédigés)
* Les types de champ non textuels, tels que les relations, les fichiers importés, les dates, les nombres, les cases à cocher et le JSON
* Les métadonnées de ligne de Payload, telles que les ID et les noms de types de blocs

Lorsque la locale cible n'a pas de valeur, les champs obligatoires non traduits reçoivent la valeur source, ce qui permet à Payload d'enregistrer la locale. Les valeurs déjà présentes dans la locale cible pour les champs préservés restent inchangées lorsque la structure localisée de Payload le permet.

Les nœuds de texte enrichi conservent les marks, les liens, les fichiers importés, les blocs et la mise en forme. Si le balisage traduit ne peut pas être aligné de manière fiable sur la structure source, le plugin ignore cette chaîne de caractères et signale `broken_markup`.

## Exclusion de champs [#field-opt-out]

Pour exclure un champ, définissez sa propriété `custom.gt.translate` sur `false` :

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

L'option exclut également les descendants traduisibles lorsqu'elle est définie sur le champ qui les contient.

## Limites de caractères [#character-limits]

Lorsqu’une traduction dépasse le `maxLength` d’un champ, le plugin demande une traduction plus courte. Si celle-ci dépasse toujours la limite stricte, le plugin la tronque à la fin d’un mot et ajoute le caractère de points de suspension propre au paramètre régional.

Les champs rendus par le plugin SEO de Payload utilisent les limites recommandées suivantes :

| Champ            | Longueur recommandée | Troncature stricte                                      |
| ---------------- | -------------------- | ------------------------------------------------------- |
| Meta title       | 60 caractères        | Uniquement si le champ possède également un `maxLength` |
| Meta description | 150 caractères       | Uniquement si le champ possède également un `maxLength` |

Les recommandations SEO déclenchent une requête de traduction plus courte, mais n’entraînent à elles seules aucune troncature.

## Comportement à l’enregistrement [#save-behavior]

Le plugin lit le dernier brouillon des paramètres régionaux source et cible, sans contenu de secours entre paramètres régionaux. Il écrit via la Local API :

* Si les brouillons sont activés, il enregistre un brouillon.
* Sinon, il enregistre directement.
* Il ne publie jamais.

Les lectures et écritures déclenchées depuis l'interface d'administration respectent les règles d'accès Payload de l'utilisateur connecté. Les appels programmatiques peuvent transmettre un utilisateur Payload pour appliquer les mêmes règles ; à défaut, la Local API de Payload applique son comportement d'accès server-side habituel.

## Sitemap

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