WP API Codeia

Plugin de WordPress que convierte una instalación en una API personalizada configurable desde un dashboard propio. El administrador elige qué tipos de contenido se exponen, qué campos de cada uno, con qué autenticación y bajo qué permisos; el plugin deriva de esa configuración los endpoints REST, la documentación OpenAPI y las reglas de acceso.

La premisa que lo diferencia de escribir endpoints a mano: el esquema no se declara, se descubre. El plugin introspecciona la instalación —tipos de contenido, taxonomías y campos personalizados de ACF, JetEngine, Meta Box o register_meta— y presenta el resultado como catálogo configurable.

Estado: fase de diseño. La arquitectura está documentada por completo; todavía no hay código de plugin. Lo descrito abajo es el diseño acordado, no funcionalidad disponible.

Requisitos

• WordPress: 7.1 o superior
• PHP: 8.0 o superior
• Composer: autoloading PSR-4
• Node.js: solo para desarrollar el dashboard React — no hace falta para usar el plugin

Instalación

cd wp-content/plugins/
git clone <url-del-repositorio> wp-api-codeia

Después actívalo desde Escritorio → Plugins en el administrador de WordPress.

Capacidades previstas

API REST

Ruta canónica, siempre disponible:

/wp-json/codeia/v1/{post_type}
/wp-json/codeia/v1/{post_type}/{id}

El segmento codeia es configurable desde el dashboard; codeia/v1 es el valor por defecto.

Opcionalmente, un alias en raíz (/codeia/v1/{post_type}) sirve la misma API fuera de /wp-json/ mediante rewrite rules. Está desactivado por defecto y requiere enlaces permanentes activos.

Endpoints por recurso expuesto

Las operaciones no habilitadas no se registran: responden 404, no 403.

Endpoints del sistema

Documentación

Diseño técnico completo en docs/. Empieza por el documento principal:

Desarrollo

Los comandos siguientes describen el flujo previsto. Todavía no son ejecutables: no existe composer.json ni admin-ui/.

composer install

cd admin-ui && npm install
npm run dev            # desarrollo con HMR
npm run build          # producción → assets/admin/

./vendor/bin/phpunit
./vendor/bin/phpcs --standard=WordPress src/

• El código seguirá los WordPress Coding Standards.
• .editorconfig aplica tabuladores en PHP/JS/CSS y finales de línea LF. Activa el soporte de EditorConfig en tu editor.
• Namespace PHP WpApi\Codeia con autoloading PSR-4 sobre src/.
• El dashboard usa React 18 + Vite sobre @wordpress/components, con React externalizado a wp-element. Los assets construidos en assets/admin/ se versionan, para que el plugin funcione desde un clon sin Node.
• Cada ruta REST declara un permission_callback explícito. Nunca '__return_true'.
• CLAUDE.md reúne el contexto del proyecto y las reglas no obvias del diseño.

Changelog

Los cambios notables se documentan en CHANGELOG.md, siguiendo Keep a Changelog y Semantic Versioning.

Licencia

GPL-2.0-or-later