Translator

Name: Translator
Brand: focusreactive
Availability: InStock
Author: focusreactive

Uebersetzt lokalisierte Payload CMS Inhalte ueber steckbare Provider, mit Steuerelementen auf Dokument-, Sammlungs- und Feldebene im Admin-Panel.

Community 26 1297/Wo. MIT v0.16.0

Installation

$ pnpm add @focus-reactive/payload-plugin-translator

Über

Payload lokalisiert Inhalte, ueberlaessst die eigentliche Uebersetzung aber manuell. Dieses Plugin schliesst diese Luecke und durchlaeuft alle lokalisierten Felder beliebiger Verschachtelungstiefe: Gruppen, Arrays, Blocks, Tabs und Lexical-Rich-Text. Es sendet den Text an einen Uebersetzungs-Provider und schreibt das Ergebnis zurueck in die Zielsprache. Die Uebersetzung wird auf drei Ebenen angeboten und ueber die Option `levels` aktiviert: ein Popup in der Dokumentenansicht, ein Bulk-Dashboard in der Sammlungsansicht und ein pro-Feld-Steuerelement ueber `withFieldTranslation`. Standardmaessig aktiv sind die ersten beiden. Das Feld-Steuerelement uebernimmt Inhalte aus einer gewaehlten Quellsprache in das aktuelle Formular und unterstuetzt einen Undo-Schritt. Es funktioniert nur bei `text`, `textarea` und `richText` und remountet den Lexical-Editor bei Rich-Text-Inhalten. Die Provider sind ueber eine `TranslationProvider`-Schnittstelle steckbar, OpenAI ist integriert. Die Ausfuehrung erfolgt ueber einen konfigurierbaren Runner: Standard ist der asynchrone Payload-Jobs-Runner, alternativ ein synchroner Runner. `targetSelection` steuert, ob pro Lauf eine oder mehrere Sprachen uebersetzt werden. Strategien erlauben das Ueberschreiben bestehender Inhalte oder das Ueberspringen bereits vorhandener Inhalte. Mit `withAutoTranslate` koennen Sie automatische Uebersetzungen aktivieren, wenn sich der Inhalt der Quellsprache eines Dokuments aendert. Schnelle Bearbeitungen werden dabei entprellt, und Speichervorgaenge ohne aenderbare Inhalte werden uebersprungen. Weitere Optionen umfassen eine optionale Provenienz-Sammlung, die den Quellzustand jeder Uebersetzung speichert, serverseitige Lifecycle-Callbacks (`onQueued`, `onCompleted`, `onFailed`), eine Zugriffskontrolle fuer die Endpunkte und einen konfigurierbaren `basePath` (Standard `/translate`). Das Plugin setzt eine aktivierte Lokalisierung in der Payload-Konfiguration voraus. Felduebersetzungen benoetigen ein gespeichertes Dokument. Felder innerhalb eines lokalisierten `blocks`- oder `array`-Containers koennen nicht nach Position zugeordnet werden, daher ist das pro-Feld-Steuerelement dort deaktiviert und zeigt einen Hinweis, stattdessen das gesamte Dokument zu uebersetzen. Auto-Translate reiht nur Jobs ein, auf Serverless-Plattformen wie Vercel benoetigen Sie daher einen funktionierenden Job-Runner oder externen Cron.