Translator

Описание

Плагин заполняет остальные локали коллекций и глобальных объектов Payload с помощью AI-модели. Редактор открывает документ в админке и нажимает кнопку Translate. Плагин ставит в очередь задачу, которая переводит открытую локаль на остальные настроенные локали. Он читает поля типов text, textarea и richText (Lexical), в том числе вложенные в arrays, groups, tabs и blocks. Локализованные контейнеры не переводятся, а поля hasMany типа text пропускаются. Способ записи зависит от того, включены ли у коллекции versions.drafts. Если да, перевод сохраняется как черновик, и редактор проверяет его и публикует штатной кнопкой Publish. Если нет, перевод записывается сразу и становится опубликованным. Текст, который кто-то отредактировал вручную в целевой локали, плагин не перезаписывает. Плагин добавляет эндпоинты /api/translator/*, коллекции translation-records и translation-locks (одна блокировка на документ) и задачу translateDocument в очереди translations. Нужны Payload ^3.90.2, React 19, Node.js не ниже 22.12.0 и включенная локализация. Встроенный провайдер OpenAI подключается из экспорта /openai и требует пакет openai ^7. Можно передать собственный провайдер, а при provider: null кнопка скрывается. Остальные опции: collections, globals (с необязательным locales), instructions, access, имя очереди и runOnRequest. После установки нужна миграция, а import map админки нужно пересоздать для компонента TranslateControl. По умолчанию runOnRequest равен true, и задача запускается после ответа. На serverless-хостингах лучше установить false и запускать очередь через jobs.autoRun или внешний cron на /api/payload-jobs/run, потому что функция может заморозиться до завершения задачи.

О пакете

Имя пакета

@runroom/payload-plugin-translator

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

0.1.1

Размер

290 кБ

Лицензия

MIT

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

422

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

8 окт. 2026 г.