Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/guilherme-mandeli/wp-hooma-core/archive/refs/heads/main.zipNo built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Hooma Core es un framework de infraestructura ligero (Thin Core) y contenedor de servicios para el desarrollo y gestion de modulos de negocio desacoplados en WordPress.
Filosofia y Proposito
Hooma Core existe para solucionar la fragmentacion, el acoplamiento rigido y la falta de testabilidad en desarrollos de gran escala sobre WordPress.
Resuelve tres problemas especificos:
- Acoplamiento rigido: Sustituye las llamadas directas entre componentes por comunicacion basada en un bus de eventos y filtros desacoplados.
- Ruido de administracion: Evita la proliferacion de decenas de plugins independientes en el panel de WordPress, centralizando los modulos en un gestor unificado fuera de la ruta plugins/.
- Dependencia de APIs legacy: Abstrae las funciones globales de WordPress (como transients, wp_remote o cron) en interfaces limpias, estandarizadas y testeables mediante inyeccion de dependencias perezosa.
Requisitos
- PHP 8.0 o superior
- WordPress 6.0 o superior
Características principales
- Contenedor de servicios con carga diferida (lazy load).
- Autocargador PSR-4 nativo para el núcleo y módulos.
- Sistema de descubrimiento y ciclo de vida de módulos fuera de la carpeta de plugins tradicional.
- Sistema de Packages para centralizar recursos comunes de infraestructura (Vue, Alpine, Stripe SDK, etc.) de forma inmutable y desacoplada.
- Descubrimiento automático de Documentación y Demos: Escaneo dinámico de múltiples carpetas de documentación (
docs,documentation,documents,manual,guide,guides,wiki,help) y pestañas de demostración (demo,demos,example,examples,sample,samples,playground,preview,showcase) con ejecución eniframe. - Normalizador de Slugs a Títulos (Slug Title Normalization): Conversión conservadora de nombres de archivo y slugs a frases legibles en la interfaz, conservando prefijos numéricos de orden y acrónimos técnicos (
API,AI,UI,UX,WordPress,GA4,WP,JS,TS,PHP,HTML,CSS, etc.). - Abstracción de APIs críticas de WordPress (base de datos, caché, peticiones HTTP, cron y eventos).
Estructura del proyecto
- admin/: Controlador y tablas de la interfaz de administracion de modulos.
- assets/: Recursos estaticos del framework.
- config/: Definicion de constantes globales del core.
- docs/: Documentacion oficial y manual tecnico.
- includes/: Infraestructura del nucleo, fachada principal, instalador y cargador.
- services/: Servicios desacoplados de infraestructura del sistema.
Instalacion y Carga de Modulos
- Instalar y activar Hooma Core como un plugin estandar de WordPress.
- Los modulos de desarrollo y negocio deben ubicarse en la ruta
wp-content/uploads/hooma/modules/. - Administrar el estado de activacion de los modulos desde el panel administrativo de Hooma en el escritorio de WordPress.
Guia de Documentacion y Ejemplos
Toda la documentacion técnica detallada esta estructurada de forma relativa dentro del directorio docs/:
Conceptos e Inicio
- Indice del Manual: Estructura general de aprendizaje.
- Preguntas Frecuentes (FAQ): Dudas de diseño, rendimiento y compatibilidad con WordPress.
- Conceptos del Framework: Explicacion del Thin Core y las fronteras de desarrollo.
- Sistema de Packages: Documentación y especificaciones técnicas de la infraestructura de paquetes reutilizables.
Desarrollo de Modulos
- Guia de Desarrollo de Modulos: Estructura de archivos, cabeceras de metadatos y namespaces.
- Buenas Practicas: Reglas de diseño y limites de acoplamiento.
- Anti-Patrones: Tabla comparativa de sustitucion de llamadas nativas de WordPress.
Referencias Tecnicas
- Referencia de la API: Detalle de firmas de metodos, excepciones y retornos de los 11 servicios principales.
- Decision Records (ADR): Registro historico de decisiones de arquitectura tomadas en el framework.
Tutoriales y Ejemplos
- Tutoriales Progresivos: Curso estructurado de 11 capitulos para construir un modulo desde cero.
- Cookbook (Recetario): Coleccion de 10 soluciones de codigo listas para copiar y pegar en casos de uso reales.
- Modulos de Ejemplo: Plantillas estaticas de modulos listas para analizar y clonar.