현지화 언어
Logto는 다양한 사전 정의된 언어를 지원하며, 113개의 추가 언어 태그를 제공합니다. 이 강력한 도구를 통해 로그인 경험을 맞춤화하고, 직접 언어 옵션과 번역을 생성 및 관리할 수 있습니다.
Logto 콘솔에서의 맞춤화 단계
코딩 없이 Logto 콘솔에서 언어 설정을 쉽게 맞춤화할 수 있습니다.
- 이동 경로: 콘솔 > 로그인 경험 > 콘텐츠 > 언어.
- 언어 관리: “언어 관리” 버튼을 클릭하여 언어 라이브러리에 접근하세요.
- 기존 언어 편집: 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": "이미 계정이 있으신가요? 소셜 아이덴티티와 {{methods, list(type: disjunction;)}}를 연결하려면 로그인하세요."
},
"action": { "sign_in": "로그인" },
"error": {
"general_required": "{{types, list(type: disjunction;)}}는 필수 항목입니다"
},
"list": { "or": "또는" },
"user_scopes": {
"descriptions": { "custom_data": "사용자 맞춤 데이터" }
}
}
모든 맞춤화 가능한 내용을 확인하려면 소스 코드를 참고하세요.
또한 PATCH /api/sign-in-exp API를 사용하여 언어 감지 정책을 제어할 수 있습니다.
런타임 언어 결정 방식
런타임 시, 로그인 경험의 언어는 다음 우선순위로 결정됩니다:
- 현재 인증 요청의
ui_localesOIDC 파라미터 (지원되는 첫 번째 태그가 사용됨). 자세한 내용은 ui_locales 참고. - 그렇지 않으면, "자동 감지"가 활성화된 경우, 감지된 사용자 클라이언트 언어(예: HTTP
Accept-Language헤더에서). - 그렇지 않으면, 로그인 경험의 테넌트 기본 언어.
이 결정 방식은 상호작용으로 트리거된 메시지의 이메일 현지화에도 영향을 미칩니다. 자세히 알아보기: 이메일 템플릿 현지화.
사용 사례
추가된 언어가 최종 고객에게 어떻게 보일까요?
예를 들어, 영어가 기본 언어이고 자동 감지가 켜진 웹사이트가 있다고 가정해봅시다. 일본에서 온 사용자가 사이트에 접속해 계정을 만들려고 합니다. 만약 그가 앱 언어로 일본어를 사용하지만 Logto에서 아직 해당 언어를 지원하지 않는다면, 로그인 화면은 영어로 표시됩니다.
Logto 로그인 경험 i18n을 통해 맞춤 언어가 가능합니다.
ja 언어 태그를 클릭해 직접 일본어 번역을 추가하세요.
이렇게 하면, 일본에서 접속한 사용자는 영어에서 번역한 일본어로 콘텐츠를 볼 수 있습니다.
자주 묻는 질문
내가 추가한 언어가 Logto 제공 언어가 되면 어떻게 되나요?
왼쪽 언어 태그 옆에 Logto 제공 태그가 표시되며, 추가한 언어는 더 이상 삭제할 수 없습니다. 수정한 값은 계속 동작하며 원래 Logto 값을 대체합니다. Logto의 기본 설정에서 제공하는 값을 사용하려면 사용자가 입력한 값을 지우면 됩니다.
일부 값만 맞춤화했다면 어떻게 되나요?
최종 사용자가 보는 것은 두 컬럼이 병합된 결과입니다. Logto에서 제공한 원본 콘텐츠 중 일부만 조정하고 싶을 때, 회원가입 화면에서 Logto가 제공한 것과의 차이는 편집한 키만 다릅니다. 나머지 콘텐츠는 변경되지 않습니다.
관련 리소스
애플리케이션에서 아랍어 및 RTL(오른쪽-왼쪽) 언어 레이아웃 지원하기