Translator

Описание

Плагин обходит все локализованные поля на любой глубине вложенности (groups, arrays, blocks, tabs, Lexical rich text), отправляет текст провайдеру перевода и записывает результат в целевую локаль. Встроенный провайдер OpenAI доступен из коробки, но архитектура провайдеров построена на интерфейсе `TranslationProvider`, так что можно подключить другие сервисы. Перевод доступен на трех уровнях, которые включаются опцией `levels`: попап на странице редактирования документа, массовый перевод в дашборде коллекции и индивидуальный контроль для отдельных полей через `withFieldTranslation`. По умолчанию включены уровни документа и коллекции. Полевой контроль подтягивает контент из выбранной исходной локали в текущую, пишет прямо в состояние формы с поддержкой undo и работает только с полями `text`, `textarea` и `richText` (для rich text происходит перемонтирование редактора Lexical). Выполнение перевода идет через настраиваемый runner: по умолчанию асинхронный Payload Jobs runner, либо синхронный. Опция `targetSelection` определяет, переводить одну локаль или несколько за раз. Стратегии позволяют перезаписывать существующий контент или пропускать локали, где перевод уже есть. Опциональная обертка `withAutoTranslate` автоматически ставит переводы в очередь при изменении контента в исходной локали: дебаунсит частые правки и игнорирует сохранения, где не изменилось ничего переводимого. Дополнительно: опциональная коллекция provenance, которая записывает исходное состояние для каждого перевода; серверные lifecycle-колбеки (`onQueued`, `onCompleted`, `onFailed`); access guard для эндпоинтов и настраиваемый `basePath` (по умолчанию `/translate`). Для работы плагина в конфиге Payload должна быть включена локализация. Для перевода отдельных полей нужен сохраненный документ. Поля внутри локализованных контейнеров `blocks` или `array` нельзя сопоставить по позиции, поэтому полевой контроль в этих случаях ничего не делает и выводит уведомление: переводите документ целиком. Автоперевод только ставит задачи в очередь, поэтому на serverless-платформах вроде Vercel нужен рабочий job runner или внешний cron.

О пакете

Имя пакета

@focus-reactive/payload-plugin-translator

Последняя версия

0.16.0

Размер

834 кБ

Лицензия

MIT

Загрузок в неделю

1,3 тыс.

Последняя публикация

12 окт. 2026 г.