블로그

🚀 (거의) 모든 Gutenberg 블록, Bricks 요소, Elementor 위젯 번역 — Gemini, WP AI Connectors, 번역용 AI Abilities 추가

Leonardo Losoviz
작성자: Leonardo Losoviz ·

Gato AI Translations for Polylang v18.0이 출시되었습니다 — 많은 분들께서 특별히 요청하신 기능들을 담은 긴 목록과 함께, 역대 최대 규모의 릴리스 중 하나입니다.

핵심 내용은 어떤 플러그인의 블록·요소·위젯이든, 최소한의 설정으로 거의 모두 번역할 수 있게 되었다는 것입니다. 자세히 살펴보겠습니다.

🗂️ ACF 블록

Advanced Custom Fields로 등록된 블록이 이제 기본적으로 지원됩니다. ACF 필드를 번역 대상으로 등록하는 방법은 세 가지입니다.

  • 전역으로, 설정의 단일 토글(ACF 블록을 자동으로 번역하시겠습니까?)을 통해 — 모든 ACF 블록의 번역 가능한 모든 문자열이 번역을 위해 전송됩니다.
  • 필드 그룹별로, v18이 ACF 필드 그룹 UI에 추가한 새로운 Gato Translate 입력을 통해.
  • PHP에서 필드별로, 표준 ACF acf/load_field 훅을 통해.
ACF 블록 자동 번역 활성화
새로운 「ACF 블록을 자동으로 번역하시겠습니까?」 설정

자세한 내용은 ACF 블록을 참조하세요.

🐘 PHP 전용 블록

WordPress 7.0부터 블록을 PHP 전용(JavaScript 번들 없음)으로 등록할 수 있습니다. v18은 이를 일반 블록과 동일하게 처리하여, 모든 문자열 속성을 추가 설정 없이 자동으로 번역 대상으로 등록합니다. 특정 속성을 제외하려면 한 줄짜리 PHP 훅으로 옵트아웃할 수 있습니다.

🧱 wpml-config.xml을 포함하는 모든 플러그인

v18은 **모든 플러그인의 wpml-config.xml**을 읽어 어떤 블록 속성이 번역 가능한지 판단합니다. 즐겨 사용하시는 블록 플러그인이 이미 WPML용 문서를 갖추고 있다면, Gato AI Translations for Polylang에서도 기본적으로 바로 작동합니다.

🧩 Kadence 및 Greenshift 블록 지원

모든 Kadence 블록과 모든 Greenshift 블록이 이제 자동으로 번역됩니다. 커스텀 훅도, 추가 설정도 필요하지 않습니다.

번역된 Kadence 블록
모든 Kadence(및 Greenshift) 블록이 번역되었습니다

🔌 커스텀 및 서드파티 블록·요소·위젯 — PHP 훅으로 매우 간단하게

직접 만든 커스텀 블록·요소·위젯, 그리고 wpml-config.xml을 포함하지 않는 서드파티 플러그인에 대한 지원을 확장하려면, PHP 훅을 통해 번역 가능한 속성 몇 가지를 선언하기만 하면 됩니다.

Gutenberg의 경우, gatompl:gutenberg_block_type_translatable_attribute_regexes를 통해 번역 가능한 속성을 선언합니다.

add_filter(
    'gatompl:gutenberg_block_type_translatable_attribute_regexes',
    static function (array $regexes): array {
        $regexes['kadence/countdown'] = [
            'daysLabel'    => true,
            'hoursLabel'   => true,
            'minutesLabel' => true,
            'secondsLabel' => true,
        ];
        return $regexes;
    }
);

Bricks의 경우, gatompl:bricks_element_type_translatable_properties를 사용합니다.

add_filter(
    'gatompl:bricks_element_type_translatable_properties',
    static function (array $translatableProperties): array {
        $translatableProperties['breadcrumbs'][] = 'separatorText';
        $translatableProperties['team-members']['items'][] = 'title';
        return $translatableProperties;
    }
);

Elementor의 경우, gatompl:elementor_widget_type_translatable_properties를 사용합니다.

add_filter(
    'gatompl:elementor_widget_type_translatable_properties',
    static function (array $translatableProperties): array {
        $translatableProperties['blockquote'][] = 'author_name';
        $translatableProperties['reviews']['slides'][] = 'name';
        return $translatableProperties;
    }
);

엔티티 참조(커스텀 포스트, 미디어, 택소노미 텀, ID별 메뉴, 슬러그별 메뉴)를 재매핑하기 위한 동등한 훅도 제공됩니다. 자세한 내용은 업데이트된 문서를 확인하세요.

⚡ 더 빠르고, 더 가볍게

v18에서는 플러그인 내부가 전면 개선되었습니다. 번역 실행이 눈에 띄게 빨라졌고, 메모리 사용량도 크게 줄었습니다. 콘텐츠 번역이 훨씬 부드럽게 느껴질 것입니다.

🐈 Gato Translate 빠른 링크

모든 CPT, 미디어, 태그, 카테고리, 사용자 목록 페이지에 표준 행 액션 옆에 Gato Translate 빠른 링크가 추가되었습니다. 클릭 한 번으로 개별 엔티티를 번역할 수 있으며, 일괄 작업 드롭다운이 필요 없습니다.

Gato Translate 빠른 링크
목록 페이지에서 클릭 한 번으로 번역

🍔 메뉴용 Gato Translate 버튼

메뉴 편집기에 전용 Gato Translate 버튼이 추가되어, 클릭 한 번으로 단일 메뉴를 수동으로 번역할 수 있게 되었습니다. 「메뉴 자동 번역」 을 켜고 저장한 후 다시 끄는 기존의 우회 방법은 더 이상 필요하지 않습니다.

메뉴 편집기의 Gato Translate 버튼
메뉴 편집기에 추가된 새로운 Gato Translate 버튼

✨ Gemini 번역 공급자

v18은 ChatGPT, Claude, DeepL, DeepSeek, Google Translate, Mistral, OpenRouter, 자체 호스팅 LLM과 함께 Google Gemini를 일급 번역 공급자로 추가합니다.

지원되는 모델에는 Gemini 2.5 Flash, Gemini 2.5 Pro, Gemini 3.1 Flash-Lite가 포함됩니다. 전체 목록은 지원되는 AI 모델은 무엇인가요?를 참조하세요.

🤖 WordPress 7.0: AI Connectors

**WordPress 7.0+**를 사용 중이라면, 이제 API 키를 WP AI Connectors에서 자동으로 가져올 수 있습니다. 플러그인 설정에서 ChatGPT, Claude, Gemini 키를 비워두면, 설정 → Connectors에 등록된 키가 대신 사용됩니다. 플러그인 간에 키를 중복 관리하거나 복사·붙여넣기할 필요가 없습니다.

WP AI Connectors에서 API 키 등록
WP AI Connectors에 API 키를 한 번 등록하면 Gato AI Translations가 자동으로 가져옵니다

이로 인해 플러그인이 즉시 작동합니다. 라이선스 키를 추가하기만 하면, WP AI Connectors를 통해 API 키가 설정된 첫 번째 AI 서비스가 기본 번역 공급자로 자동 선택됩니다. 추가 클릭이 필요하지 않습니다.

✨ 번역용 AI Abilities

v18은 모든 엔티티 유형에 AI Abilities를 등록하므로, 커스텀 포스트, 택소노미 텀, 미디어, 메뉴, 사용자 모두를 Claude Code(또는 WP Abilities를 사용하는 모든 에이전트)의 자연어 프롬프트에서 바로 번역할 수 있습니다.

Translate post with title "How to onboard new editors" to French only

이 기능은 WordPress 7.0+(AI Abilities 플랫폼이 도입된 버전)가 필요합니다. 새로운 가이드 WordPress AI Abilities에서 자세한 내용을 확인하세요.

🧠 지원 AI 모델 추가

v18은 모델 카탈로그도 최신 상태로 유지합니다.

  • ChatGPT: GPT-5.4 mini, GPT-5.5
  • Claude: Claude Sonnet 4.6, Claude Haiku 4.5, Claude Opus 4.7
  • DeepSeek: DeepSeek v4, DeepSeek v4 Flash
  • Gemini: 2.0 Flash / Flash-Lite, 2.5 Flash / Flash-Lite / Pro, 3.1 Flash-Lite

전체 목록은 지원되는 AI 모델은 무엇인가요?를 참조하세요.

⏱️ 번역 타임아웃

이제 설정에서 번역 타임아웃을 설정할 수 있습니다. 업스트림이 응답하지 않을 때 일반적인 HTTP 502 / 504가 발생하는 대신, 로그에 제어된 오류로 깔끔하게 실패합니다. 서버의 max_execution_time보다 약간 낮은 값으로 설정하세요. 자세한 내용은 번역 타임아웃 설정을 참조하세요.

업그레이드

릴리스는 지금 고객 대시보드를 통해 순차적으로 배포되고 있습니다. WordPress 관리자(플러그인 → 업데이트)에서 업데이트하거나, 계정에서 최신 버전을 다운로드하세요.

변경 사항의 전체 목록은 changelog를 참조하세요.

v18을 즐기세요! 🎉


다음에 무엇이 나오는지 알아보세요

뉴스레터를 구독하세요: 새 버전을 출시하거나, 새 플러그인을 선보이거나, 공유할 소식이 있을 때 알려드립니다.