ローカライズされた言語
Logto は、幅広い事前定義された言語をサポートし、さらに 113 の言語タグを提供しています。この強力なツールを使用すると、独自の言語オプションと翻訳を作成および管理することで、サインイン体験をカスタマイズできます。
Logto コンソールでのカスタマイズ手順
Logto コンソールで簡単に言語設定をカスタマイズできます。コーディングは不要です。
- 移動先: Console > Sign-in experience > Content > Languages。
- 言語を管理: 「言語を管理」ボタンをクリックして、言語ライブラリにアクセスします。
- 既存の言語を編集: Logto が提供する言語の翻訳をカスタマイズします。これらの言語は削除できませんが、変更はデフォルト値を上書きします。
- 新しい言語を追加: 「言語を追加」ボタンをクリックし、言語タグを選択して翻訳を提供し、変更を保存して新しい言語を追加します。
- 自動検出を有効にする: 有効にすると、ユーザーのデバイス設定に基づいて、ユーザーの優先言語でサインインページが自動的に表示されます。
- デフォルト言語を設定: 言語ライブラリからデフォルト言語を選択できます。検出されたユーザー言語が現在の言語ライブラリに含まれていない場合に使用されます。
言語を管理する際に理解しておくべき重要な用語は次のとおりです：
| 定義 | 説明 |
|---|---|
| 言語タグ | 言語タグはコンテンツの言語を識別します。言語タグは、言語コード（例：en, fr, zh）と国/地域コード（例：US, UK, KR）で構成され、ハイフンで区切られています。言語タグは次のようになります：en-US。 |
| Logto 提供言語 | Logto 提供言語は、Logto の公式言語であり、Logto のオリジナルコードベースに保存されています。 |
| 追加された言語 | 追加された言語は、ユーザーによって追加された言語です。 |
| Logto ソース値 | Logto ソース値は、ユーザーによってカスタマイズされていない Logto 提供の値です。 |
| カスタム値 | カスタム値は、すでにユーザーによってカスタマイズされた値です。Logto ソース値は上書きされます。 |
Management API を使用したカスタマイズ
Management API PUT /api/custom-phrases/{languageTag} を使用して、言語翻訳をカスタマイズできます。API リクエストボディは、部分的なロケールオブジェクトのようになります：
{
"input": { "username": "Username", "password": "Password" },
"secondary": {
"social_bind_with": "Already had an account? Sign in to link {{methods, list(type: disjunction;)}} with your social identity."
},
"action": { "sign_in": "Sign in" },
"error": {
"general_required": "{{types, list(type: disjunction;)}} is required"
},
"list": { "or": "or" },
"user_scopes": {
"descriptions": { "custom_data": "Your custom data" }
}
}
カスタマイズ可能なコンテンツのすべてを確認するには、ソースコード を参照してください。
また、PATCH /api/sign-in-exp API を使用して、言語検出ポリシー を制御することもできます。
ユースケース
追加された言語はエンドカスタマーにどのように表示されますか？
たとえば、英語がデフォルト言語であり、自動検出がオンになっているウェブサイトがあるとします。日本からのユーザーがあなたのサイトを訪れ、アカウントを作成しようとします。彼/彼女がアプリ言語として日本語を使用しているが、Logto がまだその言語をサポートしていない場合、サインイン画面は英語で表示されます。
Logto のサインイン体験 i18n により、カスタマイズされた言語が可能になります。
ja 言語タグをクリックして、独自の日本語翻訳を追加してください。
このようにして、日本からあなたのサイトにアクセスするユーザーは、英語から翻訳した日本語のコンテンツを読むことができます。
よくある質問
追加した言語が Logto 提供言語になった場合はどうなりますか？
左側の言語タグの横に Logto 提供タグが表示され、追加した言語は削除できなくなります。変更された値は引き続き機能し、元の Logto 値を置き換えます。ユーザーが提供した値を消去して、Logto のデフォルト設定で提供される値を使用します。
カスタム値をいくつかだけ追加した場合はどうなりますか？
最終ユーザーが見るのは、2 つの列がマージされた結果です。 Logto が提供したオリジナルコンテンツのコピーのサブセットにのみ調整を加えたいとします。あなたのサインアップ画面と Logto が提供するものとの唯一の違いは、編集したキーです。残りのコンテンツは変更されません。
関連リソース
アプリケーションでのアラビア語および RTL (右から左) 言語レイアウトのサポート