# General Translation Integrations: Configurazione del plugin Payload
URL: https://generaltranslation.com/it/docs/integrations/payload/reference/plugin-configuration.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Configura il plugin gt-payload di General Translation per Payload CMS. Riferimento API per gtPlugin.

Aggiungi `gtPlugin` all'array `plugins` di Payload. Il plugin legge la configurazione di localizzazione di Payload per determinare l'impostazione regionale sorgente, le impostazioni locali di destinazione e i campi traducibili.

```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()],
});
```

## Opzioni [#options]

| Opzione                            | Descrizione                                                                 | Tipo                                                                  | Facoltativo | Predefinito                          |
| ---------------------------------- | --------------------------------------------------------------------------- | --------------------------------------------------------------------- | ----------- | ------------------------------------ |
| [`projectId`](#project-id)         | ID del progetto General Translation.                                        | `string`                                                              | Sì          | `GT_PROJECT_ID`                      |
| [`apiKey`](#api-key)               | Chiave API del progetto General Translation.                                | `string`                                                              | Sì          | `GT_API_KEY`                         |
| [`customMapping`](#custom-mapping) | Alias delle impostazioni locali e sostituzioni delle proprietà per Payload. | [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) | Sì          | —                                    |
| [`client`](#client)                | Client preconfigurato usato per le richieste di traduzione.                 | [`GtClient`](/docs/integrations/payload/reference/api#gtclient)       | Sì          | Creato a partire dalle altre opzioni |

## `projectId` [#project-id]

**Tipo** `string` · **Facoltativo** · **Predefinito** `GT_PROJECT_ID`

Il progetto utilizzato per il caricamento dei file, i job di traduzione e lo scaricamento. Passalo direttamente solo se il server non riesce a leggere `GT_PROJECT_ID`.

```ts title="src/payload.config.ts"
gtPlugin({
  projectId: process.env.GT_PROJECT_ID,
});
```

## `apiKey` [#api-key]

**Tipo** `string` · **Facoltativo** · **Predefinito** `GT_API_KEY`

La chiave API del progetto utilizzata dal server di Payload. Conservala in una variabile d'ambiente accessibile solo lato server: non includerla mai nel bundle client e non eseguirne il commit nel sistema di controllo di versione.

```ts title="src/payload.config.ts"
gtPlugin({
  apiKey: process.env.GT_API_KEY,
});
```

## `customMapping` [#custom-mapping]

**Tipo** [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) · **Facoltativo**

Associa un codice locale di Payload a un codice supportato da General Translation e può sovrascrivere le proprietà dell'impostazione regionale. Usa la stessa struttura della chiave `customMapping` in [`gt.config.json`](/docs/cli/reference/config#custom-mapping).

```ts title="src/payload.config.ts"
gtPlugin({
  customMapping: {
    cn: {
      code: 'zh',
      name: 'Mandarin',
    },
  },
});
```

Il pannello di amministrazione continua a mostrare le impostazioni regionali non mappate e non supportate, ma non consente di selezionarle come lingue di destinazione per la traduzione.

## `client` [#client]

**Tipo** [`GtClient`](/docs/integrations/payload/reference/api#gtclient) · **Facoltativo** · **Predefinito** creato a partire da `projectId`, `apiKey`, l'impostazione locale predefinita di Payload e `customMapping`

Un client server-side che implementa i metodi di General Translation utilizzati dal plugin. Specifica questa opzione per fornire un test double o un client esistente con un comportamento di trasporto personalizzato.

Se `client` è impostato, il plugin non crea una propria istanza di `GT`. Il client deve implementare tutti i metodi previsti dal tipo [`GtClient`](/docs/integrations/payload/reference/api#gtclient) documentato.

## Come funziona [#how-it-works]

Quando la localizzazione di Payload è configurata, il plugin aggiunge:

* Un controllo **Translate** alle collection e ai global che hanno campi localizzati traducibili
* Una vista di amministrazione site-wide **Translations** in `/translations`
* Le collection `gt-translation-runs` e `gt-translation-locks`
* Un job Payload `gtTranslationRun`
* Endpoint autenticati sotto la Route API di Payload per le esecuzioni e la copertura

Se `localization` non è presente, il plugin restituisce la config invariata.

Esegui `npx payload generate:importmap` dopo aver aggiunto o aggiornato il plugin. Prima di usare la traduzione in produzione, applica la migrazione del database per le collection aggiunte.

Gli endpoint di amministrazione richiedono un utente Payload autenticato e rispettano le regole di accesso ai documenti previste per quell'utente. Le credenziali di General Translation restano sul server.

## Sitemap

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