Zum Hauptinhalt springen

Lokalisierte Sprachen

Logto unterstützt eine breite Palette vordefinierter Sprachen und bietet 113 zusätzliche Sprach-Tags. Dieses leistungsstarke Tool ermöglicht es dir, die Anmeldeerfahrung zu individualisieren, indem du eigene Sprachoptionen und Übersetzungen erstellst und verwaltest.

Anpassungsschritte in der Logto-Konsole

Passe die Spracheinstellungen ganz einfach in der Logto-Konsole an – ganz ohne Programmierung.

  1. Navigiere zu: Konsole > Anmeldeerfahrung > Inhalt > Sprachen.
  2. Sprache verwalten: Klicke auf die Schaltfläche „Sprache verwalten“, um auf deine Sprachbibliothek zuzugreifen.
    • Vorhandene Sprachen bearbeiten: Passe Übersetzungen der von Logto bereitgestellten Sprachen an. Diese Sprachen können nicht gelöscht werden, aber deine Änderungen überschreiben die Standardwerte.
    • Neue Sprache hinzufügen: Klicke auf die Schaltfläche „Sprache hinzufügen“, wähle ein Sprach-Tag aus, gib deine Übersetzungen ein und speichere die Änderungen, um eine neue Sprache hinzuzufügen.
  3. Auto-Erkennung aktivieren: Wenn aktiviert, wird die Anmeldeseite automatisch in der bevorzugten Sprache des Benutzers angezeigt, basierend auf den Geräteeinstellungen.
  4. Standardsprache festlegen: Du kannst eine Standardsprache aus deiner Sprachbibliothek auswählen. Sie wird verwendet, wenn die erkannte Benutzersprache in der aktuellen Sprachbibliothek nicht abgedeckt ist.

Hier sind einige wichtige Begriffe, die du beim Verwalten von Sprachen kennen solltest:

DefinitionBeschreibung
Sprach-TagDas Sprach-Tag identifiziert die Sprache des Inhalts. Ein Sprach-Tag besteht aus einem Sprachcode (z. B. en, fr, zh) und einem Länder- / Regionscode (z. B. US, UK, KR), getrennt durch Bindestriche. Ein Sprach-Tag sieht so aus: en-US.
Von Logto bereitgestellte SpracheVon Logto bereitgestellte Sprache ist die offizielle Logto-Sprache und wird im ursprünglichen Logto-Code gespeichert.
Hinzugefügte SpracheHinzugefügte Sprache ist die von Benutzern hinzugefügte Sprache.
Logto-QuellwerteLogto-Quellwerte sind von Logto bereitgestellte Werte, die nicht von Benutzern angepasst wurden.
Benutzerdefinierte WerteBenutzerdefinierte Werte sind Werte, die bereits von Benutzern angepasst wurden. Logto-Quellwerte werden überschrieben.

Anpassung über die Management API

Du kannst die Management API PUT /api/custom-phrases/{languageTag} verwenden, um Sprachübersetzungen anzupassen. Der API-Request-Body ist ein partielles Locale-Objekt wie:

{
"input": { "username": "Username", "password": "Password" },
"secondary": {
"social_bind_with": "Bereits ein Konto? Melde dich an, um {{methods, list(type: disjunction;)}} mit deiner sozialen Identität zu verknüpfen."
},
"action": { "sign_in": "Anmelden" },
"error": {
"general_required": "{{types, list(type: disjunction;)}} ist erforderlich"
},
"list": { "or": "oder" },
"user_scopes": {
"descriptions": { "custom_data": "Deine benutzerdefinierten Daten" }
}
}

Siehe den Quellcode, um alle anpassbaren Inhalte zu sehen.

Du kannst auch die PATCH /api/sign-in-exp API verwenden, um die Spracherkennungspolicies zu steuern.

Sprachauflösung zur Laufzeit

Zur Laufzeit wird die Sprache der Anmeldeerfahrung mit folgender Priorität bestimmt:

  1. ui_locales OIDC-Parameter aus der aktuellen Authentifizierungsanfrage (das erste unterstützte Tag wird verwendet). Siehe ui_locales.
  2. Andernfalls, wenn „Auto-Erkennung“ aktiviert ist, die erkannte Sprache des Benutzerclients (z. B. aus dem HTTP-Header Accept-Language).
  3. Andernfalls die Standardsprache des Mandanten in der Anmeldeerfahrung.

Diese Auflösung beeinflusst auch die E-Mail-Lokalisierung für durch die Interaktion ausgelöste Nachrichten. Mehr erfahren: E-Mail-Vorlagen-Lokalisierung.

Anwendungsfälle

Wie erscheinen hinzugefügte Sprachen für Endkunden?

Angenommen, du hast eine Website, auf der Englisch die Standardsprache ist und die Auto-Erkennung aktiviert ist. Ein Benutzer aus Japan besucht deine Seite und möchte ein Konto erstellen. Wenn er/sie Japanisch als App-Sprache verwendet, Logto diese Sprache aber noch nicht unterstützt, erscheint der Anmeldebildschirm auf Englisch.

Die Logto-Anmeldeerfahrung i18n macht individuelle Sprachen möglich.

Klicke auf das Sprach-Tag ja, um deine eigene japanische Übersetzung hinzuzufügen.

So kann der Benutzer, der deine Seite aus Japan besucht, die Inhalte auf Japanisch lesen, die du gerade aus dem Englischen übersetzt hast.

FAQs

Was passiert, wenn die von mir hinzugefügte Sprache zur von Logto bereitgestellten Sprache wird?

Neben dem Sprach-Tag auf der linken Seite erscheint ein von Logto bereitgestelltes Tag, und die von dir hinzugefügte Sprache kann nicht mehr entfernt werden. Die geänderten Werte funktionieren weiterhin und ersetzen die ursprünglichen Logto-Werte. Lösche die vom Benutzer bereitgestellten Werte, um die von Logto bereitgestellten Standardwerte zu verwenden.

Was ist, wenn ich nur einige wenige benutzerdefinierte Werte hinzugefügt habe?

Was die Endbenutzer sehen, ist das Ergebnis der Zusammenführung beider Spalten. Angenommen, du möchtest nur einen Teil der ursprünglichen von Logto bereitgestellten Inhalte anpassen. Der einzige Unterschied zwischen deinem Anmeldebildschirm und dem von Logto bereitgestellten besteht in den von dir bearbeiteten Schlüsseln. Der Rest des Inhalts bleibt unverändert.

Unterstützung für Arabisch und RTL (Rechts-nach-links) Sprachlayout in deiner Anwendung