Installation und Konfiguration der DeepL Translation Extension für TYPO3
Einen kompletten Internetauftritt in eine andere Sprache zu übersetzen, war bisher her sehr mühevoll. Man braucht jemanden, der die Übersetzung übernimmt und muss dann alles wieder manuell einpflegen. Die DeepL Translation von WebVision ist die intelligente Lösung für einfache, schnelle Übersetzungen.
Wir haben sie schon mehrfach bei unseren Kunden in Betrieb und zeigen Dir in diesem Leitfaden, wie Du sie problemlos selbst installieren und konfigurieren kannst.
Die DeepL Translation Extension ist für die TYPO3 Versionen 9, 10 und 11 verfügbar. Für TYPO3 Version 12 gibt es aktuell ein Early Access Programm, welches aber für jede Website einen eigenen Zugang vorsieht.
Um die Extension zu nutzen, benötigt man einen Zugang zu der DeepL API mit dem entsprechenden API-Key (DeepL Translate API | Machine Translation Technology).
Installation
Nicht Early Access Version
Die Installation für die TYPO3 Versionen 9, 10 und 11 kann auf drei unterschiedliche Weisen geschehen.
Installation über ZIP-Datei
Dafür lädst Du diese ZIP-Datei herunter und logst Dich in das Backend der TYPO3 Installation ein. Danach wechselst Du in den Extension-Bereich und lädst die Datei hoch.Installation über Composer
Hierzu geht man in die CLI der aktuellen Installation und führt folgenden Befehl aus: composer req web-vision/wv_deepltranslate. Sollte ddev im Einsatz sein, muss der Befehl angepasst werden.Installation mit T3X-Datei
Dafür lädst Du diese T3X-Datei herunter und logst Dich in das Backend der TYPO3 Installation ein. Danach wechselst Du in den Extension-Bereich und lädst die Datei hoch.
Early Access Version
Sobald Du dem Early Access Programm beigetreten bist, bekommst Du den Link für die Early Access Extension und einen Token. Der Token wird für die Authentifizierung beim composer required benötigt. Dabei wirst Du aufgefordert, den Token einzugeben und die Extension wird daraufhin installiert.
Konfiguration
Um die DeepL Translation Extension nun zu nutzen, musst Du den DeepL API Token eintragen.
Dazu gehst Du unter Admin Tools > Settings > Extension Configuration und wählst hier die „DeepL Translation“ Extension.
Unter „DeepL API Key“ trägst Du den API-Schlüssel Deines DeepL Accounts ein.
In der Version bis TYPO3 v11 hat man die Option, die kostenfreie Version der DeepL zu nutzen. Da diese aber vom Umfang sehr gering ausfällt, verwenden wir diese nur zu Testzwecken.
Im Backend Modul der Extension musst Du die Sprachen mit ihren ISO-Codes einstellen werden, damit die richtigen Sprachen erkannt und übersetzt werden.
Nachdem die DeepL Konfiguration abgeschlossen ist, muss die TYPO3 Installation noch für die Mehrsprachigkeit eingestellt werden. Die TYPO3 Dokumentation ist für diesen Part ein guter Anlaufpunkt für Dich.
Wie Redakteure die Extension für Übersetzungen anwenden, erfährst Du in unserem Newsbeitrag „Übersetze Deine Website ganz einfach in TYPO3“.
