콘텐츠로 건너뛰기 사이드바로 건너뛰기
업데이트됨
2026년 03월 03일

PHP에 등록된 ACF 필드의 번역 기본 설정을 지정하고, ACF가 생성하는 JSON 파일에 이를 자동으로 포함하는 방법을 알아보십시오.

PHP로 등록된 ACF 필드의 번역 기본 설정 지정

PHP로 등록된 ACF 필드의 번역 기본 설정을 지정하려면 acf_add_local_field_group 함수를 사용하고, 각 필드 정의에 wpml_cf_preferences를 추가해야 합니다.

wpml_cf_preferences에 사용할 수 있는 네 가지 숫자 값은 다음과 같습니다.

  • 0번역 안 함. WPML은 해당 필드를 완전히 무시합니다.
  • 1복사. 필드 값은 모든 언어로 복사되며 동기화 상태를 유지합니다.
  • 2번역. 필드 값은 번역에 사용할 수 있도록 설정됩니다.
  • 3한 번 복사. 필드 값은 모든 언어로 한 번 복사된 후 각 언어에서 독립적으로 편집할 수 있습니다.

어떤 번역 옵션을 사용해야 할지 확실하지 않으신가요? 각 ACF 필드에 권장되는 옵션을 참조하십시오.

아래에서 프로그래밍 방식으로 등록된 필드 그룹에 wpml_cf_preferences 키를 추가하는 예시를 볼 수 있습니다.

acf_add_local_field_group( [
  'key' => 'group_1',
  'title' => 'My Group',
  'fields' => [
  [
  'key' => 'field_1',
  'label' => 'Sub Title',
  'name' => 'sub_title',
  'type' => 'text',
  'prefix' => '',
  'instructions' => '',
  'required' => 0,
  'conditional_logic' => 0,
  'wrapper' => [
  'width' => '',
  'class' => '',
  'id' => '',
  ],
  'default_value' => '',
  'placeholder' => '',
  'prepend' => '',
  'append' => '',
  'maxlength' => '',
  'readonly' => 0,
  'disabled' => 0,
  'wpml_cf_preferences' => 2, // 이 필드("Sub Title")는 번역됩니다.
  ],
  ],
  'location' => [
  [
  [
  'param' => 'post_type',
  'operator' => '==',
  'value' => 'post',
  ],
  ],
  ],
  'menu_order' => 0,
  'position' => 'normal',
  'style' => 'default',
  'label_placement' => 'top',
  'instruction_placement' => 'label',
  'hide_on_screen' => '',
] );

WPML로 필드 동기화

PHP를 사용하여 필드를 정의한 후 WPML에 해당 필드에 대해 알려야 합니다.

  1. ACF도구 페이지로 이동하십시오.
  2. ACF Local JSON 및 PHP 등록 필드 번역까지 아래로 스크롤하십시오.
WPML과 로컬 ACF 필드 동기화
  1. 로컬 필드에 대한 번역 기본 설정 동기화 섹션에서 동기화가 언제 발생해야 하는지 선택하십시오. 대부분의 경우 지금 한 번 동기화 옵션을 사용한 다음 적용 버튼을 클릭하면 됩니다.

WPML은 필드를 동기화한 다음 비동기화 옵션으로 재설정합니다. 이렇게 하면 동기화가 데이터베이스에 한 번만, 그리고 사용자가 선택한 시간에만 적용됩니다.

JSON 파일에서 ACF 필드의 번역 기본 설정 지정

ACF의 로컬 JSON 기능을 사용하시는 경우, ACF Multilingual (ACFML)은 JSON 파일의 모든 필드에 번역 설정을 자동으로 추가합니다. 이는 사이트 간에 JSON 파일을 내보내고 가져올 때 대상 사이트에 번역 설정이 자동으로 적용됨을 의미합니다.

원본 대상 사이트 모두에서 ACFML을 활성화하기만 하면 됩니다. 완료되면 ACF가 JSON 파일을 생성할 때마다 번역 기본 설정도 함께 포함됩니다.

JSON 파일이 원래 ACFML이 활성화되지 않은 상태에서 생성되었다면, ACFML을 활성화한 다음 ACF 사용자 인터페이스로 JSON 파일을 가져오고 번역 기본 설정을 지정한 뒤 필드 그룹을 다시 저장하십시오. 그러면 기본 설정이 포함된 JSON 파일이 다시 생성됩니다.