Campus Lingo Release Notes

Release Datum: 27.11.2025 ☆ Bugfix-Release ☆ TYPO3 v11, v12 & v13

• [TASK] Version auf 3.0.1 gesetzt
• [TASK] Autor auf Brain Appeal DEV-Team setzen, Version in composer.json entfernt
• [BUGFIX] Regression in Web > Seite behoben, damit Drag & Drop wieder funktioniert
• [BUGFIX] Fehlerhafte Klassenreferenz in der use-Anweisung korrigiert 

Release Datum: 29.10.2025 ☆ Major Update ☆ TYPO3 v11, v12 & v13

Mit der Version 3.0.0 erhält campus_lingo optional Einzug ins TYPO3-Backend und eine aktualisierte Dokumentation, die sich hier befindet: TYPO3_EXT_campus_lingo-3.0.0.pdf. Die beiden wichtigsten neuen Features sind:

• campus_lingo ist nun offiziell kompatibel mit TYPO3 v13, v12 und v11.
  Falls Sie campus_lingo bisher mit TYPO3 v13 über unseren develop-Branch einsetzen, aktualisieren Sie bitte die verwendete Version zu ^3.0.0
• Anzeige zum Status automatischer Übersetzung im TYPO3-Backend.
  Nach Aktivierung in der Extension-Konfiguration wird an folgenden Stellen angezeigt, ob der jeweilige Inhalt automatisch übersetzt wird: Web > Seite, Web > Liste, Web > Info > Übersetzungsübersicht, Datei > Dateiliste und Inline-Panels. Das Feature kann nach Aktivierung pro Benutzer bzw. Benutzergruppe wieder deaktiviert werden über die „User TsConfig“-Eigenschaft „options.campusLingo.showAutoTranslationStateInfo = 0“. Das Feature ist für TYPO3 v11 ohne Wirkung und funktioniert ab TYPO3 v12.

Mit dem Update der Campus Lingo API am 20.10.2025 wurde nicht nur die im Hintergrund arbeitende Technik grundlegend aktualisiert. Darüber hinaus wurden wichtige Anpassungen an Schnittstellen zu DeepL vorgenommen, damit Campus Lingo einfach weiter so funktioniert, wie gewohnt und ohne dass Sie etwas dafür tun müssen. Ein paar hilfreiche Neuerungen gibt es auch:

• Neuer Menüpunkt DeepL > API Key 
  zur Konfiguration des Campus Lingo API Keys („Erweiterte Optionen“)
• API Key > Erweiterte Optionen: Zugriffsbeschränkung IP-Adressen. 
  Es ist nun möglich, IP-Adressen als Whitelist oder Blacklist zu hinterlegen, die den Campus Lingo API Key nutzen dürfen. Damit können z. B. ungewollte Übersetzungskosten bei Nutzung auf einem Entwicklungssystem vermieden werden.
• API Key > Erweiterte Optionen: Vor- und Nachverarbeitung.
  Die hier gewählten Standard-Einstellungen behandeln typische Probleme bei der automatischen Übersetzung mit DeepL. Eine Anpassung ist normalerweise nicht nötig. Campus Lingo korrigiert damit diese beiden DeepL-Probleme: Fehlerhafte Übersetzung bei Nutzung von quadratischen oder chemischen Formeln (es wird zuviel hoch- bzw. tiefgestellt). Spezielle Leerzeichen an Formatierungs-Grenzen werden bei der Übersetzung „vergessen“ (Worte werden ohne Leerzeichen zusammengezogen, wenn z. B. Fettungen enthalten sind). Sollten die Korrekturmaßnahmen zu individuellen Probleme führen, können sie hier abgeschaltet werden.
• Dashboard-Widget „Übersetzte Zeichen“.
  Das Widget „Übersetzte Zeichen“ zeigt nun eingehende Zeichen als Verlgeich zu übersetzten Zeichen.

• [FEATURE] Backend-Informationen für automatische Übersetzungen für TYPO3 v12+: Web > Seite, Web > Liste, Dateiliste, Inline-Elemente, Web > Info > Übersetzungsansicht
• [TASK] Das Sites-Modul zeigt nun eine Warnung an, wenn Sprachen mehrere Fallbacks haben
• [FEATURE] Wenn EXT:news installiert ist, wird eine XClass für \GeorgRinger\News\Seo\NewsAvailability hinzugefügt, um die Verfügbarkeit übersetzter News zu prüfen
• [FEATURE] Übersetzung von Datensätzen im Strict Mode aktivieren, wenn die Standardsprache verwendet wird
• [FEATURE] TYPO3 v13-Kompatibilität + Versionserhöhung auf v3.0.0
• [TASK] Ermittlung der TYPO3-Hauptversion in EnvironmentService::getTypo3version ausgelagert
• [TASK] Beschriftungen präzisiert
• [FEATURE] Backend Web > Seite: Übersetzungsinformationen einer Seite immer anzeigen (wenn möglich) und vermeiden, dass das Backend-Template überschrieben wird
• [FEATURE] Backend Web > Seite: Übersetzungsinformationen der Seite in den Header neben den Sprachschalter verschoben
• [BUGFIX] Fehlerbehebungen der Informationen der automatischen Übersetzungen im Backend
• [TASK] Anmerkungen/ToDos für weniger invasive Backend-Änderungen im Modul Web > Seite & Inline-Elementen ergänzt
• [TASK] TYPO3 v13: Anpassung an geänderten Backend-Fluid-Partial „RecordDefault“
• [TASK] TYPO3 v13: Migration von ApiRecordTranslations
• [BUGFIX] Cachebarer Inhalt muss per Referenz an die Nachbearbeitung übergeben werden, da sonst „dontTranslateWrap“ nicht mehr aufgelöst wird
• [FEATURE] Umschalter „Keine automatische Übersetzung“: Vermeidung des „Extended“-div zugunsten des „Language“-div
• [TASK] Verwendung veralteten Codes vermeiden + Warnungen für TYPO3 v12 und v13 in „Scan Extension Files“ analysieren und beheben
• [TASK] Bereinigung der Label-Keys, die in Web > Info > Übersetzungsansicht translationStatus verwendet werden
• [BUGFIX] Fehler behoben, bei dem Cache-Einträge nicht aktualisiert wurden, wenn Glossar-Einträge für EN oder PT erstellt/aktualisiert wurden, die konfigurierte Übersetzungssprache jedoch eine Sprachvariante war (z. B. EN-US)
• [BUGFIX] Automatische Übersetzung für Felder, die als EXT:t3editor HTML-Content konfiguriert sind (z. B. tt_content mit CType „html“)
• [TASK] IRRE-Statusinformationen für Auto-Translation: XClass durch ModifyInlineElementControlsEvent ersetzt
• [BUGFIX] TYPO3 v13: Drag & Drop von Inhaltselementen in Web > Seite wiederhergestellt
• [FEATURE] Versionsinformationen und Clientnamen im HTTP-Header hinzufügen, wenn die API angefragt wird
• [BUGFIX] TYPO3 v13 Regression: Werte wieder im Register einfügen (nötig für Translation-Placeholder)
• [TASK] Auto-übersetzte locallang.xlf-Dateien: README aktualisiert + XLIFF <header><tool> hinzugefügt
• [BUGFIX] Behandlung nicht initialisiertem „request“ (z. B. im CLI-Kontext)
• [DOC] Release Notes auf academic-hero.de verlinkt
• [FEATURE] Fehlerprotokollierung in Logdatei typo3_campus_lingo_errors_[hash].log (inklusive individueller Fehler, die zuvor nur in sys_log geschrieben wurden)
• [TASK] Copyright-Hinweis aktualisiert

Release Datum: 14.05.2025 ☆ Bugfix-Release ☆ TYPO3 v11 & v12

• [TASK] Zeilenumbruch von Labeln im Backend Sites-Modul optimiert
• [BUGFIX] Teste, ob automatische Übersetzung deaktiviert sind, bevor der record overlay Event listener aufgerufen wird
• [BUGFIX] Backend Seiteneigenschaften: Information zu automatischer Übersetzung müssen unter der Legenden-Überschrift angezeigt werden (TYPO3 v12+)
• [BUGFIX] PHP Warnungen abfangen, wenn “Debug output of additional translation information” aktiviert ist
• [TASK] Version auf 2.0.3 gesetzt

Release Datum: 30.04.2025 ☆ Bugfix-Release ☆ TYPO3 v11 & v12

[BUGFIX] Seiten-ID für die Bestimmung der aktuellen Site priorisieren
Szenario: Die Bestimmung von l18n_cfg schlägt kann im Backend in einer Multisite-Installation mit der aktuellen Site fehlschlagen

Release Datum: 13.12.2024 ☆ Bugfix-Release ☆ TYPO3 v11 & v12

• [TASK] CurrentPageAspect: Erlaubt die Bestimmung der aktuellen Seite, wenn diese nicht durch den Request bestimmt werden kann
• [BUGFIX] falls noch nicht vorhanden, muss pages.tx_campus_lingo_features vor der Prüfung der Konfiguration geladen werden
• [BUGFIX] Vermeidung langsamer Datenbank-Abfragen an die sys_log-Tabelle, um wiederholte Protokolleinträge zu vermeiden
• [BUGFIX] Die TCA-API zur Deaktivierung der automatischen Übersetzung darf das Steuerungs-Feld nicht in einer verborgenen Palette platzieren (isHiddenPalette)
• [TASK] Version auf 2.0.1 gesetzt

Release Datum: 19.11.2024 ☆ Major Update ☆ TYPO3 v11 & v12

Mit der Version 2.0.0 erhält campus_lingo viele neue Features und eine aktualisierte Dokumentation, die sich hier befindet: campus_lingo-2.0.0.pdf . Hier sind wichtigsten neuen Features aufgelistet:

• kompatibel mit TYPO3 v12
  campus_lingo ist nun offiziell kompatibel mit TYPO3 v12 und v11 kompatibel. Falls Sie campus_lingo bisher mit TYPO3 v12 über unseren develop-Branch einsetzen, aktualisieren Sie bitte die verwendete Version zu ^2.0.0
• Automatische Übersetzung von syndizierten Inhalten
  Hiermit ist es möglich, Inhalte im Frontend zu übersetzen, die nicht in der TYPO3-Datenbank gespeichert sind, aber im Frontend ausgegeben werden. Das können z.B. Daten aus einer externen Datenbank oder einem Webservice sein. Bitte lesen Sie den Abschnitt "Translation of arbitrary content" in der Dokumentation.
• Automatische Übersetzung von Inhalten gespeichert in FlexForms
  Bitte lesen Sie den Abschnitt "Configure auto-translation for FlexForm fields" in der Dokumentation.
• Automatische Übersetzung von Template-Labels
  Als Entwickler haben Sie die Möglichkeit, Labels des Templates gespeichert in Dateien locallang.xlf automatisch übersetzen zu lassen. Bitte lesen Sie den Abschnitt "Translate locallang.xlf files" in der Dokumentation. Damit wird die Integration neuer Sprachen noch einfacher.
• Problemerkennung der TYPO3-Sites
  Die TYPO3-Sites (sichtbar im Backend-Modul Sites) zeigen bei Bearbeitung im Reiter "Sprachen" mögliche Probleme bzgl. Kompatibilität und Konfiguration. Damit wird die Inbetriebnahme noch einfacher.
• Verberge unübersetzte Seiten
  Das Feature funktioniert nun stabil für die Menü-Erzeugung.

• [TASK] TYPO3 v12 / Version zu 2.0.0dev gesetzt
• [BUGFIX] verhindert R+ckgabe von NULL, wenn bei preg_replace ein Fehler auftritt
• [BUGFIX] languageAspect muss wiederhergestellt werden, wenn Seiten außerhalb einer Site angefordert werden
• !!![BUGFIX] Unübersetzte Seiten ausblenden in der Site-Konfiguration funktionierte nicht für Sprachmenüs und hatte eine inkonsistente Konfiguration
• [TASK] TYPO3 v12 / Unterstützung von TYPO3 12.4
• [TASK] TYPO3 v12 / Site Konfiguration TCA Kompatibiltät hergestellt
• [TASK] TYPO3 v12 / TCA Migration
• [TASK] TYPO3 v12 / Extension-Key bei Verwendung von translate VH hinzugefügt
• [TASK] TYPO3 v12 / Verhinderung von 503-Fehlern bei 404-Seiten für bereits übersetzte, aber deaktivierte Seiten
• [TASK] TYPO3 v12 / Migration für strict mode mit Extbase
• [TASK] TYPO3 v12 / Refaktorierung des Codes von Hooks zu Events + Markierung von Hooks für <v12 als veraltet
• [FEATURE] automatische Übersetzung von .xlf-Dateien („locallang.xlf“) für konfigurierte Erweiterungen
• !!![FEATURE] Option „Verberge unübersetzte Seiten“ ist in der Site-Konfiguration standardmäßig aktiviert
• !!![FEATURE] verhindert wiederholtes Schreiben von Fehlerprotokollmeldungen in die Protokolltabelle
• [TASK] TYPO3 v12 / Behandlung von ext_conf_template Core-Bugs
• [TASK] Code Clean-up
• [FEATURE] Ermöglicht die direkte Übergabe von nicht übersetzten Zeilen und das Setzen des Feldes id. Streamlining der Felder pid & tstamp
• [TASK] TranslationService refaktoriert
• [FEATURE] Ermöglichung eines Wertevergleichs vor einer Auslieferung aus dem campus_lingo-Caches
• [FEATURE] Festlegung des Übersetzungsstatus für Quelle=Zielsprache
• [FEATURE] TranslationServiceModifyTCAEvent zum Setzen/Ändern des TCA nur campus_lingo
• [FEATURE] LanguageOverlayService bietet API zur manuellen automatischen Übersetzung eines assoziativen Arrays
• [TASK] Ungültige URL durch DeepL Dokumentation für Zielsprachen ersetzen
• [TASK] Korrektur von PHPStan Warnungen
• [FEATURE] Konsolenbefehl campuslingo:delete-manual-translations ermöglicht das gezielte Löschen von redaktionellen Übersetzungen
• [BUGFIX] Korrektur der Seitenübersetzung im PageRouter für Seiten, die noch nicht im Übersetzungscache vorhanden sind
• [TASK] Refaktorierung der speziellen Behandlung von sys_file_reference in EventListener
• [FEATURE] Über FlexForms gespeicherte Inhalte können nun automatisch übersetzt werden (muss konfiguriert werden, siehe README)
• [BUGFIX] Gewährleistung der Kompatibilität bei der automatischen Übersetzung von FlexForms mit TYPO3 v11 & EXT:form
• [FEATURE] TCA columnsOverrides werden berücksichtigt
• [FEATURE] Backend-Modul Sites: Sprachen zeigen Hinweise zur automatischen Übersetzungskonfiguration
• [TASK] TYPO3 v13 Deprecations entfernt
• [DOC] Update README für 2.0.0
• [TASK] Version auf 2.0.0 gesetzt

Release Datum: 25.09.2024 ☆ Bugfix-Release ☆ TYPO3 v11

• [BUGFIX] vermeidet Aufruf von currentSite in CLI-Umgebung  
• [TASK] Version zu 1.6.3 gesetzt

Release Datum: 01.08.2024 ☆ Bugfix-Release ☆ TYPO3 v11

• [TASK] PHP 8.3 wird unterstützt
  [BUGFIX] korrekte automatische Platzierung von autoTranslationSettings für Datensätze mit unterschiedlichen Typen
• [TASK] Version zu 1.6.2 gesetzt

Release Datum: 16.07.2024 ☆ Bugfix-Release ☆ TYPO3 v11

Glossar-Einträge
Zahlreiche Verbesserungen und Bugfixes für die Bearbeitung und automatische Aktualisierung.

Dashboard-Widget “Übersetzte Zeichen”
Nach dem Login wird im Dashboard das Diagramm "Übersetzte Zeichen" angezeigt. Hier wird abgebildet, wie viele Zeichen in den letzten 30 Tagen übersetzt worden sind.

• [BUGFIX] Aktualisierungen des Glossars funktionieren mit Glossareinträgen, die Multibyte-UTF8-Zeichen enthalten
• [BUGFIX] Übersetzungscache: Vermeidung von Abstürzen bei zu großem Inhalt + Verwendung von LONGTEXT für die Felder Ausgangssprache und Übersetzung
• [BUGFIX] Automatische Aktualisierung des Glossars erkennt HTML-kodierte Zeichen + Cache-Einträge werden unabhängig von der HTML-Kodierung aktualisiert
• [BUGFIX] Aktualisierung des Glossars erkennt JSON-kodierte Anführungszeichen im Übersetzungscache
• [BUGFIX] Aktualisierung des Glossars: Übereinstimmung von Glossareinträgen mit Multibyte-Zeichen unabhängig von der Groß- und Kleinschreibung
• [TASK] Methode umbenannt, um ihren „unscharfen“ Charakter widerzuspiegeln
• [TASK] Version zu 1.6.1 gesetzt

Release Datum: 04.07.2024 ☆ Minor Update ☆ TYPO3 v11

• Opt-In / Opt-Out für Seiten(zweige) Es ist nun möglich, die automatische Übersetzung bewusst zu deaktivieren (in der "Sites Configuration") und dann nur für bestimmte Seiten bzw. Seitenzweige zu aktivieren (in den Seiteneigenschaften). Das Verhalten kann in darunterliegenden Seiten bzw. Seitenzweigen in den Seiteneigenschaften wieder rückgängig gemacht werden. 
  Vielen Dank an die Universtität Kassel, die dieses Feature gesponsort hat.
• Ausschluss einzelner Felder von automatischer Übersetzung über das TCA
• Die Steuerungsmöglichkeiten in den Seiteneigenschaften zur Nutzung des Übersetzungs-Services müssen nun explizit aktiviert werden in der Sites Configuration und sind ansonsten nicht sichtbar.

• [BUGFIX] Tippfehler beim Entfernen von „/“ aus TYPO3_SITE_PATH behoben
• [FEATURE] TCA autotranslate_forbidden, um die automatische Übersetzung ausdrücklich zu verbieten
• [TASK] neues Extension-Icon
• [FEATURE] „Opt-In": Umschalten der automatischen Übersetzung für Unterseiten kann für Unterseiten rückgängig gemacht werden
• [BUGFIX] selectCheckBox muss ein Neuladen auslösen, wenn onChange=reload konfiguriert ist
• [FEATURE] Seiteneigenschaften: Konfigurationsfeld für automatische Übersetzung für alle Seitentypen anzeigen
• [FEATURE] Einrichtung eines Static Member Laufzeit-Caches + Refaktorierung
• !!![FEATURE] Deaktivierung des Übersetzungsdienstes über Seiteneigenschaften, konfigurierbar über Websites, Standardeinstellung „aus“
• [TASK] Sites-Konfiguration: Platzhalter für Campus Lingo Sprachcode
• [TASK] Code Cleanup
• [BUGFIX] funktionale Felder von sys_file_reference dürfen nicht automatisch übersetzt werden
• [TASK] Update @see Links
• [TASK] Refaktorierung der erlaubten Typen und renderTypes
• [DOC] Bessere Beschreibung für die Verwendung von TCA API
• [BUGFIX] Der TYPO3 Context darf nicht gecached werden
• [TASK] Version zu 1.6.0 gesetzt

Release Datum: 23.11.2024 ☆ Minor Update ☆ TYPO3 v11

Automatische Aktualisierung durch Glossar-Einträgen
Automatische Aktualisierung bereits bestehender Übersetzungen bei Neu-Anlage, Änderung oder Löschung eines Glossar-Eintrags. Es werden nur die Übersetzungen aktualisiert, die den Glossar-Begriff in der Ausgangssprache oder der Übersetzung enthalten.

Release Datum: 31.08.2023 ☆ Minor Update ☆ TYPO3 v11

• Ausweichslösungstyp "Strikt" wird unterstützt
• Berücksichtigung der Einstellungen für automatische Übersetzung in den Seiteneigenschaften, die nicht der aktuellen Seite entsprechen
• Neue Konfigurations-Optionen:
  • Seiteneigenschaften / pages.l18n_cfg kann über automatische Übersetzung mitgesteuert werden
  • Seiteneigenschaften / Optionen zur optionalen Abschaltung von CampusLingo API aber unter Beibehaltung des Übersetzungscache können deaktiviert werden

Release Datum: 23.05.2023 ☆ Minor Update ☆ TYPO3 v11

TCA-Steuerungsoption zum expliziten redaktionellen Ausschluss beliebiger Datensätze

Release Datum: 04.05.2023 ☆ Minor Update ☆ TYPO3 v11

Platzhalter <!-- CAMPUS_LINGO_AUTOTRANSLATION_INFORMATION --> in Templates zeigt eine Information, ob sich auf der aktuellen Seite automatisch übersetzte Inhalte befinden.

Release Datum: 02.05.2023 ☆ Minor Update ☆ TYPO3 v11

TCA-Option zum redaktionellen Deaktivieren automatischer Übersetzung beliebiger Datensätze (z.B. News, Inhaltselemente, …). 
Aktivierbar per TCA über API-Methode (siehe README)

Release Datum: 23.03.2023 ☆ Erste öffentliche Version ☆ TYPO3 v11