Einstellungen der UI-Umschaltung: die Wahl der Sprache der Oberfläche #

Diese Anleitung richtet sich an den Administrator einer Installation. Am Ende kennen Sie jede Einstellung der UI-Umschaltung, können eine weitere Sprache der Oberfläche anbieten, die Wahl auf einige Siteaccesses beschränken oder abschalten, den Eintrag der Werkzeugleiste in einer bestehenden Installation ergänzen und die Wahl einer Rolle geben. Was Benutzer sehen, steht auf der Funktionsseite; wie Code eine eigene Wahl hinzufügt, steht in der Provider-API.

Fügen Sie --allow-root-user hinzu, wenn Sie einen Befehl als root ausführen.

1. Was das System tut, in einem Absatz #

Ein angemeldeter Benutzer mit der Richtlinie uiswitch/language wählt die Sprache der Administrationsoberfläche in der rechten Werkzeugleiste, nach den Lesezeichen. Die Wahl wird in der Sitzung für diesen Siteaccess und diesen Benutzer gehalten und früh in jeder Anfrage angewendet: Sie setzt site.ini [RegionalSettings] Locale im Speicher, nur für die Anfragen dieses Benutzers, sodass die Übersetzungen, die Datums- und Zahlenformate und die Sprache der Seite ihr folgen. Inhaltssprachen werden nie geändert. Die Auswahlmöglichkeiten kommen von Providern, die in settings/uiswitch.ini aufgeführt sind; der Sprach-Provider ist der erste.

2. Die Einstellungen: settings/uiswitch.ini #

Bearbeiten Sie niemals settings/uiswitch.ini selbst. Legen Sie Änderungen in settings/override/uiswitch.ini.append.php (jeder Siteaccess), in settings/siteaccess/<siteaccess>/uiswitch.ini.append.php (ein Siteaccess) oder in settings/uiswitch.ini.append.php einer Extension ab.

[UISwitchSettings] #

[UISwitch_language] #

Eine Locale wird nur angeboten, wenn ihr Code ein Locale-Code ist (eng-GB, nor-NO@intl) und share/locale/<locale>.ini existiert (mit ListUntranslated=disabled außerdem eine Übersetzung, außer für Englisch); alles andere in den Einstellungen wird stillschweigend ausgelassen. Die eigene Locale des Siteaccess wird immer angeboten, und wer sie wählt, hebt die Wahl auf. Das sind auch die einzigen Werte, die uiswitch/set annimmt. Ein Provider mit weniger als zwei anzubietenden Werten erscheint nicht in der Werkzeugleiste.

Mit Gruppen oder AllLanguages=enabled ist die Auswahl ein Listenfeld mit einer Überschrift pro Gruppe und einer Schaltfläche Übernehmen; jeder Eintrag zeigt den eigenen Namen der Sprache, ihren Namen in der aktuellen Sprache der Oberfläche und wie vollständig ihre Übersetzung ist („Deutsch (Deutschland) — German (Germany) (99%)“, „Kiswahili (Kenya) — Swahili (Kenya) (no translation yet)“). Wie die Namen, die Reihenfolge von A bis Z und die Prozentwerte entstehen: die Funktionsseite.

3. Beispiele #

Nur in einigen Siteaccesses #

<?php /* #?ini charset="utf-8"?

[UISwitchSettings]
SiteAccessList[]
SiteAccessList[]=admin
SiteAccessList[]=editor
*/ ?>

Die leere Zeile SiteAccessList[] leert die Liste zuerst, bevor die Einträge hinzugefügt werden.

Die Gruppen ändern #

Eine Liste in einem Override ersetzt die Standardliste, wenn sie mit einer leeren Zeile beginnt (GroupValues_major[]). Ein Unternehmen, das in Europa arbeitet, könnte seine eigenen Sprachen an den Anfang stellen:

<?php /* #?ini charset="utf-8"?

[UISwitch_language]
GroupList[]
GroupList[]=ours
GroupList[]=english
GroupLabel[ours]=Our languages
GroupValues_ours[]
GroupValues_ours[]=ger-DE
GroupValues_ours[]=fre-FR
GroupValues_ours[]=ita-IT
*/ ?>

Eine neue Überschrift braucht ihre Übersetzung im Kontext kernel/uiswitch/language (in translations/ einer Extension), sonst wird sie so angezeigt, wie sie geschrieben ist. Ohne die leeren Zeilen werden die Einträge zu den Standardeinträgen hinzugefügt.

Nur wenige Sprachen anbieten #

Keine Gruppen und keine Liste aller Locales von A bis Z: Die Auswahl ist die Liste von Schaltflächen, mit der eigenen Sprache des Siteaccess und den genannten Sprachen:

<?php /* #?ini charset="utf-8"?

[UISwitch_language]
GroupList[]
AllLanguages=disabled
AllowedValues[]
AllowedValues[]=eng-GB
AllowedValues[]=ger-DE
*/ ?>

Nur übersetzte Sprachen #

<?php /* #?ini charset="utf-8"?

[UISwitch_language]
ListUntranslated=disabled
*/ ?>

Die Gruppen zeigen dann nur Englisch und die Sprachen mit share/translations/<locale>/translation.ts.

Eine Sprache hinzufügen #

Französisch braucht zwei Dateien, die beide mitgeliefert werden:

• share/locale/fre-FR.ini (die Locale: Datums- und Zahlenformate, der Name Français (France));
• share/translations/fre-FR/translation.ts (die Übersetzung der Oberfläche).

Mit den mitgelieferten Einstellungen wird Französisch bereits angeboten (Wichtige Weltsprachen und von A bis Z). Eine Locale, die share/locale hat, aber keine Gruppe nennt, wird über AllLanguages=enabled angeboten; um sie einzuordnen, fügen Sie sie einer Gruppe hinzu:

<?php /* #?ini charset="utf-8"?

[UISwitch_language]
GroupValues_major[]=swe-SE
*/ ?>

Eine neue Übersetzung (share/translations/<locale>/translation.ts) zeigt ihren Prozentwert beim nächsten Seitenaufruf: Der Katalog der Namen und Prozentwerte wird im Cache-Verzeichnis (uiswitch/) zwischengespeichert und von selbst neu aufgebaut, wenn sich eine Locale- oder Übersetzungsdatei ändert.

Die Wahl über das Abmelden hinaus behalten #

<?php /* #?ini charset="utf-8"?

[UISwitch_language]
RememberPreference=enabled
*/ ?>

Die Wahl wird dann auch in den Voreinstellungen des Benutzers gespeichert und erneut angewendet, wenn in der Sitzung nichts gespeichert ist. Wer die eigene Sprache des Siteaccess wählt, löscht auch den gemerkten Wert.

Abschalten #

Überall:

<?php /* #?ini charset="utf-8"?

[UISwitchSettings]
Enabled=false
*/ ?>

Nur den Sprach-Provider, wobei jeder Provider, den eine Extension hinzufügt, erhalten bleibt:

<?php /* #?ini charset="utf-8"?

[UISwitch_language]
Enabled=false
*/ ?>

Nur in einem Siteaccess: dieselben Zeilen in settings/siteaccess/<siteaccess>/uiswitch.ini.append.php.

Leeren Sie nach jeder Änderung von uiswitch.ini den INI-Cache (php bin/php/ezcache.php --clear-tag=ini) und laden Sie PHP-FPM neu oder starten Sie Velocity neu.

4. Die Werkzeugleiste in einer bestehenden Installation #

Neue Installationen erhalten den Eintrag der Werkzeugleiste vom Installer (Siteaccesses admin, editor und adminui). Eine zuvor eingerichtete Installation muss ihn einmal hinzufügen.

admin4, der Siteaccess editor und AdminUI: toolbar.ini #

Fügen Sie in settings/siteaccess/<admin siteaccess>/toolbar.ini.append.php (und ebenso für die Siteaccesses editor und adminui) das Werkzeug der Liste der verfügbaren Werkzeuge hinzu und setzen Sie es in [Toolbar_admin_right] direkt nach Tool[]=admin_bookmarks:

[Tool]
AvailableToolArray[]
AvailableToolArray[]=setup_link
AvailableToolArray[]=admin_current_user
AvailableToolArray[]=admin_bookmarks
AvailableToolArray[]=admin_ui_switch
AvailableToolArray[]=admin_clear_cache
AvailableToolArray[]=admin_quick_settings

[Toolbar_admin_right]
Tool[]
Tool[]=admin_clear_cache
Tool[]=admin_bookmarks
Tool[]=admin_ui_switch
Tool[]=admin_current_user
Tool[]=admin_preferences

Lassen Sie die übrigen Zeilen Ihrer Datei, wie sie sind; nur die beiden Zeilen mit admin_ui_switch sind neu. Das Template des Werkzeugs ist design/admin4/templates/toolbar/full/admin_ui_switch.tpl, daher muss die Designliste des Siteaccess admin4 enthalten (admin4l, editor und adminui führen es als Fallback). Ein Siteaccess, der allein auf den klassischen Designs läuft (admin, admin2, admin3), hat kein Template für das Werkzeug; lassen Sie es dort weg.

admin4l mit der rechten Spalte aus einem Layout #

Wenn der Admin-Siteaccess seine rechte Spalte aus dem Admin-Layout von explayouts bezieht, wird die Liste der Werkzeugleiste nicht verwendet. Öffnen Sie das Admin-Layout im Layout-Editor, fügen Sie den Block Admin: Auswahl der Oberfläche (Sprache) (admin_ui_switch) nach dem Lesezeichen-Block in die rechte Zone ein und veröffentlichen Sie das Layout. Neue Installationen erhalten ihn aus dem Fragment der Admin-Layouts von explayouts.

Seitenleiste von AdminUI #

Die Seitenleiste von AdminUI zeigt das Dropdown Oberfläche, wenn exp_adminui.ini das Plugin aufführt, wie es standardmäßig der Fall ist:

[MenuPlugins]
Enabled[]=uiswitch

Eine Installation, deren Override Enabled[] ersetzt, muss die Zeile dort nach Enabled[]=bookmarks hinzufügen.

Die Caches leeren #

Die Liste der Werkzeuge der Werkzeugleiste wird in das kompilierte Template des Pagelayouts kompiliert, daher wird eine Änderung von toolbar.ini erst sichtbar, nachdem die kompilierten Templates neu erzeugt wurden:

php bin/php/ezcache.php --clear-tag=ini
php bin/php/ezcache.php --clear-tag=template

Laden Sie dann PHP-FPM neu, oder führen Sie unter Velocity ./console exp:velocity deploy aus.

5. Richtlinien #

Die Auswahl wird nur einem Benutzer angezeigt, der uiswitch/<provider> besitzt, für die Sprache uiswitch/language. Die Richtlinie hat keine Einschränkungen: Eine Rolle hat sie oder nicht.

• Administrator hat sie über seine Richtlinie für jedes Modul.
• Editor hat sie in neuen Installationen (saubere Daten und die Multi-Site-Installer).

Um sie einer Rolle zu geben:

1. Öffnen Sie Benutzerkonten > Rollen und Richtlinien und die Rolle, dann Bearbeiten.
2. Neue Richtlinie, Modul uiswitch, Funktion language.
3. Es gibt keine Einschränkungen zu wählen; speichern Sie die Richtlinie und die Rolle.

Die Richtlinie wird bei jeder Anfrage geprüft; wird sie entfernt, wirkt die gespeicherte Wahl eines Benutzers ab der nächsten Seite nicht mehr und wird aus der Sitzung entfernt. Ein Provider, den eine Extension hinzufügt, erhält eine eigene Funktion im selben Modul (uiswitch/<identifier>), die aufgeführt wird, sobald ProviderList[] ihn nennt.

6. Prüfen #

• Melden Sie sich als Benutzer mit der Richtlinie an und öffnen Sie eine Seite des Admin-Siteaccess: Der Kasten Oberfläche steht nach den Lesezeichen.
• <admin url>/uiswitch/state antwortet mit JSON: dem Siteaccess und, für jeden Provider, den der Benutzer verwenden darf, dem Bezeichner, dem Titel, dem aktuellen Wert und den Werten mit ihren Bezeichnungen.
• Nach einer Änderung führt die Audit-Konsole ein Ereignis access.uiswitch.change auf.

Siehe auch #

• Die Sprache der Oberfläche: was Benutzer sehen.
• Die Liste der Oberflächensprachen: die Gruppen, die Reihenfolge von A bis Z, die Abdeckung der Übersetzungen und warum die Standardrangfolge so ist, wie sie ist.
• Die Provider-API der UI-Umschaltung: eine Wahl aus einer Extension hinzufügen.
• Rollen und Richtlinien, Caches, Inhaltssprachen.