---
title: "Configuración headless de WordPress con Next.js: Guía completa"
description: "Aprenda a usar WordPress con Next.js para crear un sitio web headless rápido y optimizado para SEO con integración de API, renderizado estático e…"
url: https://seahawkmedia.com/es/desarrollo/guia-de-wordpress-con-next.js/
language: es
---

[Home](https://seahawkmedia.com/es/) / [Desarrollo](https://seahawkmedia.com/es/desarrollo/) /¿Cómo usar WordPress con Next.js para un sitio web headless?

[Learn](https://seahawkmedia.com/learn/)

# ¿Cómo usar WordPress con Next.js para un sitio web headless?

By [Ryan James](https://seahawkmedia.com/author/ryan/) February 27, 2026 18 min read

[WordPress](https://seahawkmedia.com/wordpress/) [Next.js](https://seahawkmedia.com/nextjs/) [For enterprise](https://seahawkmedia.com/enterprise/)

Read in [English](https://seahawkmedia.com/development/wordpress-with-next-js-guide/) [العربية](https://seahawkmedia.com/ar/%D8%A7%D9%84%D8%AA%D8%B7%D9%88%D9%8A%D8%B1/%D8%AF%D9%84%D9%8A%D9%84-%D8%A7%D8%B3%D8%AA%D8%AE%D8%AF%D8%A7%D9%85-%D9%88%D9%88%D8%B1%D8%AF%D8%A8%D8%B1%D9%8A%D8%B3-%D9%85%D8%B9-next.js/) [Dansk](https://seahawkmedia.com/da/udvikling/wordpress-med-nextjs-guide/) [Italiano](https://seahawkmedia.com/it/sviluppo/guida-a-wordpress-con-next.js/) [Nederlands](https://seahawkmedia.com/nl/ontwikkeling/wordpress-met-next.js-handleiding/) [Svenska](https://seahawkmedia.com/sv/utveckling/wordpress-med-nextjs-guide/)

Some links on this page are affiliate links. If you buy through them, Seahawk may earn a commission at no extra cost to you. [Affiliate disclosure](https://seahawkmedia.com/affiliate-disclosure/)

Los sitios web modernos exigen velocidad, flexibilidad y un SEO impecable. [WordPress sin interfaz gráfica (headless)](https://seahawkmedia.com/es/desarrollo/configurar-wordpress-sin-interfaz-grafica/) con Next.js ofrece las tres. Al separar el sistema de gestión de contenido del frontend, se obtienen las ventajas de ambos mundos: la familiar experiencia de edición de WordPress y la velocidad de renderizado ultrarrápida de Next.js.

Esta guía lo guiará a través de todo el proceso, desde la comprensión de la arquitectura hasta la implementación de un sitio headless listo para producción.

Ya sea que sea un desarrollador que explora configuraciones de CMS desacopladas o un equipo que busca modernizar un sitio heredado de WordPress, este recurso paso a paso lo tiene cubierto.

**TL;DR: Crea un sitio web headless rápido y escalable**

- Utilice una configuración desacoplada para separar la gestión de contenido de la interfaz para lograr una mayor flexibilidad.

- Obtenga contenido a través de API REST o GraphQL para una entrega de datos eficiente.

- Mejore el rendimiento con generación estática, renderizado de servidor y almacenamiento en caché inteligente.

- Implemente en plataformas de alojamiento modernas y API seguras para lograr [velocidad](https://seahawkmedia.com/es/rendimiento/guia-de-optimizacion-de-velocidad-de-wordpress/), escalabilidad y protección.

## ¿Qué es Headless WordPress y por qué combinarlo con Next.js?

Para comprender el poder de esta pila, primero es necesario comprender el concepto de una arquitectura “sin cabeza” y por qué estas dos tecnologías específicas forman una pareja tan perfecta.

### Definición de la arquitectura del CMS headless de WordPress

[WordPress tradicional](https://seahawkmedia.com/es/comercio-electronico/plataformas-de-comercio-electronico-b2b-tradicionales-frente-a-wordpress-sin-interfaz-grafica/) es un sistema monolítico. Gestiona el almacenamiento de contenido, la lógica de negocio y la renderización de páginas en un solo lugar. Cuando un visitante llega a tu sitio, WordPress consulta la base de datos, procesa las plantillas PHP y entrega una página HTML completamente renderizada.

WordPress headless rompe con ese modelo. En una arquitectura headless:

- **WordPress actúa únicamente como backend.** Gestiona el contenido, la autenticación de usuarios y el almacenamiento de datos.

- **El frontend es completamente independiente.** Un framework de JavaScript como Next.js gestiona todo el renderizado y la interacción del usuario.

- **Una API conecta ambos.** WordPress expone el contenido a través de su API REST o punto final GraphQL, y Next.js obtiene esos datos para crear páginas.

El término “headless” proviene de la eliminación de la “cabeza”, la capa de presentación del frontend, de WordPress.

Tu [instalación de WordPress](https://seahawkmedia.com/es/desarrollo/como-instalar-y-configurar-tu-sitio-web-de-wordpress/) sigue existiendo, los editores siguen iniciando sesión en `/wp-admin`y las entradas se crean de la misma manera. Sin embargo, los visitantes nunca interactúan directamente con WordPress. Interactúan con tu interfaz de Next.js.

#### Lanza tu sitio web headless listo para el futuro

Lance una experiencia digital rápida, escalable y centrada en SEO impulsada por una moderna arquitectura headless.

- [Explora nuestro servicio](https://seahawkmedia.com/es/servicios/desarrollo-de-sitios-web-con-cms-sin-interfaz-grafica/)

### Beneficios de desacoplar el backend del frontend

Separar el backend de WordPress de su arquitectura frontend proporciona varias ventajas importantes:

- **Mejoras de rendimiento**: Next.js pre-renderiza las páginas como HTML estático en tiempo de compilación. No hay procesamiento PHP en cada solicitud, lo que reduce drásticamente el tiempo hasta el primer byte (TTFB).

- **Libertad en la interfaz**: Puedes reconstruir o rediseñar tu interfaz sin modificar WordPress. Cambia de framework, rediseña la distribución o ejecuta pruebas A/B sin migrar CMS.

- **Seguridad mejorada**: Tu instancia de WordPress puede ejecutarse en un servidor privado o un subdominio, oculto de internet. Los atacantes no podrán atacar `wp-login.php`si no lo encuentran.

- **Escalabilidad**: Las páginas estáticas servidas desde una [CDN](https://seahawkmedia.com/es/glosario/red-de-distribucion-de-contenido-cdn-/) gestionan los picos de tráfico sin esfuerzo. Tu servidor WordPress solo recibe solicitudes de API, no cargas de páginas.

- **Entrega de contenido multicanal**: la misma API de contenido de WordPress puede servir a un sitio web, una aplicación móvil, un asistente de voz y un quiosco simultáneamente.

- **Mejor experiencia para desarrolladores**: los equipos de frontend trabajan con herramientas React y JavaScript que ya conocen, sin tener que aprender PHP ni desarrollar temas de WordPress.

### ¿Por qué Next.js es ideal para el rendimiento y el SEO de WordPress headless?

Next.js se destaca entre los frameworks de JavaScript para proyectos CMS sin interfaz por varias razones.

- **La renderización del lado del servidor (SSR) y la generación estática de sitios (SSG)** te permiten controlar cuándo y cómo se renderizan las páginas. Puedes generar tu blog estáticamente durante la compilación, renderizar en el servidor páginas de productos que cambian con frecuencia o combinar ambas estrategias en tu sitio.

- **[La optimización de imágenes integrada](https://seahawkmedia.com/best/performance-plugins/)** mediante el `next/image` muestra automáticamente imágenes con el tamaño correcto y formato WebP mediante carga diferida. Esto mejora directamente las puntuaciones de Core Web Vitals.

- **El enrutamiento basado en archivos** simplifica las rutas dinámicas. Al crear un `[slug].js` en el directorio de páginas, se gestionan automáticamente todas las URL de las entradas del blog.

- **Las rutas API** le permiten agregar lógica del lado del servidor, como procesamiento de formularios o manejo de webhooks, directamente en su proyecto Next.js sin un backend separado.

- **[Las funciones de SEO](https://seahawkmedia.com/es/servicios/seo-tecnico/)** son nativas. Next.js renderiza el HTML completo en el servidor, por lo que los rastreadores de los motores de búsqueda reciben el contenido completo de la página sin esperar a que se ejecute JavaScript. Combinado con el `next/head,` A mantiene su sitio web competitivo en SEO.

### API REST vs GraphQL con obtención de contenido de WordPress

WordPress ofrece dos enfoques de API para configuraciones headless:

**La API REST de WordPress** viene incluida en el núcleo de WordPress. No requiere plugins adicionales. Expone los puntos finales: /wp-json/wp/v2/posts para entradas y /wp-json/wp/v2/pages para páginas. Su uso con `fetch()` y funciona bien para necesidades de contenido simples.

**WPGraphQL** es un plugin que añade un endpoint GraphQL a WordPress. En lugar de recibir un [JSON](https://seahawkmedia.com/es/mantenimiento/solucionar-el-error-de-publicacion-de-wordpress-la-respuesta-no-es-una-respuesta-json-valida/) con docenas de campos innecesarios, se escribe una consulta que solicita únicamente los campos exactos que requiere el frontend.

Esto reduce el tamaño de la carga útil, simplifica la obtención de datos anidados (por ejemplo, publicaciones con sus categorías y detalles del autor en una sola solicitud) y le brinda a su equipo de interfaz un esquema fuertemente tipado con el cual trabajar.

Para proyectos pequeños o equipos nuevos en GraphQL, la API REST es suficiente. Para sitios más grandes con relaciones de contenido complejas, WPGraphQL suele ofrecer un mejor rendimiento y una [de desarrollo](https://seahawkmedia.com/design/hire-wordpress-developers/).

## Requisitos previos para crear una configuración headless de WordPress y Next.js

Antes de escribir cualquier código, es necesario establecer una base sólida y preparar el entorno.

### Herramientas necesarias y configuración del entorno

Para continuar con una configuración headless de WordPress, necesitas tener las siguientes herramientas instaladas en tu máquina:

- **Node.js (v18 o posterior):** Descárgalo desde nodejs.org. Ejecuta `"node -v"` en tu terminal para confirmar la instalación.

- **npm o Yarn:** npm se incluye con Node.js. Yarn es opcional, pero algunos equipos lo prefieren.

- **Se requiere una instalación de WordPress en funcionamiento:** local (mediante LocalWP, MAMP o [Docker](https://seahawkmedia.com/es/seguridad/mejores-practicas-de-dockerfile/)) o en una instancia alojada. El único requisito es que sea accesible a través de HTTP.

- **Un editor de código:** [VS Code](https://code.visualstudio.com/) con las extensiones ESLint y Prettier te ofrece la mejor experiencia de desarrollo con Next.js.

- **[Git](https://seahawkmedia.com/es/desarrollo/guia-de-integracion-de-wordpress-con-github/) :** para flujos de trabajo de implementación y control de versiones.

Para el desarrollo local de WordPress, LocalWP es la forma más rápida de crear un sitio de WordPress en su máquina sin necesidad de configuración.

### Instalación de los complementos necesarios de WordPress (WPGraphQL, API REST)

La API REST de WordPress está habilitada por defecto en todas las instalaciones modernas de WordPress. Puedes comprobar su funcionamiento visitando `https://yoursite.com/wp-json/wp/v2/posts` en tu navegador.

**Para WPGraphQL:**

- Inicie sesión en su panel de WordPress.

- Navegue a **Plugins → Agregar nuevo**.

- Busque WPGraphQL e instale el complemento de Jason Bahl.

- Activarlo.

- Aparecerá un nuevo elemento de menú GraphQL en tu panel de control. Ve a **GraphQL → Configuración** para configurar el punto final.

También puedes instalar WPGraphQL para ACF si usas [Campos personalizados avanzados](https://seahawkmedia.com/es/desarrollo/campos-personalizados-avanzados/), que expone datos de campos personalizados a través de tu esquema GraphQL.

Para probar tu endpoint GraphQL, ve a **GraphQL → GraphiQL** IDE en tu panel de control. Este entorno interactivo te permite escribir y probar consultas antes de usarlas en tu proyecto Next.js.

### Configuración de la API de WordPress para la entrega sin interfaz gráfica

Varias configuraciones de WordPress afectan la entrega de API sin interfaz gráfica:

- **[Enlaces permanentes](https://seahawkmedia.com/es/desarrollo/estructura-de-enlaces-permanentes-de-wordpress/) :** Ve a **Configuración → Enlaces permanentes** y selecciona cualquier opción que no sea "Simple". La API REST no funciona correctamente con enlaces permanentes simples. "Nombre de la entrada" (`/%postname%/`) es la opción más común.

- **Encabezados CORS:** Por defecto, las respuestas de la API REST de WordPress pueden bloquear las solicitudes de origen cruzado desde tu servidor de desarrollo Next.js. Agrega encabezados CORS al archivo `functions.php` o usa un plugin como WP CORS para permitir las solicitudes desde tu dominio Next.js.

- **Contraseñas de aplicación:** Para contenido privado o borrador, WordPress admite contraseñas de aplicación (introducidas en WordPress 5.6). Genere una en su perfil de usuario e inclúyala en sus solicitudes de API como encabezado de autenticación básica.

- **Visibilidad del contenido público:** asegúrate de que las publicaciones que deseas mostrar estén publicadas, no protegidas con contraseña o sean privadas.

### Comprender los conceptos básicos de React y Next.js antes de comenzar

El desarrollo de WordPress sin interfaz gráfica con Next.js supone familiaridad con:

- **Fundamentos de React:** componentes, propiedades, estado y los `useEffect` y `useState`.

- **Métodos de representación de páginas de Next.js:** es esencial comprender la diferencia entre `getStaticProps`, `getServerSideProps` y `getStaticPaths`

- **JavaScript asíncrono:** Escribirás código para la obtención de datos asíncronos utilizando `async/await` de la API Fetch.

- **Sintaxis JSX:** cómo escribir sintaxis similar a HTML dentro de JavaScript.

Si eres nuevo en Next.js, dedicar unas horas al tutorial oficial de Next.js en nextjs.org/learn antes de comenzar este proyecto dará sus frutos.

## Guía paso a paso para conectar WordPress y Next.js

Ahora que ya tenemos la base, conectemos el [backend con el frontend](https://seahawkmedia.com/es/desarrollo/desarrollar-un-frontend-con-react-y-un-backend-con-wordpress/). Esta guía utiliza el paradigma de enrutador de páginas de Next.js, que se usa ampliamente en arquitecturas de blogs estáticos.

### Paso 1: Creación y configuración de un nuevo proyecto Next.js

Abra su terminal y cree una nueva aplicación Next.js usando la utilidad create-next-app.

```bash
npx create-next-app@latest mi-sitio-sin-cabeza cd mi-sitio-sin-cabeza
```

El asistente de configuración le preguntará si desea usar TypeScript, ESLint, Tailwind CSS y App Router. Para esta guía, elija Pages Router para obtener la máxima compatibilidad con tutoriales y plugins existentes. Se recomienda usar TypeScript para proyectos más grandes.

A continuación, crea un `.env.local` en la raíz de tu proyecto para almacenar tu URL de WordPress:

```
URL DE API PÚBLICA DE WORDPRESS NEXT=https://su-sitio-de-wordpress.com/wp-json/wp/v2 PUNTO FINAL DE WORDPRESS_GRAPHQL=https://su-sitio-de-wordpress.com/graphql
```

Nunca envíes este archivo al control de versiones. Agrega `".env.local"` a tu `archivo .gitignore`.

### Paso 2: Obtener datos de WordPress con API REST y getStaticProps

Crea un archivo en `pages/blog/index.js`. Esta página lista todas las entradas del blog obtenidas de la API REST de WordPress:

```js
exportar función predeterminada BlogIndex({ posts }) { return (<ul> {posts.map((post) => (<li key={post.id}> <a href={`/blog/${post.slug}`}>{título de la publicación.renderizado}</a></li> ))}</ul> ); } exportar función asíncrona getStaticProps() { const res = await fetch( `${process.env.NEXT_PUBLIC_WORDPRESS_API_URL}/posts?_embed&per_page=100` ); const posts = await res.json(); devolver { props: { posts }, revalidar: 60, }; }
```

`getStaticProps` se ejecuta durante la compilación en el servidor. Obtiene entradas de WordPress y las pasa como propiedades a tu componente. **Este `valor de revalidate`** `: 60` habilita la regeneración estática incremental, que se describe en la sección avanzada.

### Paso 3: Uso de WPGraphQL con Apollo o el cliente GraphQL

Para un enfoque más escalable, usa WPGraphQL. Primero, instala un cliente GraphQL ligero en tu proyecto Next.js.

```bash
npm instalar @apollo/client graphql
```

Cree un archivo de utilidad en `lib/apolloClient.js`:

```js
importar { ApolloClient, InMemoryCache } de "@apollo/client"; const cliente = nuevo ApolloClient({ uri: process.env.WORDPRESS_GRAPHQL_ENDPOINT, caché: nuevo InMemoryCache(), }); exportar cliente predeterminado;
```

Luego consulta las publicaciones de WordPress usando GraphQL en `getStaticProps`:

```js
importar cliente desde "../../lib/apolloClient"; importar { gql } desde "@apollo/client"; const GET_POSTS = gql` consulta GetPosts { publicaciones { nodos { id título slug fecha extracto featuredImage { nodo { sourceUrl altText } } } } } `; exportar función asíncrona getStaticProps() { const { datos } = await cliente. consulta({ consulta: GET_POSTS }); devolver { propiedades: { publicaciones: datos.publicaciones.nodos }, revalidar: 60, }; }
```

Este enfoque recupera solo los campos que utiliza su interfaz, lo que mantiene las respuestas de la API simplificadas.

### Paso 4: Rutas dinámicas y generación estática para páginas de blog

Para crear páginas individuales para cada entrada del blog, necesitas usar el enrutamiento dinámico. En Next.js, crea un archivo `[slug].js` dentro del directorio `pages/posts/`

Utilizará `getStaticPaths` para indicar a Next.js qué URL construir y `getStaticProps` para obtener el contenido específico de cada URL.

```js
exportar función asíncrona getStaticPaths() { const res = await fetch( `${process.env.NEXT_PUBLIC_WORDPRESS_API_URL}/posts?per_page=100` ); const posts = await res.json(); const paths = posts.map((post) => ({ parámetros: { slug: post.slug }, })); return { paths, fallback: "blocking" }; } exportar función asíncrona getStaticProps({ parámetros }) { const res = await fetch( `${process.env.NEXT_PUBLIC_WORDPRESS_API_URL}/posts?slug=${params.slug}&_embed` ); const posts = await res.json(); if (!posts.length) { return { notFound: true }; } return { props: { post: posts[0] }, revalidar: 60, }; }
```

`getStaticPaths` le indica a Next.js qué slugs debe pre-renderizar. Al establecer `fallback: "blocking"`, cualquier slug que no esté en la compilación inicial se renderizará en el servidor en la primera solicitud y luego se almacenará en caché como una página estática.

### Paso 5: Manejo del contenido de las publicaciones, imágenes y campos personalizados

WordPress almacena [el contenido del cuerpo de las publicaciones](https://seahawkmedia.com/es/marketing/estrategia-de-contenido-para-sitios-web-de-wordpress/) como HTML sin procesar. Renderícelo de forma segura utilizando `dangerouslySetInnerHTML`:

```html
<div dangerouslySetInnerHTML={{ __html: post.content.rendered }} />
```

Para las imágenes destacadas, utilice el `_embed` en las solicitudes de la API REST. Acceda a la URL de la imagen a través de `post._embedded['wp:featuredmedia'][0].source_url`.

Envuélvalo con `Image` para una optimización automática:

```
importar imagen desde "next/image"; <Image src={post._embedded["wp:featuredmedia"][0].source_url} alt={post.title.rendered} width={1200} height={630} />
```

Para campos personalizados avanzados, active el complemento WPGraphQL para ACF. Los datos de los campos personalizados aparecen en su esquema GraphQL y pueden consultarse junto con los datos estándar de las entradas.

## Técnicas avanzadas para WordPress sin interfaz gráfica y Next.js

Una vez que los conceptos básicos estén funcionando, puede implementar funciones avanzadas para que su sitio se sienta como una aplicación de nivel empresarial.

### Optimizar con regeneración estática incremental (ISR)

ISR te permite actualizar páginas generadas estáticamente tras la implementación sin tener que reconstruir todo el sitio. La configuración depende del enrutador Next.js que uses, y confundirlos es una causa común de errores.

#### Páginas Router ISR (basado en tiempo)

Agregue un valor `de revalidación` (en segundos) a su retorno `getStaticProps`:

```css
return { props: { post }, revalidate: 300, // Regenerar cada 5 minutos };
```

Cuando un usuario visita una página después de que expire el período de revalidación, Next.js sirve la página almacenada en caché inmediatamente mientras la regenera en segundo plano. El siguiente visitante recibe la versión actualizada.

#### Enrutador de páginas ISR (bajo demanda)

Para la revalidación bajo demanda activada por un evento de publicación o actualización de WordPress, cree una ruta API en `pages/api/revalidate.js`. WordPress llama a esta ruta mediante un webhook:

```js
exportar función asíncrona predeterminada manejador(req, res) { if (req.query.secret !== process.env.REVALIDATION_SECRET) { return res.status(401).json({ message: "Token inválido" }); } const slug = req.query.slug; try { await res.revalidate(`/blog/${slug}`); return res.json({ revalidado: verdadero }); } catch (err) { return res.status(500).send("Error al revalidar"); } }
```

`res.revalidate()` es el método correcto de Pages Router. Activa una regeneración inmediata en segundo plano para esa ruta específica sin esperar a que expire el período de tiempo.

#### Enrutador de aplicaciones ISR

Si utiliza el enrutador de aplicaciones (`app/`) en lugar del enrutador de páginas, la sintaxis es diferente. La revalidación basada en tiempo se configura como una exportación de configuración de segmento de ruta:

```js
// aplicación/blog/[slug]/page.js exportar const revalidar = 300;
```

La revalidación a pedido en App Router utiliza `revalidatePath()` o `revalidateTag()`, importados desde `next/cache`, dentro de una acción de servidor o un controlador de ruta, no dentro de una ruta API:

```js
// app/api/revalidate/route.js (Controlador de rutas del enrutador de aplicaciones) importar { revalidatePath } desde "next/cache"; importar { NextResponse } desde "next/server"; exportar función asíncrona POST(solicitud) { const { slug, secreto } = await request.json(); si (secreto !== proceso.env.REVALIDATION_SECRET) { devolver NextResponse.json({ mensaje: "Token inválido" }, { estado: 401 }); } revalidatePath(`/blog/${slug}`); devolver NextResponse.json({ revalidado: verdadero }); }
```

>

**Distinción clave:** ``res.revalidate()`` pertenece al enrutador de páginas. ``revalidatePath()`` y ``revalidateTag()`` pertenecen al enrutador de aplicaciones. Usar métodos del enrutador de aplicaciones dentro de un proyecto de enrutador de páginas, o viceversa, provocará fallos silenciosos o errores en tiempo de ejecución. Asegúrese de que el método corresponda al enrutador que esté utilizando.

Esta guía, en su sección paso a paso, utiliza el Enrutador de Páginas en todo momento. Si en el futuro migra al Enrutador de Aplicaciones, actualice toda la lógica de las rutinas de servicio de interrupción (ISR) para que utilicen `la función revalidatePath()` en los manejadores de rutas.

### Agregar modo de vista previa para contenido borrador

El modo de vista previa permite a los editores ver el borrador del contenido de WordPress en la interfaz de Next.js antes de publicarlo. Configura dos rutas de API:

- `/api/preview`: habilita el modo de vista previa y redirecciona a la publicación.

- `/api/exit-preview`: deshabilita el modo de vista previa.

En tu tema o plugin de WordPress, configura el **de URL de vista previa** (si utilizas la autenticación JWT de WPGraphQL) para que apunte a `https://your-nextjs-site.com/api/preview?secret=YOUR_SECRET&slug={slug}`.

En `getStaticProps`, verifique el modo de vista previa y obtenga el contenido del borrador:

```js
exportar función asíncrona getStaticProps({params, preview, previewData}) { const authHeader = preview? { Autorización: `Bearer ${previewData.token}` } : {}; const res = await fetch( `${process.env.NEXT_PUBLIC_WORDPRESS_API_URL}/posts?slug=${params.slug}&status=draft`, { headers: authHeader } ); // ... }
```

### Creación de mapas de sitio y metadatos SEO en Next.js

Instale el paquete `next-sitemap` para la generación automática de mapas del sitio:

```bash
npm instalar next-sitemap
```

Crea un `next-sitemap.config.js` y configúralo para que incluya todos los slugs de las entradas de WordPress obtenidos durante la compilación. Ejecuta `next-sitemap` como un script posterior a la compilación en tu `package.json`.

Para los metadatos SEO por página, utilice el `next/head` o, si utiliza App Router, la API de metadatos incorporada:

```
importar Head desde "next/head";<Head><title> {post.title.rendered} | Mi blog </title><meta name="description" content="{extracto de la publicación renderizado}" /><meta property="og:title" content="{título de la publicación.renderizado}" /><meta property="og:image" content={featuredImageUrl} /></Head>
```

Usa el plugin RankMath en WordPress y expone sus metadatos a través de WPGraphQL con el plugin Add WPGraphQL SEO. Esto permite a los editores controlar los títulos y las descripciones desde WordPress, que Next.js obtiene y renderiza.

**Leer más:** [Usar WordPress como un CMS sin interfaz gráfica](https://seahawkmedia.com/es/desarrollo/usar-wordpress-como-un-cms-sin-interfaz-grafica/)

### Estrategias de almacenamiento en caché y SWR para la obtención del lado del cliente

No es necesario generar todo el contenido estáticamente. Los datos específicos del usuario, los comentarios o el inventario en tiempo real se benefician de la obtención del lado del cliente. Utilice la `swr` de Vercel:

```bash
npm instalar swr
```

```js
importar useSWR de "swr"; const fetcher = (url) => fetch(url).then((r) => r.json()); función Comentarios({ postId }) { const { datos, error } = useSWR( `/wp-json/wp/v2/comments?post=${postId}`, fetcher ); si (error) devolver<p> Error al cargar los comentarios.</p> ; si (!datos) devuelve<p> Cargando...</p> ; devolver<ul> {datos.map((c) =><li key={c.id}> {c.contenido.renderizado}</li> )}</ul> ; }
```

SWR gestiona automáticamente el almacenamiento en caché, la revalidación y la deduplicación. Utiliza una estrategia de revalidación de datos obsoletos: devuelve los datos almacenados en caché inmediatamente y luego recupera datos actualizados de forma silenciosa en segundo plano.

## Prácticas recomendadas de implementación, rendimiento y seguridad para WordPress con Next.js

Implementa tu frontend de Next.js y el backend de WordPress como servicios separados. Esta separación es una de las principales ventajas del modelo headless.

**La implementación de Next.js** funciona mejor en Vercel, la plataforma desarrollada por el equipo de Next.js. Vercel gestiona la ISR, [el almacenamiento en caché perimetral](https://seahawkmedia.com/es/rendimiento/almacenamiento-en-cache-en-el-borde/), la optimización de imágenes y la gestión de variables de entorno de forma inmediata.

Netlify y AWS Amplify son alternativas sólidas. Para implementaciones autoalojadas, ejecute Next.js con `npm run build && npm start` detrás de un proxy inverso Nginx.

**La implementación de WordPress** puede realizarse en cualquier host PHP estándar ( [WP Engine](https://wpengine.com/partnerspecialoffer/?w_agcid=fs0jWoRL), [Kinsta](https://kinsta.com/?kaid=CSOCNDKBYAAR), [SiteGround](https://www.siteground.com/index.htm?afcode=b363d485890e851bb337f546c214cb74)) o en un VPS. Dado que WordPress solo procesa respuestas de API (no páginas vistas), incluso un hosting modesto gestiona un tráfico considerable.

**Refuerzo de seguridad** para WordPress headless:

- Mueva su instalación de WordPress a un subdominio no público como `cms.yourdomain.com`.

- Deshabilitar XML-RPC (`add_filter('xmlrpc_enabled', '__return_false');`).

- Utilice un [firewall de aplicaciones web (WAF)](https://seahawkmedia.com/es/seguridad/guia-de-configuracion-del-firewall-de-aplicaciones-web-para-wordpress/) como Cloudflare.

- Restrinja la API REST de WordPress a solicitudes autenticadas para puntos finales sensibles.

- Mantenga el núcleo, los temas y los complementos de WordPress actualizados.

- Utilice contraseñas de aplicación seguras para la autenticación de API.

**para optimizar el rendimiento**:

- Habilite la entrega de CDN para sus activos estáticos de Next.js.

- Utilice `next/image` para todas las imágenes, [genera tamaños adaptables](https://seahawkmedia.com/es/rendimiento/optimizar-el-tamano-de-las-imagenes/) y sirve WebP automáticamente.

- Minimice el JavaScript del lado del cliente manteniendo los componentes renderizados en el servidor siempre que sea posible.

- Establezca encabezados de caché HTTP apropiados en las respuestas de la API de WordPress.

- Utilice un caché de objetos de WordPress (Redis o [Memcached](https://seahawkmedia.com/es/rendimiento/wordpress-memcached-como-usarlo/)) para acelerar las consultas de base de datos detrás de su API.

## Solución de problemas comunes en WordPress con la configuración headless de Next.js

La transición a una configuración headless es gratificante, pero conlleva una curva de aprendizaje. Estos son los obstáculos más comunes y cómo solucionarlos:

- **[Errores de CORS](https://seahawkmedia.com/es/mantenimiento/corregir-error-cors/) en desarrollo:** Tu navegador bloquea las solicitudes de origen cruzado desde `localhost:3000` a tu dominio de WordPress. Agrega encabezados CORS a WordPress mediante `functions.php` o usa el plugin WP CORS. Permite orígenes para tus dominios Next.js de desarrollo y producción.

- **[Los enlaces permanentes devuelven un error 404](https://seahawkmedia.com/maintenance/what-are-404-errors-how-do-i-fix-them/) :** La API REST requiere enlaces permanentes que no sean simples. Vaya a **Configuración → Enlaces permanentes** y guarde cualquier opción que no sea simple, incluso si no realiza ningún cambio. Esto borra las reglas de reescritura.

- **Imágenes de WordPress bloqueadas por Next.js:** Next.js restringe el acceso a dominios de imágenes externos por razones de seguridad. Añade tu dominio de WordPress a `next.config.js`:

```
módulo.exportaciones = { imágenes: { dominios: ["tu-sitio-de-wordpress.com"], }, };
```

- **Entidades HTML en el contenido renderizado:** La API REST de WordPress devuelve títulos con entidades HTML como `&`. Usa una pequeña utilidad para decodificarlas o instala el paquete npm `html-entities`

- **La compilación falla debido a un exceso de solicitudes a la API:** si tienes miles de publicaciones, obtener todos los slugs en `getStaticPaths` puede agotar el tiempo de espera o alcanzar los límites de solicitudes. Pagina tus solicitudes usando los `page` y `per_page`, o usa `fallback: "blocking"` y pre-renderiza solo tus publicaciones más recientes.

- **Errores de esquema de GraphQL tras actualizar plugins:** El esquema de WPGraphQL cambia al añadir o eliminar plugins. Regenera la caché del cliente Apollo o borra la instantánea del esquema local tras los cambios en los plugins de WordPress.

- **Borradores que aparecen en producción:** Si usas `status=any` en tus consultas de API durante el desarrollo, asegúrate de que las consultas de producción solo soliciten `status=publish`. Usa parámetros de API específicos del entorno para evitar que los borradores se publiquen.

## Conclusión

El uso de WordPress con Next.js le brinda una arquitectura headless escalable y optimizada para SEO que supera al WordPress tradicional en casi todas las métricas.

Su equipo de contenido mantiene el editor familiar de WordPress mientras su equipo de desarrollo construye con herramientas modernas de React.

La configuración se basa en tres componentes: WordPress como [CMS sin interfaz](https://seahawkmedia.com/es/servicios/desarrollo-de-sitios-web-con-cms-sin-interfaz-grafica/), la API REST o WPGraphQL como capa de datos y Next.js, que maneja toda la renderización del frontend y la optimización del rendimiento.

Comienza con la API REST, adopta WPGraphQL a medida que aumenta la complejidad y luego incorpora ISR, modo de vista previa y revalidación bajo demanda a medida que tu sitio web madura. Implementa tu frontend de Next.js en Vercel y WordPress en un host PHP dedicado para una separación limpia y lista para producción.

Esta combinación ya no es experimental. Impulsa las principales plataformas de publicación, sitios de comercio electrónico y aplicaciones empresariales. Las herramientas son sólidas, la comunidad es activa y las mejoras de rendimiento son tangibles. Ahora es el momento ideal para desarrollar.

## Preguntas frecuentes sobre WordPress con Next.js para un sitio headless

¿Por qué debería usar WordPress con Next.js para un sitio web headless?

WordPress gestiona el contenido fácilmente, mientras que Next.js gestiona el frontend con rapidez y flexibilidad. Esta configuración mejora el rendimiento, el SEO y la escalabilidad. Además, permite a los desarrolladores crear interfaces modernas basadas en React sin limitar los editores de contenido.

¿Debería usar REST API o WPGraphQL con WordPress y Next.js?

Ambas funcionan bien. La API REST es sencilla e integrada en WordPress. WPGraphQL ofrece una obtención de datos más precisa y reduce la sobrecaptación. Elija según la complejidad del proyecto y las preferencias del desarrollador

¿WordPress con Next.js mejora el SEO?

Sí. Next.js admite la renderización del lado del servidor y la generación estática. Estas funciones facilitan el rastreo del contenido por parte de los motores de búsqueda. También permite controlar metadatos, datos estructurados y mapas de sitio de forma más eficaz.

¿Puedo usar complementos con una configuración headless de WordPress?

Puedes usar plugins relacionados con el contenido, como SEO, campos personalizados y herramientas de seguridad. Sin embargo, los plugins enfocados en el frontend no funcionarán, ya que Next.js controla la capa de presentación.

¿Es WordPress con Next.js adecuado para sitios web grandes?

Sí. Escala bien si se configura correctamente. Utiliza el almacenamiento en caché, la regeneración estática incremental y la integración con CDN para gestionar eficientemente el tráfico intenso y los grandes volúmenes de contenido.

WP Services

## WordPress services at revolutionary pricing.

Productized WordPress services, from builds to care, delivered by Seahawk and tracked in one app. For the WordPress lovers.

[Go to WP Services](https://wpservices.com/) [Free homepage rebuild](https://seahawkmedia.com/free-homepage-rebuild/)
