ACFML – WordPress에서 다국어 ACF 및 ACF Pro 사용자 정의 필드 지원

모든 ACF 필드 유형의 다국어 지원

ACF로 사이트를 구축하는 경우, ACFML은 ACF 및 ACF Pro 카탈로그의 모든 필드 유형을 지원합니다.

• Text 및 Wysiwyg 필드는 언어별로 번역됩니다.
• Repeater 및 Flexible Content 행은 언어 간에 일관되게 정렬됩니다.
• Image, File 및 Gallery 필드는 언어별로 현지화된 에셋으로 교체할 수 있습니다.
• Link, Relationship 및 Post Object 필드는 언어 간에 올바르게 연결된 상태를 유지합니다.
• Date Picker, Color Picker, Map 및 기타 대화형 필드는 언어별로 올바르게 작동합니다.

ACF를 통해 등록한 사용자 정의 글 유형, 택소노미 및 옵션 페이지도 레이블을 포함하여 번역됩니다. ACF로 구축한 사이트의 일부가 아닌 전체가 ACFML을 통해 다국어 사이트가 됩니다.

언어별로 동일한 항목과 다른 항목 선택

ACF 필드 그룹에는 모든 상황에 맞는 단일 번역 동작이 없습니다. 사이트의 Our Team 페이지는 모든 언어에서 동일한 팀원을 보여줍니다. 이름과 약력을 번역하고 구조는 그대로 유지합니다. Events 페이지는 대상에 따라 다른 이벤트를 보여줍니다. 언어별로 완전히 다른 이벤트를 표시합니다. Product Specs 페이지는 혼합되어 있습니다. 설명은 번역하고 SKU와 가격은 동일하게 유지합니다.

ACFML은 필드 그룹 단위로 이 세 가지를 모두 처리합니다. 언어 간 동일한 필드, 언어 간 다른 필드, 혼합 설정을 위한 전문가 모드가 있습니다. 각 필드 그룹의 목적에 맞는 모드를 선택하면 ACFML이 번역 동작을 자동으로 연결합니다.

필드별 번역 제어

필드 그룹 내에서 모든 필드는 고유한 번역 기본 설정을 갖습니다.

• 번역. 필드의 값이 언어별로 번역됩니다.
• 복사. 필드의 값이 언어 간에 동기화 상태를 유지합니다. 한 번 편집하면 모든 언어에 적용됩니다.
• 한 번 복사. 필드의 값이 새로운 번역의 바탕이 되며, 이후 각 언어 버전을 독립적으로 편집할 수 있습니다.
• 번역하지 않음. 필드가 완전히 무시됩니다(예: 내부 관리자 전용 필드).

각 필드 유형에 대한 합리적인 기본값이 기본으로 제공됩니다. Text 및 Wysiwyg 필드는 기본적으로 번역으로 설정되고, Image, Link 및 Number와 같은 구조화된 필드는 기본적으로 복사로 설정됩니다. 전체 사전 설정 참조는 ACF 사용자 정의 필드 번역 방법에서 확인할 수 있습니다.

언어 간에 일관되게 정렬되는 Repeater 및 Flexible Content 행

Repeater 및 Flexible Content 필드는 다른 도구에서 다국어 ACF 설정이 자주 손상되는 부분입니다. 행의 동기화가 끊어지고 레이아웃이 달라지며 번역가가 알 수 없는 콘텐츠를 보게 됩니다. ACFML은 기본적으로 행 구조를 언어 간에 일관되게 유지합니다. 번역가는 번역 가능한 각 하위 필드가 제자리에 있는 상태에서 동일한 행을 동일한 순서로 보게 됩니다. 언어별로 다른 구조가 필요한 경우(예: 언어별로 다른 이벤트 목록), 한 번 복사 기본 설정을 사용하여 이를 해결할 수 있습니다.

동일한 번역 동작이 적용되는 로컬 필드(PHP 등록)

많은 운영 사이트에서 이식성, 버전 제어 또는 테마 번들 구성을 위해 ACF 관리자 UI 대신 PHP로 ACF 필드를 등록합니다. ACFML 2.2.0(2026년 2월)은 완전한 로컬 필드 지원을 제공합니다. 필드 그룹 정의에서 wpml_cf_preferences 키를 사용하여 각 필드의 번역 기본 설정을 지정하고 ACF > 도구에서 WPML로 동기화하면, 관리자 화면에 필드 그룹이 선언한 내용이 반영됩니다. 사이트 간에 내보내기 및 가져오기를 수행할 때 ACF의 로컬 JSON 파일에 기본 설정이 함께 전달됩니다. 단계별 절차는 사용 방법 페이지의 PHP 또는 JSON에 등록된 필드의 기본 설정 지정 아래에 있습니다.

예외적인 경우를 위한 개발자 훅

사용자 정의 필드 번역 로직(특정 필드 제외, 필드 유형의 기본 설정을 전역으로 재정의, 번역가에게 주석 숨기기)이 있는 사이트를 위해 ACFML은 2개의 필터(acfml_should_translate_acf_entity, acfml_field_group_mode_field_translation_preference)와 4개의 상수(ACFML_EXCLUDE_FIELD_GROUP_STRINGS_IN_POST_JOBS, ACFML_HIDE_FIELD_ANNOTATIONS, ACFML_REPEATER_SYNC_DEFAULT, ACFML_SCAN_LOCAL_FIELDS)를 제공합니다. 코드 예제가 포함된 전체 참조는 ACFML 훅 및 상수 참조에서 확인할 수 있습니다.

ACF 팀과 함께 구축 및 유지 관리

WPML과 ACF 팀은 지속적인 호환성을 위해 긴밀하게 협력하며, 이는 공동 ACF 호환성 페이지에서 확인할 수 있습니다. ACF 또는 ACF Pro 릴리스가 출시되면 ACFML도 이에 맞춰 업데이트됩니다. 새로운 번역 동작을 위해 ACFML에 ACF 측의 지원이 필요한 경우, 리버스 엔지니어링을 수행하는 대신 통합 기능을 함께 구축합니다.