Guía completa para usar WordPress como CMS headless: ventajas, características y trabajo con la API REST de WP

WordPress, que comenzó como una plataforma de gestión de contenidos, ha experimentado una evolución significativa. Hoy no solo gestiona sitios web en el formato tradicional, sino que también puede funcionar con una arquitectura headless, sirviendo únicamente como sistema backend para la gestión de contenidos. En este artículo, exploraremos las principales ventajas de utilizar WordPress como backend, su integración con frameworks de frontend modernos y los detalles del trabajo con la API REST de WP para una interacción eficiente con los datos.

¿Qué es WordPress headless?

WordPress headless es un enfoque en el que el frontend y el backend están desacoplados. WordPress gestiona el contenido en el backend, mientras que la renderización del frontend y las interacciones de los usuarios se gestionan mediante sistemas independientes como React, Vue.js o Angular. Esto permite a los desarrolladores crear interfaces de usuario más flexibles utilizando las tecnologías web más recientes.

Principales ventajas de usar WordPress headless:

Flexibilidad del frontend. Los desarrolladores pueden utilizar cualquier framework moderno para crear interfaces de usuario. Esto resulta especialmente útil para crear aplicaciones complejas como SPA (aplicaciones de una sola página) y PWA (aplicaciones web progresivas).
Mejora del rendimiento. Separar la lógica del frontend reduce la carga en los servidores de WordPress, acelerando los tiempos de carga de las páginas.
Escalabilidad. Un único backend de WordPress puede servir a múltiples aplicaciones frontend, como sitios web, aplicaciones móviles y otros dispositivos.

Ventajas de utilizar WordPress como backend

WordPress como sistema backend en una arquitectura headless proporciona varias ventajas importantes para el desarrollo.

1. Facilidad de gestión de contenidos

Los usuarios continúan trabajando en el conocido panel de control de WordPress, publicando y actualizando contenido sin necesidad de profundizar en detalles técnicos. Esto resulta especialmente útil para equipos en los que el contenido es gestionado por usuarios no técnicos.

2. Amplio ecosistema de plugins

WordPress cuenta con uno de los ecosistemas de plugins más ricos. Los plugins se pueden utilizar para SEO, seguridad, integración con redes sociales e incluso para simplificar el trabajo con API. Esto acelera el desarrollo y amplía la funcionalidad de WordPress sin necesidad de escribir código personalizado.

3. Alta escalabilidad

WordPress se integra fácilmente con otros sistemas y aplicaciones. Su API permite distribuir contenido a través de múltiples canales: aplicaciones web, aplicaciones móviles y dispositivos IoT. Esto convierte a WordPress en una solución versátil para empresas que necesitan una gestión centralizada de contenidos en diversas plataformas.

4. Soporte y comunidad

WordPress cuenta con el respaldo de millones de desarrolladores y entusiastas de todo el mundo. Esto garantiza la disponibilidad de documentación, foros y soluciones para casi cualquier tarea, reduciendo el tiempo y los costes de desarrollo.

Trabajo con la API REST de WP

La API REST de WP es una interfaz que permite interactuar con WordPress mediante solicitudes HTTP. Es una de las herramientas fundamentales de la arquitectura headless, ya que permite consultar, actualizar y eliminar datos en el backend mientras se muestran en cualquier framework de frontend.

Principales endpoints de la API REST de WP

Entradas: /wp-json/wp/v2/posts
Páginas: /wp-json/wp/v2/pages
Categorías: /wp-json/wp/v2/categories
Medios: /wp-json/wp/v2/media
Usuarios: /wp-json/wp/v2/users
Comentarios: /wp-json/wp/v2/comments

1. Obtención de datos con la API REST de WP

Ejemplo de obtención de una lista de entradas

GET https://example.com/wp-json/wp/v2/posts

La respuesta estará en formato JSON y puede incluir datos como el ID de la entrada, el título, el contenido y el extracto:

[
  {
    "id": 1,
    "title": {
      "rendered": "Post Title"
    },
    "content": {
      "rendered": "Post content."
    },
    "excerpt": {
      "rendered": "Post excerpt."
    }
  },
  ...
]

Filtrado y paginación

La API REST admite el filtrado de datos mediante parámetros de URL:

?per_page=5 — limita el número de entradas por página.
?page=2 — obtiene la segunda página de resultados.
?orderby=date&order=asc — ordena las entradas por fecha en orden ascendente.

GET https://example.com/wp-json/wp/v2/posts?per_page=5&page=2

2. Obtención de una entrada específica por ID

GET https://example.com/wp-json/wp/v2/posts/1

Esta solicitud devolverá la entrada con el ID 1, incluidos su título, contenido y otros campos.

3. Obtención de una lista de categorías

GET https://example.com/wp-json/wp/v2/categories

La respuesta incluirá la lista de categorías, sus ID, nombres y descripciones.

Creación y actualización de datos con la API REST de WP

1. Creación de una nueva entrada

Para crear una nueva entrada, utilice el método POST :

POST https://example.com/wp-json/wp/v2/posts

El cuerpo de la solicitud podría tener este aspecto:

{
  "title": "New Post",
  "content": "Content of the new post",
  "status": "publish"
}

La respuesta contendrá el ID de la nueva entrada y sus datos.

2. Actualización de una entrada existente

Para modificar una entrada existente, utilice el método PUT :

PUT https://example.com/wp-json/wp/v2/posts/15

Cuerpo de la solicitud:

{
  "title": "Updated Title"
}

3. Eliminación de una entrada

Para eliminar una entrada, envíe una solicitud DELETE :

DELETE https://example.com/wp-json/wp/v2/posts/15

Autenticación en la API REST de WP

Para operaciones como crear o eliminar datos, se requiere autenticación. WordPress admite varios métodos de autenticación:

Basic Auth. Un método sencillo para pruebas, en el que el nombre de usuario y la contraseña se envían en la cabecera de la solicitud.
OAuth. Adecuado para aplicaciones más complejas que requieren una transmisión segura de datos.
JWT (JSON Web Tokens). Un método de autenticación moderno y seguro utilizado habitualmente en aplicaciones con API.

Ejemplo de uso de Basic Auth

Instale el plugin Basic Auth y actívelo mediante el panel de administración de WordPress. Después, podrá enviar solicitudes HTTP con una cabecera de autenticación.

Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=

Trabajo con endpoints personalizados en la API REST de WP

Si las rutas estándar de la API REST no satisfacen las necesidades de su proyecto, puede crear endpoints personalizados mediante el hook register_rest_route .

Ejemplo de creación de un endpoint personalizado:

add_action( 'rest_api_init', function () {
  register_rest_route( 'myplugin/v1', '/custom-data/', array(
    'methods' => 'GET',
    'callback' => 'my_custom_data_callback',
  ) );
} );

function my_custom_data_callback( $data ) {
  return new WP_REST_Response( array( 'message' => 'Hello World!' ), 200 );
}

Ahora, en la URL https://example.com/wp-json/myplugin/v1/custom-data/, la ruta personalizada devolverá el mensaje «¡Hola, mundo!».

Conclusión

WordPress como CMS headless ofrece una potente plataforma para crear soluciones flexibles, de alto rendimiento y escalables. Mediante la API REST de WP, los desarrolladores pueden integrar fácilmente WordPress con tecnologías de frontend modernas, mientras que la flexibilidad del sistema permite trabajar con rutas personalizadas y ampliar la funcionalidad. Este enfoque abre infinitas posibilidades para integrar WordPress en diversos proyectos, desde blogs sencillos hasta complejas aplicaciones web y móviles.