Sprache wechseln · Lokalisierung

InfraGuard ist eine Konsole in 8 Sprachen, mit Koreanisch als Standard der Zentrale und Englisch als globaler Rückfallsprache. Dieser Artikel behandelt (1) wie Benutzer die Sprache über den Umschalter in der Kopfzeile wechseln, (2) wie die Anzeigesprache bei jeder Anfrage bestimmt wird und (3) wie ein Administrator festlegt, welche Sprachen im Umschalter erscheinen.

Überblick — wozu es dient

Jede Beschriftung, jeder Menüpunkt und jede Meldung der Konsole läuft über einen Übersetzungsschlüssel (__('menu.security') usw.) statt über fest einprogrammiertes Englisch. Nach einem Sprachwechsel rendert der Server die Oberfläche ab der nächsten Anfrage aus den Übersetzungsdateien dieser Sprache (resources/lang/{locale}/*.php).

Der Katalog der unterstützten Sprachen sind die 8 Einträge unter admin in config/locales.php. Jede Sprache wird stets mit ihrer eigenen nativen Bezeichnung angezeigt, unabhängig von der gerade aktiven Sprache.

Anfangs sind nur ko und en wirklich übersetzt (priority => ['ko','en'] in config/locales.php). Die übrigen sechs (ja·zh·es·fr·de·ru) haben noch keine Übersetzungsdateien und fallen automatisch auf en zurück (fallback_locale = en in config/app.php). Wer heute ja wählt, sieht nicht übersetzte Texte daher weiterhin auf Englisch — der Umschalter listet alle 8 Sprachen auf, zurück fällt nur der Wortlaut.

Wann Sie es nutzen

• Ein Besucher möchte die Konsole in einer vertrauten Sprache sehen — verwenden Sie den Sprachumschalter in der Kopfzeile.
• Sie möchten die Sprache auch auf der Anmeldeseite wechseln (bevor eine Sitzung existiert) — /lang/{locale} ist für Gäste erlaubt.
• Sie möchten organisationsweit nur bestimmte Sprachen anbieten und die Standardsprache für Erstbesuche festlegen — ein Administrator bearbeitet die aktivierte Menge und deren Reihenfolge (siehe „Aktivierte Sprachen verwalten“ weiter unten).

Aufbau

Sprachumschalter in der Kopfzeile (auf jedem Bildschirm)

Das Sprach-Dropdown in der Kopfzeile (layouts.partials.locale-switch + ui/locale-dd.js) listet nur die vom Administrator aktivierten Sprachen auf. Jeder Eintrag zeigt die native Bezeichnung sowie ein kurzes Kürzel (z. B. KO, EN); die aktuelle Sprache ist als aktiv gekennzeichnet.

Verwaltung ▸ Lokalisierung (aktivierte Sprachen verwalten)

Auf dem Bildschirm Verwaltung ▸ Lokalisierung (über die Schaltfläche oben rechts erreichbar) können Sie für den Katalog der 8 Sprachen:

• jede Sprache ein- und ausschalten (ob sie im Umschalter erscheint);
• per Ziehen umsortieren — die oberste aktivierte Sprache wird zur primären Sprache (Standard) der Website;
• speichern, wobei mindestens eine Sprache erzwungen wird (das Speichern von null Sprachen wird abgelehnt).

Verwendung

1) Über den Umschalter in der Kopfzeile wechseln

1. Öffnen Sie das Sprach-Dropdown in der Kopfzeile.
2. Wählen Sie eine Sprache → der Browser navigiert zu GET /lang/{locale}.
3. Der Server speichert Ihre Wahl und leitet zurück auf die vorherige Seite (redirect()->back()). Die neue Sprache gilt ab dem nächsten Rendern.

Der Endpunkt zum Wechseln sieht so aus:

GET /lang/ko      # zu Koreanisch wechseln
GET /lang/en      # zu Englisch wechseln
GET /lang/ja      # Japanisch (nicht übersetzt → Rückfall auf en)

Was der Server (LocaleController@switch) beim Wechsel tut:

Wechselt ein angemeldeter Benutzer die Sprache, wird die Wahl zusätzlich in users.lang (Profilsprache) gespeichert, sodass die Sprache die nächste Anmeldung übersteht. Die Wahl von Gästen (nicht angemeldet) bleibt nur in Sitzung und Cookie erhalten.

Ein Aufruf von /lang/{locale} mit einem nicht unterstützten (oder vom Administrator deaktivierten) Code wird stillschweigend ignoriert, und die aktuelle Sprache bleibt bestehen — es wird kein Fehler ausgelöst.

2) Wie die Anzeigesprache bestimmt wird (SetLocale)

Die Middleware SetLocale bestimmt die Sprache bei jeder Web-Anfrage (auch auf der Anmeldeseite) nach der folgenden Rangfolge. Ein Kandidat wird nur akzeptiert, wenn er eine derzeit aktivierte Sprache ist.

1. session infr_locale   (in dieser Sitzung ausdrücklich über den Umschalter gewählt)
2. cookie  infr_locale   (dauerhafte Wahl über Besuche hinweg · gilt vor der Sitzung auch auf der Anmeldeseite)
3. session infr_lang     (Profil des angemeldeten Benutzers users.lang → bei der Anmeldung in die Sitzung geladen)
4. Standard der Website  (Locales::primary() = erste Sprache in der aktivierten Liste)

Eine automatische Erkennung über Accept-Language des Browsers findet NICHT statt. Ein Erstbesuch ohne Sitzung, Cookie oder Profilwahl wird deterministisch in der vom Administrator festgelegten Standardsprache der Website ausgeliefert, nicht in der Browsersprache (die Website-Einstellung hat Vorrang). Besucher können sie jederzeit über den Umschalter in der Kopfzeile ändern.

3) Aktivierte Sprachen verwalten (Administrator)

1. Öffnen Sie Verwaltung ▸ Lokalisierung.
2. Schalten Sie die anzubietenden Sprachen ein (Umschalter, Sprachwechsel, Profilsprache und die mehrsprachige Bearbeitung im Inventar laufen alle über diese Menge) und die übrigen aus.
3. Sortieren Sie per Ziehen um — die oberste aktivierte Sprache wird zum Standard.
4. Speichern Sie. Das Speichern wird als localization.save in infr_audit_log auditiert.

Weniger aktivierte Sprachen schränken das Angebot des Umschalters in der Kopfzeile sofort ein. Zur Absicherung muss mindestens eine Sprache aktiviert bleiben (das Speichern von null Sprachen gibt 422 zurück); bleibt kein gültiger Code übrig, fällt das System auf den vollständigen Katalog zurück, sodass immer mindestens eine garantiert ist.

Datenquellen

Die Einstellungen zu aktivierten Sprachen und Reihenfolge liest App\Support\Locales mit einem 60-Sekunden-Cache. Bei einem Datenbankfehler oder fehlender Einstellung fällt er sicher auf ein leeres Array zurück (→ vollständiger Katalog). Nach dem Speichern macht Locales::flush() den Cache sofort ungültig.

-- Wo die aktivierte Menge und die Reihenfolge gespeichert sind (Beispiel)
SELECT `group`, `key`, `value` FROM infr_setting WHERE `group` = 'i18n';
-- group | key     | value
-- i18n  | order   | ko,en,ja,zh,es,fr,de,ru
-- i18n  | enabled | ko,en

Übergabe an das Frontend

Der Server übergibt die aktive Sprache und das Meldungspaket an den Bootstrap der View (z. B. window.__t = @json(__('msg')), window.__locale). Vue-Seiten und Mixins nutzen sie, um Zeichenketten clientseitig zu rendern und Datumsangaben gemäß der aktiven Oberflächensprache zu formatieren.

Zugriff

• Der Sprachwechsel selbst steht allen offen (er ist keine sensible Aktion).
• Der Administrationsbildschirm, der über die im Umschalter angebotenen Sprachen entscheidet, ist Administratoren vorbehalten: doppelte Absicherung durch die Routengruppe infr.level:10 plus eine eigene Prüfung im Controller (user_level >= 10). Die Stufen sind demo=1 · staff=5 · admin=10 (siehe Zugriffsstufen · RBAC).

Fehlerbehebung und FAQ

Die gewünschte Sprache fehlt im Umschalter

Sehr wahrscheinlich hat ein Administrator sie deaktiviert. Schalten Sie sie in Verwaltung ▸ Lokalisierung ein. Umschalter, Sprachwechsel und Profilsprache laufen alle über die aktivierte Menge.

Ich habe die Sprache gewechselt, ein Teil des Textes ist aber weiterhin Englisch

ja·zh·es·fr·de·ru haben noch keine echten Übersetzungsdateien und fallen auf en zurück (anfängliche Strategie). Dass nur die nicht übersetzten Texte auf Englisch erscheinen, ist erwartungsgemäß. ko und en sind vollständig übersetzt.

Der Erstbesuch öffnet sich nicht in meiner Browsersprache

Das ist beabsichtigt. InfraGuard liest Accept-Language nicht; es öffnet sich in der vom Administrator festgelegten Standardsprache der Website (der ersten Sprache in der aktivierten Liste). Sobald Sie wechseln, wird die Wahl in Sitzung und Cookie gespeichert und bei späteren Besuchen beibehalten.

Nach dem Abmelden und erneuten Anmelden wird meine Sprache zurückgesetzt

Ist das Cookie (infr_locale, 1 Jahr) vorhanden, bleibt die Sprache erhalten. Bei angemeldeten Benutzern wird die Wahl zusätzlich in users.lang gespeichert und bei der nächsten Anmeldung als Profilsprache wiederhergestellt. Ohne Cookie und ohne Profil öffnet sich die Oberfläche im Standard der Website.

Was passiert bei einem unbekannten Code wie /lang/xx?

Ein nicht unterstützter Code wird stillschweigend ignoriert, und die aktuelle Sprache bleibt bestehen (kein Fehler). Gültig sind allein die aktivierten Codes unter den 8.

Was, wenn ich alle Sprachen deaktiviere?

Das wird verhindert. Beim Speichern gilt ein Minimum von einer Sprache (das Speichern von null Sprachen gibt 422 zurück). Selbst wenn die Einstellung beschädigt würde, fällt das System auf den vollständigen Katalog zurück, sodass der Umschalter nie leer wird.

Verwandte Themen

• Verwaltung ▸ Lokalisierung (aktivierte Sprachen verwalten)
• Mein Profil · Sprache
• Navigation · Menüstruktur
• Design (hell · dunkel)
• Zugriffsstufen · RBAC
• Dieses Handbuch nutzen