🚀 새로운 Gato GraphQL v2.1로 WordPress 작업을 자동화하세요

Gato GraphQL v2.1이 출시되었음을 기쁘게 알려드립니다!

이 새 버전과 PRO 확장 기능을 함께 사용하면 GraphQL as Automator를 실현할 수 있습니다. GraphQL 퍼시스티드 쿼리를 활용하여 WordPress 사이트의 데이터 관련 작업을 자동화할 수 있습니다.

아래에 v2.1에 추가된 모든 변경 사항을 정리하였습니다（간략한 버전은 GitHub 릴리스 노트에서 확인하실 수 있습니다）.

​

내부 GraphQL 서버 호출 시 적용할 스키마 구성 지정 지원

이제 내부 GraphQL 서버（즉, 엔드포인트를 통하지 않고 PHP 애플리케이션 내부에서 직접 실행하는 경우）를 통해 쿼리를 실행할 때 적용할 스키마 구성을 지정할 수 있습니다.

이 새로운 기능은 Internal GraphQL Server 확장 기능을 강화합니다. GraphQLServer 클래스의 executeQuery 및 executeQueryInFile 메서드에 $schemaConfigurationIDOrSlug 파라미터가 추가되었으며, executePersistedQuery에서는 퍼시스티드 쿼리에 사용된 스키마 구성을 이미 추출하고 있습니다.

class GraphQLServer {
  
  public static function executeQuery(
    string $query,
    array $variables = [],
    ?string $operationName = null,
+   // Accept parameter 
+   int|string|null $schemaConfigurationIDOrSlug = null,
  ): Response {
    // ...
  }
 
  public static function executeQueryInFile(
    string $file,
    array $variables = [],
    ?string $operationName = null,
+   // Accept parameter 
+   int|string|null $schemaConfigurationIDOrSlug = null,
  ): Response {
    // ...
  }
 
  public static function executePersistedQuery(
    WP_Post|string|int $persistedQuery,
    array $variables = [],
    ?string $operationName = null,
+   // Schema Configuration is taken directly from the Persisted Query
  ): Response {
    // ...
  }Copy

​

GraphQL as Automator [PRO]

위 기능은 Automation 확장 기능 업그레이드의 기반이 되기도 합니다.

Automation 확장 기능에는 Automation Configurator라는 「오토메이터」 사용자 인터페이스（WordPress 편집기에서 직접 사용 가능）가 추가되었습니다. 자동화 트리거는 WordPress 액션 훅이며, 실행되는 작업은 GraphQL 퍼시스티드 쿼리입니다.

예를 들어, 새 게시물을 작성할 때 자동화 규칙 Add comments block to new post（동일한 이름의 퍼시스티드 쿼리 실행）는 core/comments 블록이 존재하는지 확인하고, 없다면 게시물 하단에 추가합니다.

오토메이터를 활용할 수 있는 몇 가지 방법을 소개합니다.

• AI를 사용하여 새 게시물의 대표 이미지를 생성（및 최적화）하기
• 게시물이 공개될 때 필수 블록 추가하기
• 게시물이 업데이트될 때 모든 이미지 소스와 링크의 http를 https로 교체하기
• 새 게시물이 있을 때 관리자에게 이메일 발송하기
• 댓글에 새 답글이 달린 사용자에게 이메일 발송하기
• [멀티사이트] 새 게시물을 여러 언어로 번역하고 번역된 게시물을 각 사이트에 추가하기
• 외부 서비스에서 작업 실행하기（예: 새 게시물을 Facebook에 자동으로 공유하기）

GraphQL 퍼시스티드 쿼리와 자동화 규칙을 wp-admin 내에서 직접 작성할 수 있으므로, 필요에 맞게 고도로 맞춤화된 자동화 파이프라인을 즉시 구축할 수 있습니다.

입력에 제약이 없기 때문에（GraphQL 쿼리는 WordPress 내 모든 데이터와 상호작용할 수 있으며, HTTP 클라이언트를 통해 외부 서비스에도 연결할 수 있습니다）, 요구 사항의 100%를 충족할 수 있을 것입니다.

（오토메이터 플러그인은 일반적으로 필요의 95%를 충족하지만, 필요한 입력이 매핑되어 있지 않은 경우를 종종 마주치게 됩니다。）

플러그인에는 이미 몇 가지 자동화 규칙이 생성되어 있습니다（상태가 draft이므로 적용하려면 publish로 업데이트해야 합니다）. 이 규칙들을 바로 사용하거나, 직접 자동화를 만들 때 참고 예시로 활용할 수 있습니다（이 목록은 이후 릴리스에서 계속 확장될 예정입니다）.

• Add comments block to new post
• Insert block in new post
• Send notification email to admin when there is a new post
• Generate a post's featured image using AI (and optimize it) if a new post has none

​

사전 정의된 퍼시스티드 쿼리 「Insert block in post」

새로 추가된 퍼시스티드 GraphQL 쿼리 「Insert block in post」는 게시물에 블록을 삽입할 수 있습니다. 게시물 내에서 지정한 유형（기본값: wp:paragraph）의 n번째 블록을 찾아, 제공된 커스텀 블록의 HTML 콘텐츠를 그 바로 뒤에 배치합니다.

Automation 확장 기능과 함께 사용하면, 이 퍼시스티드 쿼리를 통해 새로 공개된 게시물에 필수 블록을 자동으로 삽입할 수 있습니다（예: 진행 중인 캠페인을 홍보하는 CTA 블록）.

​

개선 사항

• 캐시에서 서비스 컨테이너 초기화에 실패할 경우 메모리에서 PHP 객체를 초기화하는 폴백 처리 추가 (#2638)
• 사전 정의된 모든 퍼시스티드 쿼리에 고유한 operationName 부여 (#2644)
• 게시물에서 블록을 가져올 때 블록 콘텐츠에 오류가 있는 경우 오류 메시지 개선
• Automation 확장 기능 문서 완성 (#2651)
• 사전 정의된 퍼시스티드 쿼리 「Generate a post's featured image using AI and optimize it」에서 게시물 제목이 비어 있지 않을 때만 로직이 실행되도록 수정 (#ec931dd)

​

수정 사항

• 확장 기능（Access Control, Cache Control, Field Deprecation）에서 사용하는 멀티 컨트롤 JS 컴포넌트가 스키마 구성의 블록에 「undefined」를 표시하는 버그 (#2639)
• 사전 정의된 퍼시스티드 쿼리의 정규식 치환 버그 (#2649)
• 플러그인을 비활성화·재활성화할 때 플러그인 설정 데이터가 재설치되지 않도록 수정 (#2641)
• 내부 GraphQL 서버에 GraphQL 변수로 WP_Post를 전달할 때 발생하는 오류 처리 (#2652)