Logo
Interrogare i dati dei plugin
Interrogare i dati dei pluginAdvanced Custom Fields (ACF)

Advanced Custom Fields (ACF)

Scopri di più nella guida Lavorare con Advanced Custom Fields (ACF).

Esempi di queries per interagire con i dati del plugin Advanced Custom Fields (ACF).

Recuperare i campi personalizzati ACF

Possiamo utilizzare i campi meta per interrogare i dati dei campi personalizzati ACF, qualunque sia il loro tipo:

query GetPost($postId: ID!) {
  post(by: { id: $postId }) {
    id
    title
 
    # Tipi di campo di base
    text: metaValue(key: "text_field")
    textarea: metaValue(key: "textarea_field")
    select: metaValue(key: "select_field")
    multiSelect: metaValue(key: "multi_select_field")
    number: metaValue(key: "number_field")
 
    # Campo data
    dateAsString: metaValue(key: "date_field")
    dateYear: _strSubstr(string: $__dateAsString, offset: 0, length: 4)
    dateMonth: _strSubstr(string: $__dateAsString, offset: 4, length: 2)
    dateDay: _strSubstr(string: $__dateAsString, offset: 6, length: 2)
    dateTime: _makeTime(year: $__dateYear, month: $__dateMonth, day: $__dateDay, hour: 0, minute: 0, second: 0)
    date: _date(format: "Y-m-d", timestamp: $__dateTime)
  }
}

Se il valore meta è una relazione (es.: un articolo, un utente, una tassonomia, ecc.), possiamo utilizzare il valore per interrogare l'entità corrispondente di tipo Post, User, Taxonomy, ecc.:

query GetPostWithRelationships($postId: ID!) {
  post(by: { id: $postId }) {
    id
    title
    
    # Esporta la relazione verso un articolo
    relationshipPostId: metaValue(key: "relationship_post_id")
      @export(as: "relationshipPostId")
 
    # Esporta la relazione verso un elenco di articoli
    relationshipPostIds: metaValue(key: "relationship_post_ids")
      @export(as: "relationshipPostIds")
  }
}
 
query QueryPostRelationships @depends(on: "GetPostWithRelationships") {  
  # Interroga la relazione verso un articolo
  relationshipPost: post(by: { id: $relationshipPostId }) {
    id
    title
  }
 
  # Interroga la relazione verso un elenco di articoli
  relationshipPosts: posts(filter: { ids: $relationshipPostIds }) {
    id
    title
  }
}

Aggiornare i campi personalizzati ACF

Possiamo utilizzare le mutazioni meta per aggiornare i dati dei campi personalizzati ACF, passando i loro nomi di campo e valori, qualunque sia il loro tipo:

mutation UpdatePost($postId: ID!) {
  updatePost(
    input: {
      id: $postId
      meta: {
        text_field: ["New text value"],
        textarea_field: ["New textarea value"],
        select_field: ["New select value"],
        multi_select_field: ["Choice 1", "Choice 2"],
        number_field: [42],
        date_field: ["20240320"],
      }
    }
  ) {
    status
    errors {
      __typename
      ...on ErrorPayload {
        message
      }
    }
    post {
      id
      text: metaValue(key: "text_field")
      textarea: metaValue(key: "textarea_field")
      select: metaValue(key: "select_field")
      multiSelect: metaValues(key: "multi_select_field")
      number: metaValue(key: "number_field")
      date: metaValue(key: "date_field")
    }
  }
}