WP Manifestindependent plugin directory
manifest / integrations / wp-graphql-tax-query

WPGraphQL Tax Query

Adds `tax_query` support to postObject connection queries using WP_Query

by WPGraphQL, Jason Bahl · github.com/wp-graphql/wp-graphql-tax-query · website

55stars
16forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/wp-graphql/wp-graphql-tax-query/archive/refs/heads/develop.zip

Readme

WPGraphQL Tax Query

This plugin adds Tax_Query support to the WP GraphQL Plugin for postObject query args (WP_Query).

Pre-req's

Using this plugin requires having the WPGraphQL plugin installed and activated. (version 0.0.15 or newer)

Activating / Using

Activate the plugin like you would any other WordPress plugin.

Once the plugin is active, the taxQuery argument will be available to any post object connectionQuery (posts, pages, custom post types, etc).

Example Query

Below is an example Query using the taxQuery input on a posts query. (Go ahead and check things out in GraphiQL)

This will find posts that are in the category "graphql" OR tagged with "wordpress".

query{
  posts(
    where: {
      taxQuery: {
        relation: OR,
        taxArray: [
          {
            terms: ["graphql"],
            taxonomy: CATEGORY,
            operator: IN,
            field: SLUG
          },
          {
            terms: ["wordpress"],
            taxonomy: TAG,
            operator: IN,
            field: SLUG
          }
        ]
      }
    }
  ){
    edges{
      cursor
      node{
        id
        postId
        link
        date
      }
    }
  }
}

The same query in PHP using WP_Query would look like:

$args = [
    'tax_query' => [
        'relation' => 'OR',
        [
            'terms' => ['graphql'],
            'taxonomy' => 'category',
            'operator' => 'IN',
            'field' => 'slug',
        ],
        [
            'terms' => ['wordpress'],
            'taxonomy' => 'post_tag',
            'operator' => 'IN',
            'field' => 'slug',
        ],
    ],
];

new WP_Query( $args );

Read the full README on GitHub →

Releases

TagPublished
v0.2.0 Nov 8, 2022
v0.1.0 Oct 28, 2019
v0.0.2 Aug 3, 2017

These releases are tags only. The author does not attach a packaged zip, so there are no download counts to report.