Contao Multilingual Pagetree

Mehrsprachige Contao-Websites in einem gemeinsamen Seitenbaum verwalten.

English version: README.en.md

Contao Multilingual Pagetree erweitert Contao um einen redaktionellen Übersetzungs-Workflow, ohne für jede Sprache einen getrennten Seitenbaum anzulegen. Alle Sprachen einer Website teilen sich eine Seitenstruktur; Übersetzungen werden über Sprachregister direkt in den gewohnten Contao-Bearbeitungsformularen gepflegt. Bei Bedarf können Inhalte einer Sprache auch unabhängig gepflegt werden.

• Paket: vtinnovations/contao-multilingual-pagetree
• Typ: contao-bundle
• Namensraum: Vtinnovations\ContaoMultilingualPagetree
• Lizenz: proprietär

Funktionsumfang

• ein gemeinsamer Seitenbaum für alle konfigurierten Sprachen
• Sprachregister direkt in den Contao-Bearbeitungsformularen
• verbundene Übersetzungen mit den Feldzuständen Vererben, Eigene Übersetzung und Bewusst leer
• freie Sprachinhalte mit unabhängigen Artikeln und Inhaltselementen
• übersetzte Aliase für Seiten, Nachrichten, Termine und FAQ
• Sprach-URLs je Sprache: Protokoll, eigene Domain und Einstiegspfad
• gleiche Domain mit Pfadpräfixen, getrennte Domains oder eine Mischung aus beidem
• Sprachwechsler als Frontend-Modul mit Verfügbarkeitsprüfung
• kanonische URLs, hreflang und x-default
• redaktioneller Prüfstatus nach Änderungen der Ausgangssprache
• Integritätsprüfung mit Vorschau vor Reparaturen
• strikte oder rückfallende Seitenverfügbarkeit je Zielsprache
• getrennte Verwaltung je Website-Startpunkt in Installationen mit mehreren Websites

Status

Das Paket ist funktionsfähig implementiert und noch nicht versioniert veröffentlicht. Der Changelog führt den Stand des main-Branches unter ## [Unreleased].

Voraussetzungen

Die Integrationen für News, Kalender und FAQ werden nur aktiv, wenn das jeweilige Contao-Bundle installiert ist.

Installation

Alternativ über den Contao Manager. Ersetzen Sie das Paketverzeichnis bei einem Update vollständig, damit entfernte Dateien nicht bestehen bleiben.

Die Datenbankaktualisierung ist erforderlich: Das Paket legt eigene Tabellen und Spalten an.

Dateisystem und Laufzeitverzeichnisse

Das Paket schreibt ausschließlich unterhalb von var/ und damit außerhalb des öffentlichen Verzeichnisses:

Beide Verzeichnisse müssen für den PHP-Prozess beschreibbar sein. Ein noch nicht vorhandenes Verzeichnis ist ein gültiger Ausgangszustand.

Zugriff im Backend

Die Sprachverwaltung eines Startpunkts bietet je Sprache: Sprachcode, Bezeichnung, Flagge, Sprach-URL, Seitenverfügbarkeit, Inhaltsübersetzungsmodus und Veröffentlichung.

Sprach-URLs

Jede Sprache kann Protokoll, Domain und Einstiegspfad eigenständig festlegen. Alle drei Felder sind optional.

Ein leeres Feld und ein ausdrückliches / sind unterschiedliche Zustände. Beim Speichern werden mehrdeutige Zuordnungen abgelehnt – etwa zwei veröffentlichte Sprachen mit gleichem Hostnamen und gleichem Einstiegspfad, Zuordnungen, die erst nach Normalisierung gleich sind, Unterscheidungen allein über das Protokoll oder ein Hostname, der bereits zu einer anderen Website-Wurzel gehört.

Details und Beispiele: Benutzerhandbuch.

Übersetzung von Inhalten

Verbundener Modus – Struktur, Typ und Reihenfolge bleiben bei der Ausgangssprache; übersetzt werden freigegebene Felder. Inhaltselemente werden dabei im gewohnten Formular der Ausgangssprache bearbeitet; nur die Werte gehören zur gewählten Sprache.

Freier Modus – die Zielsprache besitzt eigene Artikel und Inhaltselemente. Quellinhalte werden nicht automatisch ausgegeben.

Ein Moduswechsel löscht keine Inhalte.

Seitenverfügbarkeit

Die Einstellung gilt je Zielsprache und bestimmt auch das Verhalten nicht übersetzter Inhaltsfelder.

Berechtigungen

Der Zugriff folgt den nativen Contao-Mechanismen: Administratoren haben immer Zugriff; andere Backend-Benutzer benötigen das Modul Seitenstruktur, die passende Seitenfreigabe sowie die normalen Tabellen- und Feldrechte. Eine eigene paketbezogene Lizenzberechtigung gibt es nicht.

Alle schreibenden Vorgänge werden serverseitig geprüft. Eine im Formular ausgeblendete Schaltfläche gilt nicht als Berechtigung.

Lizenzierung

Das Paket benötigt eine gültige Lizenz je Website-Startpunkt. Maßgeblich ist die exakt konfigurierte Domain des Startpunkts.

Die Lizenz ist kostenlos, wird lebenslang ausgestellt und schaltet den vollen Funktionsumfang frei: Es gibt weder eine kostenpflichtige noch eine befristete Stufe. Kostenlos ist jedoch nicht lizenzfrei — solange an einem Startpunkt keine Lizenz aktiviert ist, bleibt dessen mehrsprachige Verwaltung gesperrt.

Bedienung, Zustände und Fehlerbehandlung: Lizenzverwaltung.

Sicherheitsmodell

• Berechtigungen werden serverseitig durchgesetzt, nicht über die Sichtbarkeit von Bedienelementen.
• Schreibende Backend-Aktionen laufen über POST mit Contao-Anfrage-Token.
• Sprach-, Wurzel- und Datensatzbezüge werden gegen die gespeicherte Konfiguration geprüft; manipulierte Werte werden abgelehnt.
• Website-Startpunkte sind gegeneinander isoliert; sprachspezifische Domains werden exakt verglichen, ohne Platzhalter und ohne Übernahme übergeordneter Domains.
• Lizenzdaten liegen außerhalb des öffentlichen Verzeichnisses.
• Definierte Lizenzvorgänge kontaktieren einen vertrauenswürdigen HTTPS-Dienst; ausgetauschte Daten werden authentifiziert und auf Unversehrtheit geprüft.
• Schlägt eine Prüfung fehl, bleiben eingeschränkte Funktionen deaktiviert.
• Lizenzschlüssel und vollständige Authentifizierungsdaten erscheinen weder in der Browser-Ausgabe noch in regulären Protokollen.

Interne Prüf-, Kommunikations- und Speichermechanismen werden bewusst nicht öffentlich dokumentiert.

Externe Kommunikation

Das Paket kontaktiert externe Dienste ausschließlich bei ausdrücklich ausgelösten Lizenzvorgängen sowie beim serverseitig authentifizierten Aktualisierungsendpunkt. Das Öffnen der Seiteneinstellungen löst keine externe Prüfung aus. Frontend-Auslieferung und redaktionelle Arbeit finden ohne externe Aufrufe statt.

Protokollierung

Das Paket schreibt in eigene Monolog-Kanäle. Lizenzvorgänge protokollieren Ergebniskategorien und Referenzen, keine Schlüssel und keine vollständigen Antwortinhalte.

Konsolenbefehle

Die Integritätsprüfung verändert keine Daten. Prüfen Sie die Vorschau, bevor Sie Reparaturen bestätigen; mehrdeutige Beziehungen werden nicht automatisch aufgelöst.

Frontend-Integration

Das Frontend-Modul Sprachwechsler (language_switcher, Kategorie Verschiedenes) bietet horizontale oder vertikale Flaggen, Beschriftungen oder beides. Die vorhandenen Optionen für nicht verfügbare Sprachen, das Ausblenden der aktiven Sprache und eigene Modultemplates bleiben erhalten. Die Seitenverfügbarkeit wird je zusätzlicher Sprache des Startpunkts festgelegt: Nicht übersetzte Seiten werden entweder ausgeblendet und liefern einen echten 404 oder zeigen die Standardseite bei weiterhin aktiver Zielsprache. Der Inhaltsrückfall wird getrennt festgelegt: Fehlende verbundene Inhaltsübersetzungen werden ausgelassen oder ohne Kopie aus der Quelle dargestellt. Inhaltselemente zeigen keine redaktionellen Prüfaktionen mehr; die Seitenprüfung bleibt erhalten.

Kanonische Adressen, hreflang und x-default werden automatisch ausgegeben und verwenden jeweils Protokoll, Hostnamen und Einstiegspfad der Zielsprache.

Deployment

Nach Änderungen an Sprach-URLs ist ein Cache-Neuaufbau erforderlich, da Zuordnungen und Pfadpräfixe zwischengespeichert werden.

Cache leeren

Im Contao Manager entspricht dies der Aktion zum Leeren des Anwendungscaches.

Tests

Fehlerbehebung

Weitere Schritte: Serverdiagnose.

Bekannte Einschränkungen

• Für Inhaltselemente wird eine Übersetzung nur in Feldern gespeichert, für die eine Spalte in der Übersetzungsablage besteht. Felder aus Fremd-Erweiterungen werden im gewohnten Formular angezeigt, sind aber erst nach Registrierung über den vorgesehenen Erweiterungspunkt übersetzbar.
• Wird eine Sprache nachträglich auf eine eigene Domain umgestellt, verlieren zuvor gültige Adressen mit Sprachcode ihre Route. Für dauerhafte Weiterleitungen sind eine Contao-Weiterleitungsseite oder eine Webserver-Regel vorgesehen.
• Die Integritätsreparatur löst mehrdeutige Beziehungen nicht selbstständig auf.
• Das Paket setzt Contao 5 voraus; Contao 4 wird nicht unterstützt.

Dokumentation

Deinstallation

Sichern Sie zuvor Datenbank und Dateien. Das Entfernen des Composer-Pakets löscht keine gespeicherten Übersetzungsdaten. Prüfen Sie den Datenbestand vorher mit integrity:scan oder data-report.

Lizenz und Urheberrecht

Proprietär. Copyright: V&T Innovations Team, www.v-t.one.

Support: Issue-Tracker.