# General Translation Integrations: Быстрый старт
URL: https://generaltranslation.com/ru/docs/integrations/payload/quickstart.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Установите gt-payload, добавьте плагин в Payload CMS и переведите первый локализованный документ.

Плагин `gt-payload` добавляет элементы управления переводом в коллекции и глобальные объекты (globals) Payload CMS. Он переводит локализованные поля на локали, указанные в конфигурации Payload.

## Перед началом работы [#before-start]

Вам понадобятся:

* Payload CMS версии 3.90.0 или новее с настроенным параметром `localization`
* Next.js версии 15.2.9 или новее
* React версии 19.0.1 или новее
* [ID проекта](/docs/platform/dashboard/get-started) и [API-ключ проекта](/docs/platform/dashboard/reference/api-keys#create-project-keys) General Translation с правами доступа **All**
* Хотя бы одно поле с `localized: true`

## Быстрый старт [#quickstart]

### 1. Установите `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. Настройка локализации

Укажите исходную и целевые локали в конфигурации Payload, а затем пометьте как локализованные все поля, которые нужно перевести.

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

export default buildConfig({
  // ... ваша текущая конфигурация
  localization: {
    locales: ['en', 'es', 'fr'],
    defaultLocale: 'en',
  },
  collections: [
    {
      slug: 'pages',
      fields: [
        {
          name: 'title',
          type: 'text',
          localized: true,
        },
      ],
    },
  ],
});
```

Плагин не изменяет конфигурацию, если в ней не настроена локализация Payload.

### 3. Добавьте плагин

Добавьте [`gtPlugin`](/docs/integrations/payload/reference/plugin-configuration) в массив `plugins`.

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

export default buildConfig({
  // ... ваша текущая конфигурация
  localization: {
    locales: ['en', 'es', 'fr'],
    defaultLocale: 'en',
  },
  plugins: [gtPlugin()],
});
```

### 4. Задайте учётные данные

Задайте ID проекта и API-ключ проекта на сервере, где запущен Payload:

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

Не передавайте `GT_API_KEY` в клиентский код и не коммитьте его в систему контроля версий.

### 5. Обновите Payload

Сгенерируйте карту импортов заново, чтобы панель администратора могла загрузить компоненты плагина:

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

Плагин добавляет коллекции для запусков перевода и блокировок. Для PostgreSQL или SQLite создайте и примените миграцию так же, как при любом другом изменении схемы Payload:

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

### 6. Переведите документ

1. Запустите Payload и откройте панель администратора.
2. Откройте документ или глобальный объект (global) с локализованными полями.
3. Сохраните все несохранённые изменения.
4. Нажмите **Перевести**.
5. Выберите одну или несколько целевых локалей, затем нажмите **Перевести на …**.

Плагин записывает каждый результат в соответствующую локаль Payload. Если черновики включены, он сохраняет черновик. Переведённый контент плагин никогда не публикует.

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