Logo
Requêter les données WordPress
Requêter les données WordPressÉtiquettes de publication

Étiquettes de publication

Voici des exemples de requêtes pour récupérer des données d'étiquettes de publication.

Récupérer des étiquettes

Liste des étiquettes de publication, triées par nom et affichant leur nombre de publications :

query {
  postTags(
    sort: { order: ASC, by: NAME }
    pagination: { limit: 50 }
  ) {
    id
    name
    url
    postCount
  }
}

Toutes les étiquettes d'une publication :

query {
  post(by: { id: 1 }) {
    tags {
      id
      name
      url
    }
  }
}

Noms des étiquettes dans les publications :

query {
  posts {
    id
    title
    tagNames
  }
}

Une liste d'étiquettes prédéfinies :

query {
  postTags(filter: { ids: [66, 70, 191] }) {
    id
    name
    url
  }
}

Filtrer les étiquettes par nom :

query {
  postTags(filter: { search: "oo" }) {
    id
    name
    url
  }
}

Compter les résultats d'étiquettes :

query {
  postTagCount(filter: { search: "oo" })
}

Paginer les étiquettes :

query {
  postTags(
    pagination: {
      limit: 5,
      offset: 5
    }
  ) {
    id
    name
    url
  }
}

Récupérer des valeurs meta :

query {
  postTags(
    pagination: { limit: 5 }
  ) {
    id
    name
    metaValue(
      key: "someKey"
    )
  }
}

Définir des étiquettes sur une publication

Mutation :

mutation {
  setTagsOnPost(
    input: {
      id: 1499, 
      tags: ["api", "development"]
    }
  ) {
    status
    errors {
      __typename
      ... on ErrorPayload {
        message
      }
    }
    postID
    post {
      tags {
        id
      }
      tagNames
    }
  }
}

Mutation imbriquée :

mutation {
  post(by: { id: 1499 }) {
    setTags(
      input: {
        tags: ["api", "development"]
      }
    ) {
      status
      errors {
        __typename
        ... on ErrorPayload {
          message
        }
      }
      postID
      post {
        tags {
          id
        }
        tagNames
      }
    }
  }
}

Créer, mettre à jour et supprimer une étiquette de publication

Cette requête crée, met à jour et supprime des termes d'étiquette de publication :

mutation CreateUpdateDeletePostTags {
  createPostTag(input: {
    name: "Some name"
    slug: "Some slug"
    description: "Some description"
  }) {
    status
    errors {
      __typename
      ...on ErrorPayload {
        message
      }
    }
    category {
      ...PostTagData
    }
  }
 
  updatePostTag(input: {
    id: 1
    name: "Some updated name"
    slug: "Some updated slug"
    description: "Some updated description"
  }) {
    status
    errors {
      __typename
      ...on ErrorPayload {
        message
      }
    }
    category {
      ...PostTagData
    }
  }
 
  deletePostTag(input: {
    id: 1
  }) {
    status
    errors {
      __typename
      ...on ErrorPayload {
        message
      }
    }
  }
}
 
fragment PostTagData on PostTag {
  id
  name
  slug
  description
}