wp_options 테이블에 저장된 텍스트를 번역 가능하게 만들고 객체 ID를 자동으로 변환하는 방법을 알아보세요.
테마와 플러그인은 때때로 wp_options 테이블에 저장하는 옵션의 일부로 텍스트를 포함합니다. WPML을 사용하면 get_option 호출을 wpml-config.xml 파일에 지정한 번역으로 대체하여 이러한 텍스트를 번역할 수 있습니다.
wpml-config.xml 파일은 저장된 옵션의 어떤 문자열을 번역해야 하는지 WPML에 지시하는 구성 문서입니다.
이 가이드는 자체 테마와 플러그인을 제작하는 개발자를 위한 것입니다. 타사 테마 및 플러그인에서 제공하는 문자열을 번역하려는 경우 문자열 번역 페이지에 표시되지 않는 문자열 찾기에 대한 페이지를 읽어보세요.
wpml-config.xml 파일을 생성해야 하나요? 다국어 도구 플러그인을 사용하여 구성 파일을 자동으로 생성하는 방법에 대한 단계별 가이드를 확인하세요.
wp_options 테이블의 문자열 번역
테마와 플러그인이 get_option을 사용할 때 wp_options 테이블에서 값을 읽습니다. WPML은 이러한 호출을 필터링하고 해당 옵션 값에 대한 번역을 제공할 수 있습니다.
이는 wp_option 레코드가 단순한 문자열일 때뿐만 아니라 직렬화된 배열일 때도 작동합니다.
단일 옵션을 번역하려면 admin-texts 아래에 key 항목을 추가하세요. 직렬화된 배열을 번역하려면 아래 예제의 my_plugin_options에서 볼 수 있듯이 key 아래에 여러 키를 추가하세요.
언어 구성 파일의 관리자 텍스트
<wpml-config>
<admin-texts>
<key name="my_plugins_options">
<key name="option_name_1" />
<key name="option_name_2" />
<key name="options_group_1">
<key name="sub_option_name_11" />
<key name="sub_option_name_12" />
</key>
<key name="options_group_2">
<key name="sub_option_name_21" />
<key name="sub_option_name_22" />
</key>
</key>
<key name="simple_string_option"/>
</admin-texts>
</wpml-config>다음 경우와 같이 하위 키에 와일드카드 *를 사용할 수 있습니다.
와일드카드 사용 예
<wpml-config>
<admin-texts>
<key name="testing_option">
<key name="*"/>
</key>
</admin-texts>
</wpml-config>이는 다음 코드와 같습니다.
동일한 코드
<wpml-config>
<admin-texts>
<key name="testing_option">
<key name="sub_key_1"/>
<key name="sub_key_2">
<key name="sub_sub_21">
<key name="sub_sub_211"/>
</key>
<key name="sub_sub_21"/>
</key>
<key name="more_sub_keys"/>
</key>
</admin-texts>
</wpml-config>와일드카드 *는 상위 키에서 작동하지 않습니다.
상위 키에서는 와일드카드가 작동하지 않음
<wpml-config>
<admin-texts>
<key name="some_option_*" />
<key name="*"/>
</admin-texts>
</wpml-config>관리자 텍스트에서 객체 ID 자동 변환
WPML 4.8부터 특정 관리자 텍스트에 글, 상품 또는 택소노미 ID와 같은 객체 ID가 포함되어 있다고 선언할 수 있습니다. WPML은 사이트의 프런트엔드에서 해당 ID를 자동으로 변환합니다.
이는 숏코드 ID 자동 변환에 대한 기존 기능의 확장이며 동일한 구문을 사용합니다.
admin-texts 아래의 key 항목에서 다음을 사용하세요.
- 참조되는 객체(예: post-ids 또는 taxonomy-ids)를 명시하는 type
- 특정 엔티티(예: 상품)를 선언하려는 경우 sub-type(선택 사항)
Type 및 sub-type 속성은 모든 중첩 수준에 추가할 수 있습니다.
WPML은 다음 형식의 ID를 감지하고 변환할 수 있습니다.
- 단일 ID(예: 123)
- ID 배열(및 인코딩된 배열)(예: [123,456,789])
- 쉼표로 구분된 ID 목록(예: “123,456,789”)
관리자 텍스트에서 객체 ID를 선언하는 예
<wpml-config>
<admin-texts>
<key name="admin_text_option_key" type="post-ids" sub-type="product" />
<key name="admin_text_with_nested_ids">
<key name="admin_text_nested_key_with_ids" type="post-ids" sub-type="product" />
<key name="admin_text_nested_key_with_ids_with_wildcard_*" type="post-ids" sub-type="product" />
<key name="admin_text_nested_key_with_subkey">
<key name="admin_text_nested_key_with_subkey_with_ids" type="post-ids" sub-type="product" />
</key>
</key>
</admin-texts>
</wpml-config>추가 리소스
wpml-config.xml 파일에 대해 자세히 알아보려면 언어 구성 파일 가이드를 확인하세요.
wpml-config.xml 파일을 사용하여 다른 요소를 사용자 정의하려면 다음 추가 가이드를 확인하세요.