jasonbahl

On-demand revalidation from WPGraphQL Smart Cache purge events

Tells a decoupled front end to rebuild affected pages when content changes, by listening to the purge events WPGraphQL Smart Cache already emits.

Used in production on the CMS behind wpgraphql.com.

The problem

A front end using ISR (Next.js, or anything with a revalidate window) serves a

jasonbahl

Post Types Order + WPGraphQL ordering bridge

Post Types Order hooks posts_orderby at priority 99 and rewrites the ORDER BY SQL directly, which breaks WPGraphQL's cursor pagination. This drops that filter for GraphQL requests and expresses the manual order through WP_Query args instead, where WPGraphQL can see it and paginate correctly.

This replaces an earlier version of this snippet from 2022. That one works for the case it was written for, but it has three problems that took a while to track down on a real site.

jasonbahl

Headless mode for WordPress: redirect the front end, keep the APIs

Two small pieces that let a WordPress install act purely as a headless backend, used in production on the CMS behind wpgraphql.com.

1. Stop serving front-end templates. Every front-end request 301s to the decoupled front end. REST, GraphQL, cron, WP-CLI and wp-admin are untouched.
2. Point home_url() at the front end, so plugins that build URLs from it (Yoast in particular) produce front-end URLs rather than CMS ones.

jasonbahl

<?php
namespace WPGraphQL\SmartCache\Cache;

use Exception;
use GraphQLRelay\Relay;
use WP_Comment;
use WP_Post;
use WP_Term;
use WP_User;
use WPGraphQL\Model\Menu;

jasonbahl

diff --git a/src/Cache/Query.php b/src/Cache/Query.php
index ec5cfdc..3435ac0 100644
--- a/src/Cache/Query.php
+++ b/src/Cache/Query.php
@@ -22,6 +22,13 @@ class Query {
 	 **/
 	public static $storage = null;
 
+	/**
+	 * The current GraphQL request.

jasonbahl

diff --git a/src/Cache/Query.php b/src/Cache/Query.php
index ec5cfdc..3435ac0 100644
--- a/src/Cache/Query.php
+++ b/src/Cache/Query.php
@@ -22,6 +22,13 @@ class Query {
 	 **/
 	public static $storage = null;
 
+	/**
+	 * The current GraphQL request.

jasonbahl

import { GraphQLClient, gql } from 'graphql-request';
import { SEED_QUERY } from '@/components/WPTemplateRouter/SEED_QUERY';
import templates from '@/wp-templates/wp-templates.js';

/**
 * Fetches the seed node data from WordPress using the SEED_QUERY.
 *
 * @param {object} context - The context object.
 * @param {string} context.uri - The URI of the node to fetch.
 * @param {boolean} [context.isPreview=false] - Whether this is a preview request.

jasonbahl

<?php
/**
 * Plugin Name: WPGraphQL Track GetText
 * Description: Test plugin for tracking the number of times the wp-graphql textdomain is translated during a WPGraphQL request. The count is output in the "extensions" portion of the graphql response. 
 */

if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

jasonbahl

add_action( 'graphql_register_types', function() {

	register_graphql_connection( [
		'fromType' => 'Page',
		'toType' => 'Page',
		'connectionTypeName' => 'PageSiblings',
		'fromFieldName' => 'siblings',
		'resolve' => function( $page, $args, $context, $info ) {
			$parent = $page->parentDatabaseId ?? null;

jasonbahl

add_action( 'graphql_cache_invalidation_init', static function( \WPGraphQL\SmartCache\Cache\Invalidation $invalidation ) {

	add_action( 'updated_option', static function( $option, $value, $original_value ) use ( $invalidation ) {

		// phpcs:ignore
		if ( ! isset( $_POST['_acf_screen'] ) || 'options' !== $_POST['_acf_screen'] ) {
			return;
		}

		// phpcs:ignore