Logo
Tutorial
TutorialScoprire quali articoli contengono un blocco specifico

Scoprire quali articoli contengono un blocco specifico

A volte potresti imbatterti in un blocco Gutenberg che il plugin non è in grado di tradurre (vedi È possibile tradurre tutti i blocchi Gutenberg?). In questi casi, dovrai identificare tutti gli articoli che contengono quel blocco, così da poterli migrare verso un blocco diverso e traducibile.

Dato che Gato AI Translations for Polylang esegue Gato GraphQL in background, puoi eseguire comodamente delle queries GraphQL per effettuare ricerche nei tuoi contenuti.

Per eseguire le queries GraphQL, devi prima attivare l'Advanced Mode e accedere al CPT Queries. Consulta Creare queries di aiuto per le istruzioni su come attivare l'Advanced Mode.

Creare la query GraphQL

Accedi a Queries nel menu di amministrazione di WordPress e aggiungi una nuova voce. Assegnale un titolo descrittivo come «Find posts containing a certain block».

Quindi, incolla la seguente query 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
  }
}

Impostare le variabili GraphQL

Prima di eseguire la query, devi fornire la variabile blockName. Il nome del blocco segue il formato namespace/block-name.

Ad esempio, per trovare gli articoli che contengono il blocco Yoast FAQ, imposta le variabili GraphQL come segue:

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

Per trovare il nome esatto del blocco, puoi ispezionarlo nell'editor Gutenberg o consultare la documentazione del blocco.

Eseguire la query

Dopo aver impostato le variabili GraphQL, esegui la query. La risposta includerà:

  • customPostCount: Il numero totale di articoli che contengono il blocco
  • customPosts: Un array di tutti gli articoli corrispondenti con i relativi dettagli
Esecuzione della query GraphQL
Esecuzione della query GraphQL

Esempio di risposta

{
  "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"
      }
    ]
  }
}

Fai clic su un qualsiasi link wpAdminEditURL per aprire direttamente quell'articolo nell'editor di WordPress. Poi vai su ciascun articolo e sostituisci il blocco problematico con un'alternativa traducibile.