# General Translation Integrations: Démarrage rapide
URL: https://generaltranslation.com/fr/docs/integrations/payload/quickstart.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Installez gt-payload, ajoutez le plugin à Payload CMS et traduisez votre premier document localisé.

Le plugin `gt-payload` ajoute des commandes de traduction aux collections et aux globals de Payload CMS. Il traduit les champs localisés dans les paramètres régionaux définis dans votre configuration Payload.

## Avant de commencer [#before-start]

Prérequis :

* Payload CMS 3.90.0 ou version ultérieure, avec `localization` configuré
* Next.js 15.2.9 ou version ultérieure
* React 19.0.1 ou version ultérieure
* Un [identifiant de projet](/docs/platform/dashboard/get-started) General Translation et une [clé API de projet](/docs/platform/dashboard/reference/api-keys#create-project-keys) disposant de la permission **All**
* Au moins un champ avec `localized: true`

## Démarrage rapide [#quickstart]

### 1. Installer `gt-payload`

<Tabs items={['npm', 'yarn', 'bun', 'pnpm']}>
  <Tab value="npm">
    ```bash
    npm install gt-payload
    ```
  </Tab>

  <Tab value="yarn">
    ```bash
    yarn add gt-payload
    ```
  </Tab>

  <Tab value="bun">
    ```bash
    bun add gt-payload
    ```
  </Tab>

  <Tab value="pnpm">
    ```bash
    pnpm add gt-payload
    ```
  </Tab>
</Tabs>

### 2. Configurer la localisation

Configurez les paramètres régionaux source et cibles dans votre configuration Payload, puis marquez comme localisé chaque champ que vous souhaitez traduire.

```ts title="src/payload.config.ts"
import { buildConfig } from 'payload';

export default buildConfig({
  // ... votre configuration existante
  localization: {
    locales: ['en', 'es', 'fr'],
    defaultLocale: 'en',
  },
  collections: [
    {
      slug: 'pages',
      fields: [
        {
          name: 'title',
          type: 'text',
          localized: true,
        },
      ],
    },
  ],
});
```

Le plugin ne modifie pas une configuration dans laquelle la localisation Payload n&#39;est pas activée.

### 3. Ajouter le plugin

Ajoutez [`gtPlugin`](/docs/integrations/payload/reference/plugin-configuration) au tableau `plugins`.

```ts title="src/payload.config.ts"
import { buildConfig } from 'payload';
import { gtPlugin } from 'gt-payload';

export default buildConfig({
  // ... votre configuration existante
  localization: {
    locales: ['en', 'es', 'fr'],
    defaultLocale: 'en',
  },
  plugins: [gtPlugin()],
});
```

### 4. Définir les identifiants

Définissez l&#39;identifiant de projet et la clé API de projet sur le serveur où s&#39;exécute Payload :

```bash title=".env"
GT_PROJECT_ID=your-project-id
GT_API_KEY=your-project-api-key
```

N&#39;exposez pas `GT_API_KEY` dans le code client et ne la committez pas dans votre système de gestion de versions.

### 5. Mettre à jour Payload

Régénérez l&#39;import map afin que le panneau d&#39;administration puisse charger les composants du plugin :

```bash
npx payload generate:importmap
```

Le plugin ajoute des collections pour les exécutions de traduction et les verrous. Pour PostgreSQL ou SQLite, créez et appliquez une migration comme pour toute autre modification de schéma Payload :

```bash
npx payload migrate:create
npx payload migrate
```

### 6. Traduire un document

1. Démarrez Payload et ouvrez le panneau d&#39;administration.
2. Ouvrez un document ou un global contenant des champs localisés.
3. Enregistrez les modifications en attente.
4. Choisissez **Translate**.
5. Sélectionnez un ou plusieurs paramètres régionaux cibles, puis choisissez **Translate into …**.

Le plugin écrit chaque résultat dans le paramètre régional Payload correspondant. Il enregistre un brouillon lorsque les brouillons sont activés et ne publie jamais le contenu traduit.

## Next steps

- /docs/integrations/payload/guides/translating-content
- /docs/integrations/payload/guides/managing-translations

## Sitemap

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