WPGraphQL Tax Query

This FREE plugin filters the connections for Posts and Post Types to allow for advanced querying by taxonomy filters.

A feature like this will be in core WPGraphQL soon, but for now you can use the plugin.

Official Plugin

View Plugin on Github

Plugin README

WPGraphQL Tax Query

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

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: POST_TAG,
            operator: IN,
            field: SLUG
          }
        ]
      }
      }
  ){
    edges{
      cursor
      node{
        id
        postId
        link
        date
      }
    }
  }
}

query{
  posts(
    where: {
      taxQuery: {
        relation: OR,
        taxArray: [
          {
            terms: ["graphql"],
            taxonomy: CATEGORY,
            operator: IN,
            field: SLUG
          },
          {
            terms: ["wordpress"],
            taxonomy: POST_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 );

$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 );

WPGraphQL Tax Query

WPGraphQL Tax Query.css-g53hu1{margin-top:-120px;padding-bottom:120px;display:block;}

Pre-req's

Activating / Using

Example Query

WPGraphQL Tax Query