구성 설정을 테스트하고 플러그인 및 테마가 WPML과 호환되는지 확인하세요.
플러그인 다운로드
다국어 도구는 플러그인 및 테마가 WPML과 호환되는지 테스트하기 위한 무료 애드온입니다.
이 애드온을 사용하면 어떤 텍스트와 요소가 번역을 위해 올바르게 구성되었는지(그리고 어떤 것이 그렇지 않은지) 식별할 수 있을 뿐만 아니라 언어 구성 파일을 생성할 수 있습니다.
시작하기
시작하려면 다음을 설치하고 활성화하세요.
- WPML
- 다국어 도구
- 테스트할 플러그인/테마
다국어 도구는 테스트용 플러그인이므로 운영 사이트나 고객사 사이트에서는 절대 사용하지 마세요.
다국어 도구 사용 방법
먼저 다국어 도구 → Overview로 이동하여 현재 언어 구성 파일의 요약을 확인하세요.
구성 설정에 만족한다면 아래 단계에 따라 테스트하세요. 그렇지 않은 경우 새 언어 구성 파일을 생성하여 설정을 업데이트하세요.
1. 하드코딩된 텍스트가 gettext 호출로 래핑되어 있는지 확인
플러그인이나 테마를 번역하려면 모든 하드코딩된 텍스트를 gettext 호출로 래핑해야 합니다. 아직 이 작업을 수행하지 않았거나 설정을 다시 확인하려면 이 WordPress i18n 가이드라인의 지침을 따르세요.
2. 플러그인 또는 테마에서 하드코딩된 텍스트 스캔
다음으로 WPML을 사용하여 플러그인이나 테마에서 하드코딩된 텍스트를 스캔하세요.
- WPML → 테마 및 플러그인 현지화로 이동하세요.
- 테마 또는 플러그인을 선택하고 텍스트를 스캔하세요.
3. 테스트할 요소 선택
다음으로 구성 설정을 테스트할 요소를 선택하세요.
- 다국어 도구 → 설정으로 이동하세요.
- Add language information to post duplicate로 아래로 스크롤하세요.
- 테스트할 요소를 선택하고 저장하세요.
문자열을 테스트하려면 Auto generate strings translations 섹션에서 문자열 드롭다운을 열고 문자열 소스를 선택한 다음 Generate strings translations를 클릭하세요.
4. 번역할 콘텐츠 전송
더미 콘텐츠를 번역하는 데 시간(또는 비용)을 낭비하지 않도록 다국어 도구는 텍스트에 언어 접두사를 추가합니다. 이 작업을 실행하려면 WPML을 사용하여 콘텐츠를 복제하고 나머지는 다국어 도구에서 처리하도록 하세요.
- WPML → 번역 대시보드로 이동하세요.
- 테스트할 콘텐츠를 선택하세요.
- 번역 방법으로 복제를 선택하고 번역하세요.
5. 호환성 확인
마지막으로 프런트엔드에서 방금 번역한 콘텐츠를 방문하여 언어를 전환하세요. 텍스트에 언어 접두사가 포함되어 있으면 요소가 호환되는 것입니다. 일부 텍스트에 접두사가 포함되어 있지 않으면 호환되지 않는 것이며 추가 구성이 필요합니다.
사용자 정의 Elementor 및 Gutenberg 블록을 번역 가능하게 만들기
플러그인에서 Elementor 위젯이나 Gutenberg 블록을 사용하는 경우 다국어 도구 플러그인을 사용하면 이를 더 쉽게 번역할 수 있습니다. 이 플러그인은 위젯과 블록을 등록하는 데 필요한 XML 코드의 초기 버전을 생성하므로 처음부터 새로 만들 필요가 없습니다.
사용자 정의 Gutenberg 블록을 번역 가능하게 만드는 방법 및 사용자 정의 Elementor 위젯을 등록하는 방법을 확인하세요.
언어 구성 파일 생성
언어 구성 파일을 생성하려면 다국어 도구 → Configuration File로 이동하여 기본 설정을 지정하세요.
설정 개요
사용자 정의 글 유형 / 사용자 정의 분류체계
- 아무것도 하지 않음 – 무시하고 번역하지 않음
- 번역 가능 – 번역된 항목만 표시
- 번역 가능 – 번역이 있으면 사용하고 없으면 기본 언어로 대체
사용자 정의 필드
- 번역하지 않음 – 무시하고 번역하지 않음
- 복사 – 기본 언어에서 값을 복사하고 동기화 유지(숫자에 적합)
- 한 번 복사 – 기본 언어에서 값을 한 번만 복사(언어별로 다른 필드 값을 생성할 때 적합)
- 번역 – 다른 언어로 번역
관리자 텍스트
번역을 위해 wp_options 테이블에 문자열을 등록하세요. 예를 들어 사이트 제목이나 위젯 설정은 이 테이블에 저장되는 경우가 많습니다. 구성 파일에 이를 등록하면 사용자가 번역할 수 있습니다.
숏코드
번역을 위해 숏코드 내의 텍스트나 속성을 등록하세요.