Translator

Über

Das Plugin befüllt die übrigen Locales von Payload-Collections und Globals mithilfe eines KI-Modells. Ein Redakteur öffnet ein Dokument im Admin und startet die Übersetzung über den TranslateControl-Button. Das Plugin legt daraufhin einen Job an, der die geöffnete Locale in alle weiteren konfigurierten Locales übersetzt. Berücksichtigt werden lokalisierte Felder vom Typ `text`, `textarea` und Lexical-`richText`, auch wenn sie in Arrays, Groups, Tabs oder Blocks verschachtelt sind. Lokalisierte Container selbst werden nicht übersetzt, und `hasMany`-Textfelder werden übersprungen. Der Schreibweg hängt davon ab, ob die Collection `versions.drafts` aktiviert hat. Bei Entitäten mit Drafts landet die Übersetzung als Entwurf, den ein Redakteur prüft und über den Publish-Button von Payload veröffentlicht. Entitäten ohne Drafts werden direkt geschrieben und sind sofort live. Text, den jemand in einer Zielsprache von Hand bearbeitet hat, überschreibt das Plugin nicht. Das Plugin ergänzt die Endpunkte unter `/api/translator/*`, die Collections `translation-records` und `translation-locks` sowie die Job-Task `translateDocument` in der Queue `translations`. Voraussetzungen sind Payload ^3.90.2, React 19, Node.js ab 22.12.0 und eine aktivierte `localization` in der Config. Der mitgelieferte OpenAI-Provider wird über den Export `/openai` eingebunden und benötigt das Paket `openai` ^7. Eigene Provider sind ebenfalls möglich. Mit `provider: null` wird der Button ausgeblendet. Nach der Installation sind eine Migration und das Neugenerieren der Admin-Import-Map für die TranslateControl-Komponente nötig. Die Jobs laufen über das Jobsystem von Payload. Standardmäßig startet `runOnRequest` (Standard: `true`) den Job nach der Antwort. Auf Serverless-Umgebungen sollte man `runOnRequest: false` setzen und die Queue über `jobs.autoRun` oder einen externen Cron auf `/api/payload-jobs/run` abarbeiten, da die Funktion sonst eingefroren werden kann, bevor der Job fertig ist.

Paketinformationen

Paketname

@runroom/payload-plugin-translator

Neueste Version

0.1.1

Entpackte Größe

290 kB

Lizenz

MIT

Wöchentliche Downloads

422

Zuletzt veröffentlicht

8. Okt. 2026