Avada Builder와 WPML의 호환성은 언어 구성 파일을 통해 보장됩니다. 이 파일을 사용하고 업데이트하여 호환성을 유지하는 방법을 안내합니다.
이 문서는 Avada 개발 팀과 Avada를 사용하는 웹 개발자를 위한 것입니다. Avada로 구축한 사이트를 번역하려는 고객사라면 Avada 및 WPML로 다국어 사이트 구축에 관한 문서 페이지를 참조하세요.
시작하기
시작하기 전에 사이트에 다음 항목이 설치되고 활성화되어 있는지 확인하세요.
Avada Builder와 WPML의 통합 작동 방식
Avada Builder가 WPML과 어떻게 작동하는지 이해하기 위해 Avada Builder를 사용하여 간단한 글을 작성해 보겠습니다. Text Block, Alert, Flip Box와 같은 몇 가지 모듈을 포함합니다.
글을 번역하려면 오른쪽 사이드바에서 언어 상자를 찾은 다음, 글을 번역할 언어 옆의 더하기 아이콘을 클릭하세요.
그러면 페이지를 번역할 수 있는 고급 번역 에디터로 이동합니다. 각 줄 옆의 더하기 아이콘을 클릭하여 번역을 추가하세요. 모두 완료되면 완료 버튼을 클릭하세요.
언어 구성 파일 업데이트
다음과 같은 다양한 이유로 언어 구성 파일에서 페이지 빌더 숏코드를 업데이트해야 할 수 있습니다.
- 페이지 빌더에 새 숏코드 추가
- 기존 숏코드에 새 속성 추가
- 더 이상 사용하지 않는 숏코드 제거
리포지토리에서 언어 구성 파일을 다운로드할 수 있습니다. 그런 다음 언어 구성 파일의 기존 숏코드에 새 숏코드나 속성을 추가할 수 있습니다.
언어 구성 파일의 페이지 빌더 숏코드 구조
Avada Builder를 사용하여 구축한 페이지에서 문자열을 추출하고 고급 번역 에디터에 로드하려면 번역이 필요한 문자열이 포함된 숏코드와 속성을 식별하도록 WPML을 구성해야 합니다.
이 작업은 일반적으로 테마의 루트 폴더에 배치되는 wpml-config.xml이라는 파일을 추가하여 수행합니다. Avada의 경우 서버에서 언어 구성 파일을 호스팅합니다. 이는 Avada의 루트 폴더에 있는 로컬 구성 파일을 재정의하도록 설정되어 구성 파일이 항상 최신 상태로 유지되도록 합니다.
wpml-config.xml 파일은 다음 요소를 구성하는 데에도 사용됩니다.
- 사용자 정의 필드
- 사용자 정의 분류체계
- 관리자 텍스트 / wp_options
- 언어 전환기 구성
- 페이지 빌더 숏코드
언어 구성 파일에 관한 페이지를 방문하여 언어 구성 파일 구조와 구문에 대해 자세히 알아볼 수 있습니다.
예를 들어 wpml-config.xml 파일에 Flip Box 숏코드를 추가한 방법을 살펴보겠습니다.
언어 구성 파일의 Avada Builder 숏코드 예시
<shortcodes>
<shortcode>
<tag>fusion_flip_box</tag>
<attributes>
<attribute>title_front</attribute>
<attribute>title_back</attribute>
<attribute>text_front</attribute>
<attribute>image</attribute>
</attributes>
</shortcode>
</shortcodes>위 예시의 구조는 다음과 같이 나눌 수 있습니다.
- 모든 숏코드는 shortcodes 태그로 래핑됩니다.
- shortcode 태그는 하나의 단일 숏코드에 속하는 모든 태그를 래핑합니다.
- tag 태그는 숏코드의 이름을 정의하며, 이 경우 fusion_flip_box입니다.
- 숏코드에는 하나 이상의 속성이 있을 수 있으므로 attributes(복수형) 태그로 래핑하고 attribute(단수형) 태그를 사용하여 각 속성의 제목을 정의합니다. 이 경우 title_front, title_back, text_front, image가 있습니다.
링크 속성이 포함된 숏코드의 경우 속성에 대한 유형 옵션을 사용하여 내부 링크가 해당 글의 번역된 버전을 자동으로 가리키도록 할 수 있습니다. 다음은 그 예시입니다.
링크 속성이 포함된 Avada Builder 숏코드 예시
<shortcode>
<tag>fusion_soundcloud</tag>
<attributes>
<attribute type="link">url</attribute>
</attributes>
</shortcode>업데이트된 언어 구성 파일 테스트
업데이트된 언어 구성 파일을 테스트하려면 사이트에 Avada, WPML 코어 플러그인, WPML 문자열 번역이 설치되고 활성화되어 있는지 확인하세요.
원격 언어 구성 파일을 업데이트된 파일로 재정의하는 것부터 시작해야 합니다. 이렇게 하려면 다음을 따르세요.
- WPML → 설정으로 이동하여 사용자 정의 XML 구성 탭을 클릭하세요. 업데이트된 언어 구성 파일의 내용을 에디터에 붙여넣고 저장을 클릭하세요.
- 새 페이지를 만들고 새 모듈을 추가하세요. 기존 모듈의 일부 속성을 업데이트한 경우 해당 속성도 페이지에 추가하세요. 데모를 위해 Button 모듈이 Avada Builder에 새로 추가되었다고 가정하고 이 모듈이 있는 페이지를 생성해 보겠습니다.
- 언어 상자에서 더하기 아이콘을 클릭하여 페이지를 번역하세요.
- 고급 번역 에디터로 이동하며, 여기서 각 줄 옆의 더하기 아이콘을 클릭하여 모듈의 텍스트 요소를 번역할 수 있습니다.
- 버튼 링크를 번역하려면 페이지 상단의 Search Source 검색창에 URL 이름을 입력하기 시작하세요. 번역 추가가 완료되면 완료 버튼을 클릭하는 것을 잊지 마세요.
번역된 페이지에 모든 번역된 문자열이 표시되는지, 업데이트된 언어 구성 파일이 제대로 작동하는지 확인하려면 프런트엔드에서 새로 번역된 페이지를 살펴보면 됩니다.
도움말 얻기
문제가 발생하는 경우 호환성 개발 팀에 문의하세요. 언어 구성 파일과 관련된 문제를 기꺼이 확인해 드릴 것입니다.
테스트를 완료하면 리포지토리로 병합 요청을 제출해 주세요. 호환성 개발자가 요청을 접수하고 검토할 것입니다.