Cómo usar GraphQL con WordPress (WPGraphQL) y Next.js: Ejemplos reales

En la era del desarrollo web moderno, crear un Headless CMS con WordPress y consumirlo mediante una interfaz moderna como Next.js es una práctica cada vez más común. Gracias a WPGraphQL, un plugin gratuito y open-source, podemos transformar nuestro CMS tradicional de WordPress en una API GraphQL eficiente, que permite peticiones flexibles y optimizadas.

¿Qué es WPGraphQL y por qué usarlo?

WPGraphQL es un plugin para WordPress que agrega una capa GraphQL a la API REST nativa de WordPress. Esta capa permite realizar consultas precisas, evitándose cargas de datos innecesarias, y en formato estándar para el ecosistema de JavaScript y frameworks modernos como React o Next.js.

Mejora el rendimiento al solicitar solo la información necesaria.
Proporciona un esquema fuertemente tipado para consumir datos con confianza.
Ideal para aplicaciones Jamstack y sitios estáticos con Next.js.

¿Por qué usar Next.js con WPGraphQL?

Next.js es un framework React con funcionalidades SSR (Server Side Rendering) y SSG (Static Site Generation) que se complementa perfectamente con una fuente de datos remota como WordPress usando GraphQL. Puedes generar sitios rápidos, escalables y con buena experiencia de usuario.

Configurando tu proyecto: ejemplo práctico

1. Instala WPGraphQL en WordPress

Desde el panel de administración de WordPress, instala y activa el plugin WPGraphQL. Esto expondrá automáticamente un endpoint GraphQL en https://tudominio.com/graphql.

2. Crear un proyecto Next.js

npx create-next-app wp-graphql-next

Una vez creado ingresa a la carpeta:

cd wp-graphql-next

3. Instalar Apollo Client para consumir GraphQL

npm install @apollo/client graphql

4. Crear configuración Apollo Client

Crea un archivo lib/apolloClient.js con este contenido:

import { ApolloClient, InMemoryCache } from '@apollo/client';

const client = new ApolloClient({
  uri: 'https://tudominio.com/graphql',
  cache: new InMemoryCache(),
});

export default client;

5. Consultar posts desde WordPress

Crea o modifica pages/index.js para obtener datos con GraphQL:

import { gql, useQuery } from '@apollo/client';
import client from '../lib/apolloClient';

const GET_POSTS = gql`
  query GetPosts {
    posts(first: 10) {
      nodes {
        id
        title
        excerpt
        uri
      }
    }
  }
`;

export async function getStaticProps() {
  const { data } = await client.query({
    query: GET_POSTS,
  });

  return {
    props: {
      posts: data.posts.nodes,
    },
    revalidate: 10,
  };
}

export default function Home({ posts }) {
  return (
    
      Últimos posts desde WordPress
      
        {posts.map((post) => (
          
            
            
          
        ))}
      
    
  );
}

Aspectos clave para producción

Seguridad: aplica mecanismos para proteger tu endpoint si es necesario.
Caching: usa ISR (Incremental Static Regeneration) o SSR para mejorar la experiencia.
Optimización: utiliza fragmentos y consultas específicas para minimizar el payload.

Conclusión

Usar GraphQL con WordPress mediante WPGraphQL y consumirlo con Next.js es una solución potente para crear sitios web modernos, rápidos y fáciles de mantener. Con esta integración, puedes sacar el máximo provecho de la flexibilidad de WordPress como CMS y la experiencia de usuario que ofrecen frameworks React como Next.js.

¿Quieres más ejemplos o una guía detallada? ¡Déjanos tus comentarios y comparte este artículo!