【WordPress】「WP GraphQL」で個人的によく使うクエリまとめ

2022/12/20

2022/12/26

WordPressをヘッドレスCMSにする時に「WP GraphQL」でデータを取得しています。

そこでよく使うGraphQLのクエリ（使いそうなクエリ）をまとめてみました。

GraphQL API for WordPress

⑴「記事一覧」を取得する
⑵「記事単体」を取得する
- 「記事のid」で取得する
- 「記事のslug」で取得する
⑶「カテゴリ一覧」を取得する
⑷「タグ一覧」を取得する
取得できる記事データ(一部)
- よく使うクエリ
取得できるカテゴリ/タグデータ(一部)
- よく使うクエリ
まとめ

⑴「記事一覧」を取得する

「最新10件分」の記事一覧を取得する

デフォルトの件数が10件

{
	posts {
		nodes {
			... // ここに取得したいデータを指定
		}
	}
}

「指定カテゴリ」の記事一覧を取得する

// カテゴリの「ID」を指定する場合
{
	posts(where: {categoryId: xxx}) {
		...
	}
}

// カテゴリの「slug」を指定する場合
{
	posts(where: {categoryName: "xxx"}) {
		...
	}
}

「指定タグ」の記事一覧を取得する

// タグの「ID」を指定する場合
{
	posts(where: {tagId: xxx}) {
		...
  }
}

// タグの「slug」を指定する場合
{
	posts(where: {tag: "xxx"}) {
		...
  }
}

⑵「記事単体」を取得する

「記事のid」で取得する

{
	postBy(id: xxx) {
		...
  }
}

「記事のslug」で取得する

{
	postBy(slug: "xxx") {
		...
  }
}

⑶「カテゴリ一覧」を取得する

{
	categories {
		nodes {
			categoryId
			name
			slug
			count
		}
	}
}

⑷「タグ一覧」を取得する

{
	tags {
		nodes {
			tagId
			name
			slug
			count
		}
	}
}

取得できる記事データ(一部)

クエリ	データの内容
id	ID
slug	slug
title	タイトル
date	公開日
modified	更新日
featuredImage	サムネイル画像
content	本文
categories	カテゴリ一覧
tags	タグ一覧
auther	執筆者

よく使うクエリ

{
	id
	slug
	status
	title
	featuredImage {
		node {
			mediaItemUrl
		}
	}
	date
	modified
	content
	categories {
		nodes {
			id
			name
			slug
		}
	}
	tags {
		nodes {
			id
			name
			slug
		}
	}
}