다국어 도구 플러그인은 번역할 사용자 정의 Elementor 위젯을 등록할 때 사용할 수 있는 테스트 플러그인입니다. 이 플러그인에는 이러한 사용자 정의 위젯의 첫 번째 XML 코드 버전을 자동으로 생성하는 WPML – Config Generator for Elementor가 포함되어 있습니다.
이 도구를 사용하면 위젯을 등록하는 데 필요한 정보를 얻을 수 있습니다.
이 가이드는 Elementor 테마와 플러그인을 제작하고 WPML과 호환되도록 만들려는 개발자를 위한 것입니다. 개발자가 아닌 경우 대신 WPML을 사용하여 Elementor 웹사이트를 번역하는 방법에 대한 가이드를 확인하세요.
시작하기
시작하려면 다음을 수행하세요.
- OnTheGoSystems GitHub 페이지에서 다국어 도구 플러그인을 다운로드하세요.
- 사이트에 WPML Multilingual CMS 코어 플러그인과 WPML 문자열 번역 애드온이 설치 및 활성화되어 있는지 확인하세요.
- 사이트에 Elementor로 생성된 콘텐츠가 이미 있는지 확인하세요.
다국어 도구 플러그인을 사용하는 이유
WPML 4.9 이상 버전에서는 WPML이 사용자 정의 Elementor 위젯을 자동으로 인식하여 번역할 수 있도록 합니다. 하지만 번역을 원하지 않는 문자열이 등록될 수도 있습니다.
그렇기 때문에 다국어 도구를 사용하여 번역할 사용자 정의 Elementor 위젯을 등록하는 것이 좋습니다. 이를 통해 번역할 수 있는 필드를 정밀하게 제어할 수 있습니다.
작동 방식
Elementor 페이지 빌더를 사용하여 페이지를 생성하면 모든 콘텐츠가 _elementor_data 사용자 정의 필드에 저장됩니다.
번역을 위해 등록하려는 사용자 정의 위젯을 페이지에 추가하면 WPML – Config Generator for Elementor가 이 _elementor_data 필드에 액세스하여 콘텐츠를 읽습니다. 읽은 후에는 데이터를 페이지에 사용한 사용자 정의 위젯에 해당하는 XML 코드로 변환합니다.
WPML — Config Generator로 XML 코드 생성
사용자 정의 위젯에 대한 XML 코드를 자동으로 생성하려면 다음을 수행하세요.
- 새 페이지를 생성하고 Elementor로 편집을 클릭하세요.
- 번역을 위해 등록하려는 사용자 정의 위젯을 페이지에 추가하세요.
중요: 위젯을 번역할 수 있도록 추가할 때는 모든 필드를 채우고 사용 가능한 모든 옵션을 활성화해야 합니다.
이는 WPML – Config Generator for Elementor가 구성되지 않은 필드나 옵션에 대해서는 XML 코드를 생성하지 않기 때문입니다.
- 페이지를 발행하고 해당 페이지의 WordPress 편집 화면으로 돌아가세요. WPML: Elementor Widgets 섹션으로 아래로 스크롤하세요. 아직 번역을 위해 등록되지 않은 위젯 필드 및 설정에 대해 생성된 XML 코드가 표시됩니다.
자동으로 생성된 XML 코드 테스트
코드를 최종 사용자에게 제공하기 전에 철저하게 검토하고 테스트하세요. WPML – Config Generator for Elementor는 시작점일 뿐입니다.
자동으로 생성된 XML 코드를 테스트하려면 다음을 수행하세요.
- 사용자 정의 위젯이 있는 페이지의 WordPress 편집 화면에서 WPML: Elementor Widgets 섹션의 XML 코드를 복사하세요.
- WPML → 설정으로 이동하여 사용자 정의 XML 구성 탭을 클릭하세요.
- 에디터에 코드를 붙여넣고 저장 버튼을 누르세요. 경고나 유효성 검사 오류가 표시되지 않는지 확인하세요. 구성 필드나 부울 값이 있는 필드 등 사용자가 번역하거나 수정해서는 안 되는 필드를 모두 제거해야 합니다. 이러한 필드를 번역할 수 있도록 남겨두면 최종 사용자에게 문제와 오류가 발생할 수 있습니다.
- 사용자 정의 위젯이 있는 페이지의 편집 화면으로 돌아가세요. 페이지 제목 편집 등 페이지를 약간 변경한 다음 업데이트를 클릭하세요.
- 언어 상자에서 더하기 아이콘을 클릭하여 페이지를 번역하세요. 고급 번역 에디터가 열리고 번역할 수 있는 사용자 정의 위젯의 등록된 필드가 표시됩니다. 자동 번역을 검토하거나 직접 입력하고 완료되면 완료를 클릭하세요.
- 프런트엔드에서 번역된 페이지를 살펴보고 사용자 정의 위젯 필드가 올바르게 나타나는지 확인하세요.
추가 검사 기능 사용
WPML – Config Generator for Elementor는 사용자 정의 Elementor 위젯의 XML 코드를 자동으로 생성하는 것 외에도 추가 디버그 정보를 제공합니다.
이 정보를 통해 기본 데이터와 데이터가 사용되는 방식을 검사하고 이해할 수 있습니다. 이는 XML 코드가 예상대로 작동하지 않는 등 특정 경우에 유용할 수 있습니다.
WPML Config XML(페이지의 모든 위젯에 대해 생성됨)
기능: 이미 번역을 위해 등록된 위젯을 포함하여 페이지에 있는 모든 위젯의 XML 코드를 제공합니다.
유용한 이유: 기존 위젯 설정의 XML 코드를 검토하거나 편집할 수 있습니다.
_elementor_data의 RAW 값(JSON)
기능: 글의 _elementor_data 필드의 원래 값을 표시합니다.
유용한 이유: WPML – Config Generator for Elementor Widgets가 XML 코드를 생성하는 데 사용하는 데이터를 볼 수 있습니다.
_elementor_data에서 생성된 배열
기능: 글의 _elementor_data 필드 값을 배열로 변환하여 제공합니다.
유용한 이유: 디버깅 목적으로 배열을 사용할 수 있습니다.
_elementor_data에서 추출된 위젯
기능: 플러그인이 _elementor_data 필드에서 추출하여 사용할 수 있는 사용자 정의 위젯을 표시합니다.
유용한 이유: 여기에 사용자 정의 위젯, 사용자 정의 위젯 필드 또는 사용자 정의 위젯 옵션이 표시되지 않으면 XML에 추가되지 않습니다. 이는 디버깅에 유용합니다.