...
Um Übersetzungen zu definieren, können Sie für die verschiedenen Sprachen nach dem ISO_639-1 Standard im Ordner languages verschiedene (language).xml Dateien anlegen. Diese werden während eines Clean Installs einer Installation zunächst ausgelesen und in die Datenbanktabelle 'content_translations' importiert. Anschließend liegen alle Übersetzungen in der Datenbank vor.Tabelle Übersetzungen importiert.
| Codeblock | ||||||
|---|---|---|---|---|---|---|
| ||||||
<?xml version="1.0" encoding="UTF-8"?>
<body>
<group>
<text id="Meine Überschrift">Meine Überschrift mit dem Identifikator "Meine Überschrift"</text>
<text id="Mein Text mit HTML"><![CDATA[Mein Text mit einem <br /><strong>HTML-Umbruch</strong>]]></text>
</group>
</body> |
...
| Codeblock | ||||||
|---|---|---|---|---|---|---|
| ||||||
<text id="x-brandbox-invalid-something">Fehler something trat auf.</text> <text id="x-brandbox-info-something">Zur Info: something is happening...</text> <text id="x-brandbox-success-something">Something wurde erfolgreich ausgeführt.</text> <text id="x-brandbox-my-very-own-header">Auch mein eigener Header kann übersetzt werden.</text> |
Die Tabelle Übersetzungen
Die Tabelle Übersetzungen wird innerhalb der Administrationsoberfläche unter "Administration" > "Übersetzungen" > "Übersetzungen" aufgerufen. Hier werden alle Übersetzungen gelistet, bearbeitet, weitere Übersetzungen hinzugefügt sowie entfernt. Eine Übersetzung beinhaltet folgende Felder:
Allgemein
App: Gibt die App-Zugehörigkeit der Übersetzung an.
Schlüsselwort: Gibt das zu Übersetzende Schlüsselwort an.
Zu überwachen: Gibt den Status einer Übersetzung an. Diese weißt darauf hin, dass entweder nicht alle aktiven Kollationen gepflegt wurden oder Übersetzungsschlüssel ungültig sind.
Übersetzung: Anzuzeigender Übersetzungstext.
Informationen
ID: Eindeutiger Bezeichner der Übersetzung.
Erstellt: Erstellungsdatum der Übersetzung.
Aktualisiert: Letztes Änderungsdatum der Übersetzung.
Übersetzungslogik
Übersetzungen werden Anhand der "I18n\TranslationManager::__"-Methode abgerufen. Diese holt zunächst die verwendete Kollation des eingeloggten Nutzers. Anhand der Einstellungen der Kollation, des zu Übersetzenden Schlüsselworts und der betroffenen App wird zunächst innerhalb des Caches überprüft, on diese bereits geladen wurde. Ist dies nicht der Fall, wird die angefragte Übersetzung aus der Datenbank geladen und anschließend gecached.
I18n\TranslationManager::__
Lädt eine Übersetzung anhand gegebener Parameter und gibt diese zurück.
Beschreibung
| Codeblock | ||||
|---|---|---|---|---|
| ||||
I18n\TranslationManager::__(string $package = '', string $id = '', array $args = []): string |
I18n\TranslationManager::__() gibt den zugehörigen Übersetzungsstring zurück.
Parameter
package Der zu Übersetzende App-Kontext (= App-Feld der Übersetzungstabelle)
id Das zu Übersetzende Schlüsselwort (= Schlüsselwort-Feld der Übersetzungstabelle)
args Optionen