WP Manifestindependent plugin directory
manifest / developer / bridgeframe

Bridgeframe

Plugin WordPress headless con API REST, ACF y documentación del contrato GFrame.

by Juank de Gorvet · github.com/gorvet/bridgeframe · website

★ 0stars
0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/gorvet/bridgeframe/archive/refs/heads/main.zip
Readme github.com/gorvet/bridgeframe ↗

Bridgeframe convierte WordPress en una API headless para consumir contenido, taxonomías, menús y esquemas desde interfaces externas. Incluye creación, consulta y moderación de comentarios autenticadas.

La versión 2.1.0 implementa el contrato 2.0 de Bridgeframe en bridgeframe/v2. Cualquier aplicación puede consumir la API siguiendo su contrato y guía de migración.

Características

  • Autenticación Bearer con credenciales por consumidor, scopes, caducidad, rotación y revocación.
  • Endpoints de lectura para contenido, listados, términos y menús.
  • Soporte de lectura para ACF.
  • Caché configurable.
  • CORS configurable.
  • Modo headless opcional para bloquear el frontend público.
  • Endpoint de esquema para descubrir tipos, taxonomías, tamaños de imagen y ACF.

Instalación

  1. Copia el plugin en wp-content/plugins/.
  2. Actívalo desde WordPress.
  3. Ve a Ajustes > Bridgeframe.
  4. Crea una credencial de consumidor y copia el token mostrado una sola vez.
  5. Configura caché, CORS y modo headless si lo necesitas.

Endpoints

Base:

/wp-json/bridgeframe/v2

Disponibles:

  • GET /html
  • GET /list
  • GET /terms
  • GET /menu
  • GET /schema
  • GET /comments
  • POST /comments
  • POST /comments/{id}/moderate

Documentación

La guía completa está en:

Acceso

La API v2 exige Authorization: Bearer. Para lectura normal usa content.read; para incluir contenido privado añade private.read. Los comentarios requieren comments.write o comments.moderate. Usa HTTPS y conserva las credenciales en el backend. Se admiten 120 solicitudes por consumidor y minuto.

Integración con GFrame

El framework GFrame incluye GFrame\Headless\WordPressClient, un consumidor compatible con el contrato de Bridgeframe. Esta integración es opcional; la API también puede consumirse desde otros frameworks o clientes HTTP.

WORDPRESS_HEADLESS_URL="https://cms.example.com"
WORDPRESS_HEADLESS_TOKEN="credencial-del-consumidor"
$wordpress = \GFrame\Headless\WordPressClient::fromEnvironment();
$result = $wordpress->content('mi-articulo', 'post');

Verificación

En una instalación de prueba con el plugin activo:

php tests/integration.php /ruta/wordpress/wp-load.php /ruta/gframe-framework

La prueba crea y elimina sus contenidos y consumidores temporales. Comprueba los cinco endpoints de lectura, comentarios, permisos, caché, migración, rotación, caducidad, revocación, rate limiting y las respuestas con el cliente real de GFrame. No verifica el transporte HTTPS mediante red.

Requisitos

  • WordPress 6.9.4+
  • PHP 8.1+
  • ACF opcional

Licencia

GPL v2 o superior.