TranslatePilot

KI-Übersetzungen für Joomla-Beiträge — mit Probe, Freigabe, Kosten-Tor und Spiegelung von Menüs und Modulen · Version 0.14.0 · Stand 12.09.2026

TranslatePilot im Überblick

TranslatePilot übersetzt die Beiträge Ihrer Joomla-Website mit einem KI-Dienst in weitere Sprachen — und kümmert sich um alles, was eine mehrsprachige Website darüber hinaus braucht: Sprachverknüpfungen, Menü-Zwillinge, gespiegelte Module und, falls Sie YOOtheme Pro einsetzen, Footer und Beitrags-Templates je Sprache.

Der Kern ist eine einfache Zusage: Es passiert nichts Teures und nichts Unumkehrbares, ohne dass Sie es vorher gesehen und gebilligt haben.

So arbeitet TranslatePilot

Was übersetzt wird — und was nicht

Übersetzt werden Beiträge der Quellsprache: Titel, Einleitungs- und Haupttext (bei YOOtheme-Builder-Seiten die Textbausteine des Seitenbaums, die Struktur bleibt unangetastet), Meta-Beschreibung und -Schlüsselwörter, Bild-Alternativtexte, Beschriftungen der weiterführenden Links sowie eigene Felder der Typen Text, Textbereich und Editor. Schlagwörter, Bilder, Link-Adressen und die Sichtbarkeit werden unverändert übernommen; die Sprachverknüpfung zum Original entsteht automatisch.

Nicht übersetzt werden Inhalte anderer Komponenten, Systemtexte und die Konfiguration. Module und Menüpunkte entstehen nicht beim Übersetzen, sondern über die Spiegelungs-Schritte — als Zwillinge der bereits übersetzten Inhalte. Die Analyse-Seite zeigt diese Abgrenzung vor jedem Lauf an.

Woraus TranslatePilot besteht

Welche KI-Dienste unterstützt werden

TranslatePilot ist anbieteroffen: Claude (Anthropic), Mittwald AI Hosting oder ein anderer OpenAI-kompatibler Dienst. Die verfügbaren Modelle werden direkt beim Anbieter abgefragt und in den Optionen zur Auswahl angeboten. Einzelheiten auf der Seite „KI-Anbieter und Zugang".

YOOtheme Pro und JSitemap Pro sind optional. TranslatePilot funktioniert vollständig mit dem Joomla-Kern; sind die Erweiterungen vorhanden, werden sie zusätzlich berücksichtigt (Builder-Seiten, Meta-Überschreibungen, Footer- und Template-Spiegelung).

English version

Voraussetzungen und Installation

Voraussetzungen

Ihre Website muss beim Start nicht mehrsprachig konfiguriert sein. TranslatePilot richtet die Mehrsprachigkeit auf Wunsch selbst ein — Inhaltssprachen, Sprachenfilter, Startseiten je Sprache und den Sprachumschalter. Nur die Sprachpakete selbst installieren Sie vorher über System → Sprachen installieren; einen Download kann die Einrichtung nicht ehrlich in einer Vorschau abbilden und übernimmt ihn deshalb nicht.

Installation

  1. Laden Sie das Paket pkg_translatepilot-x.y.z.zip herunter.
  2. Installieren Sie es unter System → Installieren → Erweiterungen.
  3. Das Paket installiert die Komponente und das Aufgaben-Plugin; das Plugin wird dabei aktiviert. Es bleibt untätig, bis Sie eine geplante Aufgabe anlegen.

Nach der Installation finden Sie TranslatePilot unter Komponenten → TranslatePilot. Das Dashboard zeigt sofort, wie es um die Mehrsprachigkeit der Installation steht und was vor der ersten Übersetzung noch fehlt.

Aktualisieren

Updates erscheinen wie gewohnt unter System → Aktualisieren → Erweiterungen. Der Übersetzungs-Stand, die Freigabe und alle Einstellungen bleiben bei Updates erhalten.

Deinstallieren

Die Deinstallation des Pakets entfernt Komponente und Plugin. Bereits übersetzte Beiträge, Menüpunkte und Module sind normale Joomla-Inhalte und bleiben selbstverständlich bestehen.

English version

KI-Anbieter und Zugang

TranslatePilot übersetzt über den KI-Dienst Ihrer Wahl. Anbieter, Zugang und Modell stellen Sie in den Optionen der Komponente ein (Komponenten → TranslatePilot → Optionen, Reiter „Übersetzung").

Die Anbieter

Modell wählen — die Liste kommt vom Anbieter

Sobald Anbieter und API-Schlüssel gespeichert sind, fragt TranslatePilot die verfügbaren Modelle direkt beim Anbieter ab und bietet sie im Modell-Feld zur Auswahl an. Sie wählen also immer aus dem aktuellen Angebot, ohne Modellnamen abtippen zu müssen.

Die Liste erscheint erst nach dem Speichern von Anbieter und Schlüssel — einmal die Optionen speichern und wieder öffnen. Ist der Anbieter gerade nicht erreichbar, bleibt der zuletzt gespeicherte Modellwert wählbar; es geht nichts verloren.

Anbieter wechseln

Ein Wechsel ist jederzeit möglich: Anbieter umstellen, den passenden Schlüssel eintragen, speichern, Modell aus der frisch geladenen Liste wählen. Zwei Dinge sind dabei gewollt:

Sicherheit des Schlüssels

Der API-Schlüssel wird ausschließlich serverseitig verwendet, nie im Browser ausgegeben und nie in Protokolle geschrieben.

English version

Mehrsprachigkeit einrichten

Bevor übersetzt wird, muss die Installation mehrsprachig arbeiten. Das Dashboard zeigt den Stand; die Einrichtung erledigt, was fehlt — mit kostenloser Vorschau, wiederholbar, und ohne etwas doppelt anzulegen.

Das Dashboard: Bereitschafts-Prüfungen

Komponenten → TranslatePilot prüft bei jedem Aufruf:

Der Einrichtungs-Schritt

Die Einrichtung ist Schritt 3 des Assistenten (Komponenten → TranslatePilot → Assistent); sie übersetzt nichts und braucht deshalb keine Freigabe. „Vorschau (kostenlos)" zeigt, was geschehen würde; „Ausführen" tut es. Im Einzelnen:

Jeder Schritt prüft zuerst, wie es steht, und überspringt, was schon passt. Die Einrichtung mehrfach auszuführen ist ausdrücklich unbedenklich.

Reihenfolge beim ersten Mal

  1. Sprachpakete installieren (System → Sprachen installieren).
  2. In den Optionen Anbieter, Schlüssel, Modell, Quell- und Zielsprachen festlegen.
  3. Den Assistenten öffnen und den Schritten folgen: Einrichtung (Vorschau, dann ausführen), Übersetzungsprofil, Probe und Freigabe, Lauf — siehe die nächsten Seiten.
  4. Nach der Übersetzung: Schritt 8 des Assistenten spiegelt Menüs und Module, damit die Zielsprache eine eigene Navigation bekommt.

English version

Das Übersetzungsprofil

Das Übersetzungsprofil ist der seitenspezifische Teil der Anweisungen an den KI-Dienst. Es entscheidet darüber, ob die Übersetzung nach Ihrer Website klingt — oder nach einer beliebigen. Sie finden es in den Optionen im Reiter „Übersetzungsprofil".

Die Felder

Das Glossar ernst nehmen

Ins Glossar gehören der Firmenname, Ihre Produktnamen und Fremdmarken. Ohne Glossar übersetzt das Modell auch gut gemeinte Dinge: Aus einem Firmennamen mit beschreibendem Bestandteil wird sonst eine englische Beschreibung, aus „Backend Booking" ein kleingeschriebenes „backend booking". Alles, was ein Eigenname ist, gehört in die Liste.

Profiländerungen übersetzen den Bestand neu

Jede Änderung am Profil — auch ein einzelner Glossar-Eintrag — lässt den gesamten Bestand als geändert gelten: Der nächste Lauf übersetzt alle Beiträge neu, in Stapeln bis zur eingestellten Obergrenze. Das ist gewollt (die alte Übersetzung entstand ohne die neue Vorgabe), kostet bei tokenbasierten Anbietern aber Geld. Das Profil deshalb früh festlegen und danach nur noch bewusst ändern.

Aus demselben Grund ist die Freigabe an das Profil gebunden: Nach einer Profiländerung verlangt der nächste Echtlauf eine neue gesichtete Probe.

English version

Analyse, Probe und Echtlauf

Der Weg zur ersten Übersetzung führt immer über drei Stationen: Umfang ansehen, Probe sichten und freigeben, dann der Lauf — der Assistent führt der Reihe nach hindurch (Schritte 5, 6 und 8). Danach genügt der Lauf allein, oder die geplante Aufgabe übernimmt ihn. Die Analyse-Seite zeigt denselben Befund jederzeit als reinen Bericht.

Der Umfang (und die Analyse-Seite)

Schritt 5 des Assistenten — und ausführlicher die Analyse-Seite — liest nur und zeigt je Zielsprache:

Die Probe

Die Qualitätsprobe übersetzt einige Beiträge (wählbar, 1–10) wirklich über den eingestellten Anbieter, schreibt aber nichts. Original und Übersetzung erscheinen nebeneinander: Titel, Einleitung, Meta-Beschreibung. Sichten Sie die Probe auf Ton, Terminologie und Glossar-Treue — genau dafür ist sie da.

Die Freigabe

Trifft die Probe den Ton, klicken Sie „Profil freigeben". Die Freigabe gilt für genau diese Kombination aus Übersetzungsprofil, Anbieter und Modell. Ändert sich eines davon, erlischt sie — und der nächste Echtlauf verlangt eine neue Probe. So kann keine unbesehene Konfiguration in Ihre Inhalte schreiben, auch nicht über die geplante Aufgabe.

Die Zusammenfassung: Trockenlauf oder Ausführung

Schritt 7 zeigt alle Entscheidungen auf einer Seite — Anbieter und Modell, Sprachen, Profil, Umfang, Freigabe. Von dort starten Sie wahlweise den Trockenlauf (zeigt vollständig, was geschähe — kostenlos, ohne API-Aufrufe, es wird nichts geschrieben) oder die Ausführung.

Die Ausführung

Der Echtlauf übersetzt den nächsten Stapel und schreibt die Übersetzungen als reguläre Joomla-Beiträge — mit Sprachverknüpfung zum Original, korrekten Rechten und, wo vorhanden, übertragenen Feldwerten und Schlagwörtern. Vorher greifen drei Mechanismen:

Große Bestände: einfach weiterklicken

Ein Weblauf hat ein Zeitbudget. Läuft es aus, hält der Lauf sauber an — der Stand ist je Beitrag festgeschrieben, und der nächste Klick auf „Nächsten Stapel übersetzen" macht genau dort weiter. Nichts geht verloren, nichts wird doppelt übersetzt.

Fortschreibung

Nach der Erstübersetzung erkennt TranslatePilot Änderungen von selbst: Ein geänderter Titel, Text, eine geänderte Meta-Angabe oder ein geänderter Feldwert lassen genau diesen Beitrag als „geändert" erscheinen; der nächste Lauf schreibt seine Übersetzung fort. Unveränderte Beiträge kosten nichts.

English version

Menüs, Module, Footer und Templates spiegeln

Übersetzte Beiträge allein machen noch keine mehrsprachige Website: Ohne eigene Menüpunkte ist die Zielsprache nicht navigierbar, sprachgebundene Module fehlen auf den übersetzten Seiten, und YOOtheme-Footer wie -Templates kennen nur die Quellsprache. Die Spiegelungen — Schritt 8 des Assistenten — schließen diese Lücken: jede mit kostenloser Vorschau, jede wiederholbar, jede überspringt, was schon passt.

Menü-Spiegelung

Legt je Zielsprache Menü-Zwillinge an — für jeden Menüpunkt, dessen Ziel (Beitrag oder Kategorie) bereits übersetzt ist:

Modul-Spiegelung

Module auf Sprache „Alle" erscheinen ohnehin in jeder Sprache und bleiben unangetastet. Module mit fester Quellsprache würden auf den übersetzten Seiten fehlen — die Analyse listet sie auf, und die Spiegelung legt je Zielsprache einen übersetzten Zwilling an: Titel und Inhalt übersetzt, Position und Sichtbarkeit übernommen, die Seitenzuweisung auf die Menü-Zwillinge umgestellt. Modul-Einstellungen werden unverändert kopiert.

Die Spiegelung legt nur an; spätere Änderungen am Quellmodul wandern nicht automatisch in den Zwilling.

Template-Spiegelung (nur YOOtheme)

YOOtheme rendert Beitrags-Detailseiten über Templates mit Zuweisungsbedingungen — und die nennen die Kategorien der Quellsprache. Übersetzte Beiträge fielen deshalb auf die schmucklose Standard-Ansicht zurück. Dieser Schritt legt je Zielsprache eine Kopie jedes Templates an: Kategorien auf die übersetzten Zwillinge umgestellt, Beschriftungen übersetzt, Verweise umgebogen. Templates, deren Kategorien keine Übersetzung haben, werden übersprungen.

Ohne YOOtheme melden Footer- und Template-Spiegelung schlicht, dass es nichts zu tun gibt.

English version

Automatisch übersetzen (geplante Aufgabe)

Nach der Erstübersetzung kann TranslatePilot den Alltag übernehmen: Das mitgelieferte Aufgaben-Plugin übersetzt neue und geänderte Beiträge zeitgesteuert über Joomlas Aufgabenplaner — mit exakt denselben Schutzmechanismen wie im Backend.

Aufgabe anlegen

  1. System → Geplante Aufgaben → Neu und den Typ „TranslatePilot: Beiträge übersetzen" wählen.
  2. Eine Ausführungsregel festlegen — etwa stündlich oder täglich zur Nachtzeit.
  3. Die Aufgaben-Parameter ausfüllen (unten) und speichern.

Ausgeführt wird die Aufgabe, wie Joomla es vorsieht: über den eingebauten Web-Auslöser, einen Cron-Aufruf von cli/joomla.php scheduler:run oder den Knopf „Testlauf" in der Aufgabenliste.

Die Aufgaben-Parameter

Was die Automatik nicht aushebelt

Verhalten bei großen Beständen

Jeder Lauf übersetzt höchstens einen Stapel und hält sich an ein Zeitbudget. Was nicht mehr in den Lauf passt, übernimmt der nächste — der Stand ist je Beitrag festgeschrieben. Ein großer Bestand wird so über mehrere Läufe abgearbeitet, ohne dass etwas verloren geht.

Das Protokoll jedes Laufs finden Sie in der Aufgabenliste beim jeweiligen Eintrag; zusätzlich schreibt TranslatePilot sein eigenes Protokoll ins Joomla-Logverzeichnis.

English version

Häufige Fragen

Warum wird ein Beitrag übersprungen?

Die häufigsten Gründe stehen in der Analyse direkt beim Beitrag: Er steht auf Sprache „Alle" (nur Inhalte der Quellsprache werden übersetzt — die Einrichtung kann das umstellen), oder er ist in den Optionen ausdrücklich ausgeschlossen.

Die Modellliste in den Optionen ist leer beziehungsweise nicht ladbar

Die Liste kommt direkt vom Anbieter und braucht dafür den gespeicherten API-Schlüssel: erst Anbieter und Schlüssel eintragen, speichern, dann die Optionen erneut öffnen. Bleibt die Liste nicht ladbar, ist meist der Schlüssel ungültig oder der Anbieter gerade nicht erreichbar — der gespeicherte Modellwert bleibt in beiden Fällen wählbar.

Der Echtlauf-Knopf ist ausgegraut

Dann fehlt die Freigabe: erst eine Probe fahren und sichten, dann „Profil freigeben". Nach jeder Änderung an Profil, Anbieter oder Modell ist eine neue Probe fällig — das ist der Qualitätsschutz, kein Fehler.

Was kostet die Übersetzung?

Das hängt vom Anbieter ab. Bei tokenbasierten Anbietern (Claude) zeigt die Analyse eine USD-Schätzung je Stapel; typische Textbeiträge kosten Bruchteile eines Cents bis wenige Cent pro Beitrag. Bei Pauschaltarifen (Mittwald AI Hosting) kostet der einzelne Lauf nichts; die Token zählen gegen das Monatskontingent, und die Analyse zeigt, wie viele. Die Kostengrenze je Lauf schützt zusätzlich vor Ausreißern.

Eine Übersetzung wurde von Hand nachbearbeitet — überschreibt der nächste Lauf sie?

Nur, wenn sich das Original seither geändert hat: Dann gilt der Beitrag als geändert und wird fortgeschrieben — Ihre Handarbeit an der Übersetzung geht dabei verloren. Solange das Original unverändert bleibt, rührt TranslatePilot die Übersetzung nicht an. Wer eine Übersetzung dauerhaft von Hand pflegen will, nimmt den Beitrag in die Ausschlussliste der Optionen auf.

Was bedeutet die Meldung über verwaiste Übersetzungen?

Eine Übersetzung existiert, deren Original gelöscht oder in den Papierkorb verschoben wurde. TranslatePilot löscht grundsätzlich nichts — es meldet den Fund, und Sie entscheiden, ob die Übersetzung bleiben soll.

Ändert die Neuübersetzung Adressen?

Ja, das kann passieren: Wird ein Bestands-Beitrag neu übersetzt (etwa nach einer Profiländerung), entsteht der Kurzname der Übersetzung neu aus dem frischen Titel. Interne Verweise arbeitet die Link-Nacharbeit nach; externe Verweise auf die alte Adresse der Übersetzung tun das nicht. Bei geplanten Profiländerungen an gut verlinkten Seiten lohnt ein Blick auf die wichtigsten Adressen.

Brauche ich YOOtheme Pro oder JSitemap Pro?

Nein. Beide sind optional. Mit dem Joomla-Kern allein funktioniert alles: Übersetzung, Einrichtung, Menü- und Modul-Spiegelung. YOOtheme bringt zusätzlich Builder-Seiten, Footer- und Template-Spiegelung ins Spiel; JSitemap Pro dessen Meta-Überschreibungen.

Schreibt TranslatePilot bei offenem YOOtheme-Customizer?

Das sollte es nicht: Schreibt ein Lauf in eine Builder-Seite, während dieselbe Seite im Customizer geöffnet ist, zeigt YOOtheme dort einen Konfliktdialog. Geplante Läufe deshalb außerhalb der Redaktionszeiten legen.

English version

Änderungsprotokoll

Von TranslatePilot ist noch keine Version veröffentlicht.

English version