From ff82283b8ee358fac384bc3326b4a0844a3fef6f Mon Sep 17 00:00:00 2001 From: Jordan Date: Fri, 27 Mar 2026 14:27:03 +0000 Subject: [PATCH] Update builder-fields.md --- docs/builder-fields.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/docs/builder-fields.md b/docs/builder-fields.md index 7c24ecf..f0c7755 100644 --- a/docs/builder-fields.md +++ b/docs/builder-fields.md @@ -429,6 +429,15 @@ Manejo automático de validación, almacenamiento en BD y envío de emails. ## MCP Tools: Config Vars e Imágenes de Módulos +### Regla importante: Siempre rellenar variables al añadir un módulo +Cuando se añade un módulo a una página (con `add_module_to_record`), este queda vacío y no muestra nada visible. **SIEMPRE** hay que llamar a `set_module_config_vars` inmediatamente después para rellenar las variables con contenido de ejemplo coherente con el contexto del sitio. Incluir: +- Textos (títulos, descripciones, pretítulos) con contenido relevante al sitio +- Valores de listas/selects con una opción válida +- Para variables multi (records), crear al menos 2-3 items de ejemplo +- Para variables de imagen (upload), usar `generate_image` o `upload_record_image` para que el módulo se vea completo + +Un módulo sin variables configuradas es invisible en la web. + ### Leer variables de un módulo Antes de modificar cualquier módulo, usar `get_module_config_vars` para conocer el estado actual: - **tableName**: tabla del registro padre (ej: `apartados`), SIN prefijo `cms_`