Elegir el tipo de columna

Cada columna de tu tabla tiene un tipo. Elegir bien el tipo es lo que hace que el formulario salga cómodo y los datos salgan limpios.

Catálogo completo

El desplegable Tipo ofrece 28 tipos. Los nombres de la columna "Usa el tipo" son literalmente los que aparecen en el desplegable, incluidas sus rarezas de escritura (sí, dice "Boleano" con una sola "o").

Texto y números

Cuando el dato es…	Usa el tipo	Qué te da
Un nombre, un código corto	Texto	Campo de una línea
Una descripción larga	Área Texto	Caja de varias líneas
Texto con formato	Código	Editor enriquecido (negritas, listas, enlaces)
Una cantidad entera	Número Entero	Solo números sin decimales
Una cantidad con decimales	Número Decimal	2,5 kg · 9,22 horas
Un precio, un monto	Dinero	Se muestra como $9.800 en los listados
Una cantidad con unidad	Medida	Número + unidad ("12,5 kg") en una sola celda

Fechas

Cuando el dato es…	Usa el tipo	Qué te da
Una fecha	Fecha	Calendario
Solo una hora	Hora	Selector de hora
Fecha y hora juntas	Fecha y Hora	Calendario + reloj
La fecha en que se guardó	Fecha Automática	Se rellena sola y no se puede editar

Opciones y estados

Cuando el dato es…	Usa el tipo	Qué te da
Sí / no, activo / inactivo	Boleano	Interruptor ON/OFF en el listado
Una lista fija de opciones	Selección	Desplegable con los valores que tú definas
Un estado del proceso	Workflow	Etiqueta de color + botones de transición
Un dato de otra tabla	Relaciones	Desplegable con los registros de esa tabla
La posición en una lista	Ordenar	Número entero para ordenar los registros a mano

Archivos y multimedia

Cuando el dato es…	Usa el tipo	Qué te da
Una foto	Imagen	Subida con miniatura en el listado
Varias fotos	Múltiples Imágenes	Galería (el parámetro fija el máximo)
Un video	Video	Subida de archivo de video
Cualquier archivo	Archivo	Subida y enlace de descarga (PDF, ZIP, etc.)

Datos de contacto y formato

Cuando el dato es…	Usa el tipo	Qué te da
Un correo	Email	Campo con validación de correo
Una dirección web	Enlace	Campo de texto para una URL
Una contraseña	Contraseña	Se escribe oculto, con puntitos
Un color	Color	Selector de color

Tipos avanzados

Estos guardan estructuras, no un valor suelto. Úsalos solo si sabes que los necesitas.

Cuando el dato es…	Usa el tipo	Qué te da
Una lista de palabras sueltas	Arreglo	Etiquetas que agregas una a una
Pares "propiedad / valor"	Objeto	Filas de propiedad y valor que puedes ir sumando
Varios grupos de propiedades y valores	JSON	Lo mismo que Objeto, pero agrupado
Texto que redacta la IA	ChatGPT	Un prompt + un editor que se rellena con la respuesta

El tipo ChatGPT necesita configuración

No funciona recién instalado: hay que cargar las credenciales de OpenAI (api_url, model, token) en el bloque openai de cms/config.php, o en las variables de entorno equivalentes. Sin eso el botón de generar no devuelve nada.

Cuándo importa el "Parámetro del tipo"

Al elegir ciertos tipos aparece un campo extra llamado Parámetro del tipo. Es donde escribes info específica de ese tipo:

• Relaciones → escribe la tabla destino (categorias, clientes, productos).
• Múltiples Imágenes → escribe el máximo de imágenes (10).
• Medida → escribe la unidad literal (kg) o el nombre de una columna hermana que guarda la unidad por fila (unidad_insumo).
• Selección → escribe los valores separados por coma (baja,media,alta).
• ChatGPT → escribe el prompt por defecto que aparecerá al abrir el formulario.

Tipo "Medida" — el caso más útil

El tipo Medida muestra un valor numérico junto a su unidad en una sola celda (15 Kilogramo en vez de dos columnas).

• Se guarda como número, así que sumas, promedios y triggers siguen funcionando.
• La unidad puede ser fija (kg) o por fila (nombre de otra columna que guarda la unidad de cada registro).

Ejemplo real de Recetas:

• cantidad tipo Medida con parámetro unidad_insumo (nombre de otra columna).
• unidad_insumo tipo Selección con valores kg,litro,unidad,gramo.

Al mostrar el listado ves 500 gramo, 2 litro, 4 unidad en cada fila.

Tipo "Workflow"

Convierte una columna en el estado de un proceso. Ver Workflow Manager.

• Se muestra como etiqueta de color en el listado.
• Al editar el registro, aparecen botones con las transiciones válidas desde el estado actual.
• Cada transición puede requerir un formulario y respetar permisos por rol.

Tipo "Relaciones" — a fondo

Ver Relacionar tablas.

• Muestra un desplegable con los registros de la tabla destino.
• Por defecto muestra la segunda columna de esa tabla (típicamente el nombre).
• Con tabla:columna en el parámetro puedes mostrar otra columna específica.
• Casos especiales: admins (usuarios del CMS).

Elegir íconos sin saber inglés

Cuando un campo pide ícono (secciones, tableros, widgets), hay un botón con cuadrícula que abre el catálogo visual. Escribe en español lo que buscas: cliente, pedido, café, vacaciones, stock, limpieza. El catálogo entiende sinónimos comunes.

Si no aparece nada

Prueba una palabra más general: en vez de "sanitización" escribe "limpieza"; en vez de "liquidación" escribe "sueldo" o "dinero". También funciona escribir el nombre técnico en inglés si lo conoces (cup-hot, truck).

¿Cuál elijo si no estoy seguro?

Regla general:

• Valor pequeño → Texto.
• Valor con formato específico (dinero, fecha, email) → tipo correspondiente.
• Elegir de una lista fija → Selección.
• Sí / No → Boleano.
• Sube archivo → Imagen / Múltiples Imágenes / Archivo.
• Apunta a otra tabla → Relaciones.
• Cambia de estado → Workflow.

Ante la duda, empieza con Texto y cámbialo después si notas que estarías mejor con otro tipo (recuerda: cambios de tipo pueden fallar si los datos existentes no calzan).

Ejemplo — columnas de la tabla Productos

nombre         Texto
categoria      Relaciones (parámetro: categorias)
precio         Dinero
stock          Número Entero
imagen         Imagen
descripcion    Área Texto (visibilidad OFF)
activo         Boleano
rendimiento    Número Decimal

¿Qué sigue?

• Archivos e imágenes — el detalle de campos multimedia.
• Relacionar tablas — el tipo Relaciones a fondo.
• Campos condicionales — mostrar campos según lo que el usuario elija en otros.