WPML과 WPBakery Page Builder의 호환성 유지

WPBakery Page Builder와 WPML의 호환성은 언어 구성 파일을 통해 보장됩니다. 이 파일을 사용하여 호환성을 유지하는 방법을 알아보세요.

이 페이지는 WPBakery 개발 팀, 사용자 정의 버전의 페이지 빌더를 제공하는 개발자, WPBakery 애드온을 개발하는 테마 개발자 및 WPBakery Page Builder를 사용하는 웹 개발자를 대상으로 합니다.

WPBakery로 구축된 사이트를 번역하려는 고객사라면 상세 문서를 참조하여 WPBakery Page Builder 및 WPML로 다국어 사이트 구축하기에 대해 자세히 알아보세요.

WPBakery Page Builder와 WPML의 통합 작동 방식

WPBakery Page Builder가 WPML과 작동하는 방식을 이해하기 위해 WPBakery Page Builder를 사용하여 간단한 페이지를 만드는 것부터 시작하겠습니다. Text Block, Message Box 및 Hover Box와 같은 몇 가지 모듈을 포함할 것입니다.

생성한 페이지를 번역하려면 오른쪽 사이드바의 언어 메타 박스에 있는 플러스 아이콘을 클릭하세요.

그러면 페이지를 번역할 수 있는 고급 번역 에디터 화면으로 이동합니다. 각 문장의 번역을 입력하고 녹색 확인 표시를 클릭하여 확정하세요. 모든 번역이 만족스러우면 완료를 클릭하세요.

언어 구성 파일 업데이트

다음과 같은 여러 가지 이유로 언어 구성 파일에서 페이지 빌더 숏코드를 업데이트해야 할 수 있습니다.

1. 페이지 빌더에 새 숏코드 추가
2. 기존 숏코드에 새 속성 추가
3. 더 이상 사용되지 않는 숏코드 제거

리포지토리에서 언어 구성 파일을 다운로드할 수 있습니다. 언어 구성 파일 내의 기존 숏코드에 숏코드 또는 속성을 추가하세요.

테마에 사용자 정의 버전의 WPBakery Page Builder를 번들로 제공하는 제작자의 경우, 해당 사용자 정의 버전 플러그인의 언어 구성 파일을 업데이트해야 한다는 점을 고려하시기 바랍니다.

언어 구성 파일의 페이지 빌더 숏코드 구조

WPBakery Page Builder를 사용하여 구축된 페이지에서 문자열을 추출하고 번역 에디터 화면에 로드하려면, 번역이 필요한 문자열이 포함된 숏코드 및 속성을 식별하도록 WPML을 구성해야 합니다. 이는 일반적으로 테마의 루트 폴더에 배치되는 wpml-config.xml이라는 파일을 추가하여 수행됩니다. WPBakery Page Builder의 경우 당사 서버에서 언어 구성 파일을 호스팅하고 있습니다. 이 파일은 WPBakery Page Builder 루트 폴더에 있는 로컬 구성 파일을 재정의하도록 설정되어 있어 구성 파일이 항상 최신 상태로 유지되도록 보장합니다.

wpml-config.xml 파일은 다음 요소를 구성하는 데에도 사용됩니다.

1. 사용자 정의 필드
2. 사용자 정의 분류체계
3. 관리자 텍스트 / wp_options
4. 언어 전환기 구성
5. 페이지 빌더 숏코드

언어 구성 파일 구조 및 구문에 대해 자세히 알아보려면 상세 문서를 참조하세요.

예시로 wpml-config.xml 파일에 Tabs 숏코드를 어떻게 추가했는지 살펴보겠습니다.

<shortcode>
         <tag>vc_tta_tabs</tag>
         <attributes>
            <attribute encoding="allow_html_tags">title</attribute>
         </attributes>
</shortcode>

위 예시의 구조는 다음과 같이 분석할 수 있습니다.

• 모든 숏코드는 기본 shortcodes(복수형) 태그로 래핑됩니다.
• shortcode 태그는 단일 숏코드에 속하는 모든 태그를 래핑합니다.
• tag 태그는 숏코드의 이름을 정의하며, 이 경우에는 vc_tta_tabs입니다.
• 숏코드에는 하나 이상의 속성이 있을 수 있으므로 attributes(복수형) 태그로 래핑하고 attribute(단수형) 태그를 사용하여 각 속성의 제목을 정의합니다. 이 경우에는 title 속성이 있습니다.

링크 속성이 포함된 숏코드의 경우 속성에 대한 type 옵션을 사용하여 내부 링크가 해당 글의 번역된 버전을 자동으로 가리키도록 할 수 있습니다. 다음은 그 예시입니다.

<shortcode>
         <tag>vc_button</tag>
         <attributes>
            <attribute encoding="allow_html_tags">title</attribute>
            <attribute encoding="vc_link" type="link">href</attribute>
         </attributes>
</shortcode>

언어 구성 파일 테스트

업데이트된 언어 구성 파일을 테스트하려면 다음 단계를 따르세요.

1. WPBakery Page Builder와 WPML이 모두 활성화된 설치 환경을 설정합니다. 문자열 번역 및 미디어 번역 애드온을 다운로드하고 활성화하세요.
2. 원격 언어 구성 파일을 업데이트된 파일로 재정의해야 합니다. 이렇게 하려면 WPML → 설정 페이지로 이동하여 사용자 정의 XML 구성 탭을 클릭하세요. 업데이트된 언어 구성 파일의 내용을 에디터에 복사한 다음 저장을 클릭하세요.

3. 새 페이지를 만들고 새 모듈을 추가합니다. 기존 모듈의 일부 속성을 업데이트한 경우 해당 속성도 페이지에 추가하세요. 이 예시에서는 Call To Action 모듈이 WPBakery Page Builder에 새로 추가되었다고 가정하겠습니다. 이를 페이지에 추가하고 발행하세요.

4. 플러스 아이콘을 클릭하여 페이지를 번역하세요. 그러면 고급 번역 에디터 화면으로 이동합니다.
5. 모듈의 텍스트 요소가 고급 번역 에디터에 표시되는지 확인하세요.
6. 번역을 입력하고 녹색 확인 표시로 확정하세요. 완료되면 완료 버튼을 클릭하세요.

7. 프런트엔드에서 번역된 페이지를 확인하세요.

번역된 페이지에 모든 번역된 문자열이 표시되면 업데이트된 언어 구성 파일이 제대로 작동하고 있음을 의미합니다.

원본 언어의 페이지 요소에 대한 CSS 스타일이 번역 언어로 복사된다는 점에 유의하세요. 이를 통해 언어 간에 모든 것이 올바르게 보이도록 보장합니다. 이 기능을 비활성화하려면 이 문서에서 지침을 확인하세요.

문제가 발생하는 경우 호환성 개발 팀에 문의하세요. 언어 구성 파일과 관련된 문제를 기꺼이 확인해 드릴 것입니다.

테스트를 완료하면 당사 리포지토리에 병합 요청을 제출해 주세요. 호환성 개발자가 요청을 접수하고 검토할 것입니다.

당사 리포지토리에서 호스팅되는 언어 구성 파일은 WPBakery Page Builder의 기본 버전을 위한 것입니다. 사용자 정의 버전의 WPBakery Page Builder 언어 구성 파일을 업데이트하는 경우 플러그인의 루트 폴더 안에 있는 구성 파일에 변경 사항을 적용하세요.