Logo
튜토리얼
튜토리얼특정 블록이 포함된 게시물 찾기

특정 블록이 포함된 게시물 찾기

플러그인으로 번역할 수 없는 Gutenberg 블록을 만날 때가 있습니다（모든 Gutenberg 블록을 번역할 수 있나요? 참조）. 그런 경우에는 해당 블록이 포함된 모든 게시물을 파악한 후, 번역 가능한 다른 블록으로 교체해야 합니다.

Gato AI Translations for Polylang 은 내부적으로 Gato GraphQL을 실행하므로, GraphQL 쿼리를 사용하여 콘텐츠를 편리하게 검색할 수 있습니다.

GraphQL 쿼리를 실행하려면 먼저 Advanced Mode 를 활성화하고 Queries CPT에 접근해야 합니다. Advanced Mode 활성화 방법은 헬퍼 쿼리 만들기를 참조하세요.

GraphQL 쿼리 만들기

WordPress 관리자 메뉴에서 Queries 로 이동하여 새 항목을 추가합니다. "Find posts containing a certain block"과 같이 알아보기 쉬운 제목을 붙여주세요.

그런 다음 아래의 GraphQL 쿼리를 붙여넣습니다:

query FindPostsContainingBlock(
  $blockName: String!
) {
  customPostCount(
    filter: {
      status: any,
      search: $blockName
    }
  )
  customPosts(
    filter: {
      status: any,
      search: $blockName
    },
    pagination: { limit: -1 }
  ) {
    id
    title
    customPostType
    url
    wpAdminEditURL
  }
}

GraphQL 변수 설정

쿼리를 실행하기 전에 blockName 변수를 지정해야 합니다. 블록 이름은 namespace/block-name 형식을 따릅니다.

예를 들어, Yoast FAQ 블록이 포함된 게시물을 찾으려면 GraphQL 변수를 다음과 같이 설정하세요:

{
  "blockName": "yoast/faq-block"
}

정확한 블록 이름을 확인하려면 Gutenberg 편집기에서 블록을 검사하거나 해당 블록의 문서를 참조하세요.

쿼리 실행

GraphQL 변수를 설정한 후 쿼리를 실행합니다. 응답에는 다음이 포함됩니다:

  • customPostCount: 해당 블록이 포함된 게시물의 총 수
  • customPosts: 일치하는 모든 게시물과 해당 세부 정보의 배열
GraphQL 쿼리 실행
GraphQL 쿼리 실행

응답 예시

{
  "data": {
    "customPostCount": 6,
    "customPosts": [
      {
        "id": 38602,
        "title": "BTS B",
        "customPostType": "page",
        "url": "https://www.mysite.com/bts-dietetique-b/",
        "wpAdminEditURL": "https://www.mysite.com/wp-admin/post.php?post=38602&action=edit"
      },
      {
        "id": 38024,
        "title": "Merci",
        "customPostType": "page",
        "url": "https://www.mysite.com/merci/",
        "wpAdminEditURL": "https://www.mysite.com/wp-admin/post.php?post=38024&action=edit"
      },
      {
        "id": 38633,
        "title": "BTS A",
        "customPostType": "page",
        "url": "https://www.mysite.com/bts-dietetique-a/",
        "wpAdminEditURL": "https://www.mysite.com/wp-admin/post.php?post=38633&action=edit"
      },
      {
        "id": 34871,
        "title": "Collagène marin B",
        "customPostType": "page",
        "url": "https://www.mysite.com/meilleurs-collagenes-marin/",
        "wpAdminEditURL": "https://www.mysite.com/wp-admin/post.php?post=34871&action=edit"
      },
      {
        "id": 34853,
        "title": "Collagène marin A",
        "customPostType": "page",
        "url": "https://www.mysite.com/meilleur-collagene-marin/",
        "wpAdminEditURL": "https://www.mysite.com/wp-admin/post.php?post=34853&action=edit"
      },
      {
        "id": 33987,
        "title": "Meilleur collagène en 2025 : l’avis d’un médecin (15 marques)",
        "customPostType": "page",
        "url": "https://www.mysite.com/meilleur-collagene/",
        "wpAdminEditURL": "https://www.mysite.com/wp-admin/post.php?post=33987&action=edit"
      }
    ]
  }
}

아무 wpAdminEditURL 링크나 클릭하면 해당 게시물을 WordPress 편집기에서 바로 열 수 있습니다. 각 게시물로 이동하여 문제가 있는 블록을 번역 가능한 대체 블록으로 교체하세요.