acai/acai-scaffold
6
0
Fork 0
Code Issues Pull Requests 3 Actions Packages Projects Releases Wiki Activity

docs: corrige API de hooks, documenta modelo de ejecucion/plugins y aviso de fiabilidad del MCP #1

Open
DavidSosa wants to merge 2 commits from docs/fix-hooks-api-y-avisos-mcp into main
pull from: docs/fix-hooks-api-y-avisos-mcp
merge into: :main
Conversation 0 Commits 2 Files Changed 3
+17 -1
2 changed files with 17 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files
Showing only changes of commit 9565b4410b - Show all commits
CLAUDE.md
+1 -1
View File
@@ -148,7 +148,7 @@ Key workflows:
- [docs/modular-system.md](docs/modular-system.md) — Modules, general sections, global variables - [docs/modular-system.md](docs/modular-system.md) — Modules, general sections, global variables
- [docs/builder-fields.md](docs/builder-fields.md) — Builder field types, Acai attributes, c-form, components - [docs/builder-fields.md](docs/builder-fields.md) — Builder field types, Acai attributes, c-form, components
- [docs/twig-filters.md](docs/twig-filters.md) — Twig filters reference (get, hook, module, queryDB, etc.) - [docs/twig-filters.md](docs/twig-filters.md) — Twig filters reference (get, hook, module, queryDB, etc.)
- [docs/hooks-and-api.md](docs/hooks-and-api.md) — PHP hooks, CmsApi, CocoDB, record creation - [docs/hooks-and-api.md](docs/hooks-and-api.md) — PHP hooks, CmsApi, CocoDB, record creation, custom CMS plugins (checkPoints)
- [docs/css-js-conventions.md](docs/css-js-conventions.md) — CSS/JS/Vue 3, Tailwind, BEM, native components - [docs/css-js-conventions.md](docs/css-js-conventions.md) — CSS/JS/Vue 3, Tailwind, BEM, native components
- [docs/quick-reference.md](docs/quick-reference.md) — Cheat sheet: domain rules, field types, filters - [docs/quick-reference.md](docs/quick-reference.md) — Cheat sheet: domain rules, field types, filters
- [docs/production-patterns.md](docs/production-patterns.md) — Real production patterns (header, zigzag, FAQ, forms) - [docs/production-patterns.md](docs/production-patterns.md) — Real production patterns (header, zigzag, FAQ, forms)
docs/hooks-and-api.md
+16
View File
@@ -152,6 +152,22 @@ datos correctos y sin error visible).
--- ---
## Plugins CMS personalizados (checkPoints)
Para entender **cómo despacha el CMS un plugin custom** (no confundir con hooks de módulo), lee primero
`cms/lib/plugins/index.php` **de ese proyecto** — no hace falta explorar el servidor por SSH ni el
código de `web-base`, el contrato completo está ahí:
- `addPlugins($type, &$var, $fieldtype)` despacha los checkPoints con `include` (no clases/autoload).
- Gating nativo por `adminOnly` + `isAdmin` — un checkPoint puede declararse solo-admin.
- `$var` se pasa **por referencia** — un plugin puede mutar el valor que ven los siguientes.
- Filtros `menuFilter`/`actionFilter` por tabla/action, para que un plugin solo se dispare donde aplica.
- `newFieldType` para registrar tipos de campo nuevos del builder.
- La instalación de un plugin va vía `install.sql` + `schemaPresets` — **no** `schemas/` (ese es el
sistema viejo de `seo_toolkit`, con el `install.php` comentado; no lo repliques).
---
## CmsApi (PHP) ## CmsApi (PHP)
API server-side para operaciones de base de datos. Disponible en todos los hooks. API server-side para operaciones de base de datos. Disponible en todos los hooks.