# General Translation Integrations: Avvio rapido
URL: https://generaltranslation.com/it/docs/integrations/payload/quickstart.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Installa gt-payload, aggiungi il plugin a Payload CMS e traduci il tuo primo documento localizzato.

Il plugin `gt-payload` aggiunge controlli di traduzione alle collection e ai global di Payload CMS e traduce i campi localizzati nelle impostazioni regionali definite nella config di Payload.

## Prima di iniziare [#before-start]

Requisiti:

* Payload CMS 3.90.0 o versione successiva con `localization` configurato
* Next.js 15.2.9 o versione successiva
* React 19.0.1 o versione successiva
* Un [ID progetto](/docs/platform/dashboard/get-started) General Translation e una [chiave API del progetto](/docs/platform/dashboard/reference/api-keys#create-project-keys) con autorizzazioni **All**
* Almeno un campo con `localized: true`

## Avvio rapido [#quickstart]

### 1. Installa `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. Configura la localizzazione

Configura le impostazioni regionali di origine e di destinazione nella config di Payload, quindi contrassegna come localizzato ogni campo che vuoi tradurre.

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

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

Il plugin non modifica una config in cui la localizzazione di Payload non è configurata.

### 3. Aggiungi il plugin

Aggiungi [`gtPlugin`](/docs/integrations/payload/reference/plugin-configuration) all&#39;array `plugins`.

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

export default buildConfig({
  // ... la tua configurazione esistente
  localization: {
    locales: ['en', 'es', 'fr'],
    defaultLocale: 'en',
  },
  plugins: [gtPlugin()],
});
```

### 4. Imposta le credenziali

Imposta l&#39;ID progetto e la chiave API del progetto sul server su cui è in esecuzione Payload:

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

Non esporre `GT_API_KEY` nel codice lato client e non includerla nei commit del sistema di controllo versione.

### 5. Aggiorna Payload

Rigenera la import map in modo che il pannello di amministrazione possa caricare i componenti del plugin:

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

Il plugin aggiunge delle collection per le esecuzioni di traduzione e per i lock. Con PostgreSQL o SQLite, crea e applica una migrazione come faresti per qualsiasi altra modifica allo schema di Payload:

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

### 6. Traduci un documento

1. Avvia Payload e apri il pannello di amministrazione.
2. Apri un documento o un global con campi localizzati.
3. Salva le eventuali modifiche in sospeso.
4. Scegli **Translate**.
5. Seleziona una o più impostazioni regionali di destinazione, quindi scegli **Translate into …**.

Il plugin scrive ogni risultato nell&#39;impostazione regionale corrispondente di Payload. Se le bozze sono abilitate, salva una bozza; in nessun caso pubblica il contenuto tradotto.

## 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.