Introducción

Define campos personalizados para tu contenido sin tocar el código.

🎯 ¿Qué hace este módulo?

El módulo AttributesSets te permite usar campos personalizados para tu contenido (productos, páginas, formularios, etc.) sin codificarlos en tu aplicación.

Piénsalo como un constructor de formularios para tus datos: tú defines qué campos necesitas, y OneEntry se encarga del resto.

📖 Explicación Simple

Imagina que estás construyendo una tienda en línea. Cada producto necesita:

Nombre (texto)
Precio (número)
Imagen (foto)
Descripción (texto largo)
Categoría (desplegable)

En lugar de codificar estos campos en tu aplicación, usas Attributes para definirlos en el panel de administración de OneEntry. Luego puedes:

✅ Agregar nuevos campos en cualquier momento (¡sin cambios de código!)
✅ Reutilizar campos en diferentes tipos de contenido
✅ Cambiar tipos de campo sin redeplegar
✅ Gestionar toda la estructura de contenido en un solo lugar

Ejemplo del mundo real:

Sin Attributes (codificado):
- Código: const product = { name, price, image, description }
- Para agregar el campo "color" → Cambiar código, redeplegar, esperar ❌

Con Attributes (dinámico):
- Panel de administración: Agregar atributo "color"
- Código incluye automáticamente el nuevo campo ✅
- ¡No se necesita despliegue! ✅

✨ Conceptos Clave

¿Qué es un Atributo?

Un atributo es un campo único que almacena datos.

Ejemplos:

Nombre del producto (cadena)
Precio del producto (flotante)
Imagen del producto (imagen)
Fecha de publicación (fecha)

¿Qué es un Conjunto de Atributos?

Un conjunto de atributos es una colección de atributos que definen una estructura.

Ejemplo: Conjunto de Atributos del Producto

- name (cadena)
- price (flotante)
- description (texto)
- images (grupo de imágenes)
- category (lista)
- inStock (entero)

¿Por qué Usar Conjuntos de Atributos?

Sin Attributes	Con Attributes
❌ Campos codificados	✅ Campos dinámicos
❌ Cambios de código necesarios	✅ Editar en el panel de administración
❌ Se requiere redepliegue	✅ Actualizaciones en vivo
❌ Estructura rígida	✅ Estructura flexible
❌ Código duplicado	✅ Conjuntos reutilizables

📋 Lo Que Necesitas Saber

Tres Términos Importantes

Término	Qué Es	Ejemplo
Marker	Identificador de código único	"product_name"
Type	Qué tipo de datos almacena	"cadena", "entero", "imagen"
Value	Valor del atributo	"Nombre del Producto"

Importante sobre los Markers:

Deben ser únicos
No se permiten espacios (usa _ en su lugar)
No pueden comenzar con un número
Usa minúsculas para consistencia

Ejemplos:

✅ Bueno: product_name, price_usd, main_image
❌ Malo: product name, 2nd_price, Product Name

Reutilización

Los conjuntos de atributos pueden ser reutilizados en diferentes entidades:

Conjunto de Atributos "Información Básica":
- title (cadena)
- description (texto)
- publish_date (fecha)

Usado por:
✅ Publicaciones de blog
✅ Artículos de noticias
✅ Páginas de productos
✅ Listados de eventos

Por qué esto es importante: ¡Cambia una vez, actualizaciones en todas partes!

📚 Tipos de Datos Disponibles

Los atributos pueden almacenar diferentes tipos de datos. Elige el tipo correcto para cada campo.

Tabla de Referencia Rápida

Tipo	Mejor Para	Ejemplo de Uso
cadena	Texto corto	Nombre del producto, correo
texto	Texto largo formateado	Publicación de blog, descripción
textoConEncabezado	Texto con título	Secciones de artículos
entero	Números enteros	Cantidad, edad
real	Decimales de alta precisión	Datos científicos
flotante	Números decimales	Precio, calificación
fecha	Solo la fecha	Fecha de nacimiento, fecha límite
fechaHora	Fecha + hora	Inicio del evento, publicado en
hora	Solo la hora	Horario de apertura
archivo	Cualquier archivo	PDF, documento
imagen	Imagen única	Avatar, logo
grupoDeImágenes	Múltiples imágenes	Galería de fotos
botónDeOpción	Elección única	Tamaño (S/M/L)
lista	Selección desplegable	País, categoría
entidad	Enlace a otro contenido	Productos relacionados
intervaloDeTiempo	Rango de fechas	Período de promoción
json	Datos estructurados personalizados	Respuesta de API

🔍 Descripciones Detalladas de Tipos de Datos

Tipos de Texto

Cuándo usar qué:

cadena - Línea única, menos de 255 caracteres (nombre, correo, título)
texto - Múltiples párrafos, soporta formateo (artículos, descripciones)
textoConEncabezado - Texto que necesita un encabezado (secciones de blog, preguntas frecuentes)

Tipos de Números

Cuándo usar qué:

entero - Sin decimales necesarios (edad, cantidad, vistas)
flotante - Decimales estándar (precio $19.99, calificación 4.5)
real - Precisión extra necesaria (cálculos científicos)

Tipos de Fecha/Hora

Cuándo usar qué:

fecha - Solo el día (cumpleaños, fecha límite)
hora - Solo la hora (horario comercial, hora de cita)
fechaHora - Ambos necesarios (inicio del evento, artículo publicado)
intervaloDeTiempo - Período entre fechas (duración de la venta, fechas de vacaciones)

Tipos de Archivo e Imagen

Cuándo usar qué:

archivo - Cualquier documento (PDF, DOC, ZIP)
imagen - Una foto (foto de producto, avatar)
grupoDeImágenes - Múltiples fotos (galería, imágenes de producto)

Tipos de Selección

Cuándo usar qué:

botónDeOpción - Elegir solo UNA opción (Sí/No, Tamaño S/M/L)
lista - Desplegable con opciones (País, Categoría, Estado)

Tipos Avanzados

entidad - Enlace a otras páginas/productos (Artículos Relacionados, Categorías)
json - Almacenar estructuras de datos complejas (respuestas de API, configuraciones)

📖 Ejemplos de Tipos de Datos

A continuación se presentan ejemplos técnicos de la estructura de cada tipo de dato.

Haz clic para ver todos los ejemplos de tipos de datos

Referencia de Tipos de Datos

Los tipos de datos pueden ser de los siguientes tipos:

Cadena: Texto simple, por ejemplo, "¡Hola, mundo!".

Ejemplo:

{
  "type": "cadena",
  "value": {},
  "marker": "cadena",
  "position": 1,
  "listTitles": [],
  "validators": {
    "requiredValidator": {
      "strict": true
    }
  },
  "localizeInfos": {
    "title": "Cadena"
  },
  "additionalFields": [
    {
      "type": "entero",
      "value": "10",
      "marker": "Extra"
    }
  ]
}

Texto: Texto más largo, a menudo formateado, por ejemplo, un artículo o una carta.

Ejemplo:

{
  "type": "texto",
  "value": {},
  "marker": "texto",
  "position": 2,
  "listTitles": [],
  "validators": {},
  "localizeInfos": {
    "title": "Texto"
  },
  "additionalFields": []
}

Texto con Encabezado: Texto con un encabezado que se puede usar para denotar un tema o categoría.

Ejemplo:

{
  "type": "textoConEncabezado",
  "value": {},
  "marker": "texto_con_encabezado",
  "position": 3,
  "listTitles": [],
  "validators": {},
  "localizeInfos": {
    "title": "Texto Con Encabezado"
  },
  "additionalFields": []
}

Entero: Un número entero, por ejemplo, 5, 100, -2.

Ejemplo:

{
  "type": "entero",
  "value": {},
  "marker": "entero",
  "position": 4,
  "listTitles": [],
  "validators": {},
  "localizeInfos": {
    "title": "Entero"
  },
  "additionalFields": []
}

Real: Lo mismo que Flotante, pero con mayor precisión.

Ejemplo:

{
  "type": "real",
  "value": {},
  "marker": "numero_real",
  "position": 5,
  "listTitles": [],
  "validators": {},
  "localizeInfos": {
    "title": "Número Real"
  },
  "additionalFields": []
}

Flotante: Un tipo de dato para números de punto flotante que pueden tener una parte decimal, por ejemplo, 3.14, 1.5, -0.25.

Ejemplo:

{
  "type": "flotante",
  "value": {},
  "marker": "flotante",
  "position": 6,
  "listTitles": [],
  "validators": {},
  "localizeInfos": {
    "title": "Flotante"
  },
  "additionalFields": []
}

Fecha y Hora: Una combinación de fecha y hora, por ejemplo, 2023-10-27 10:00:00.

Ejemplo:

{
  "type": "fechaHora",
  "value": {},
  "marker": "fecha_hora",
  "position": 7,
  "listTitles": [],
  "validators": {},
  "localizeInfos": {
    "title": "FechaHora"
  },
  "additionalFields": []
}

Fecha: Una fecha, por ejemplo, 2023-10-27.

Ejemplo:

{
  "type": "fecha",
  "value": {},
  "marker": "fecha",
  "position": 8,
  "listTitles": [],
  "validators": {},
  "localizeInfos": {
    "title": "Fecha"
  },
  "additionalFields": []
}

Hora: Una hora, por ejemplo, 10:00:00.

Ejemplo:

{
  "type": "fecha",
  "value": {},
  "marker": "fecha",
  "position": 8,
  "listTitles": [],
  "validators": {},
  "localizeInfos": {
    "title": "Fecha"
  },
  "additionalFields": []
}  

Archivo: Cualquier archivo en tu computadora, por ejemplo, un documento, imagen, música.

Ejemplo:

{
  "type": "archivo",
  "value": {},
  "marker": "archivo",
  "position": 10,
  "listTitles": [],
  "validators": {
    "checkingFilesValidator": {
      "maxUnits": "kb",
      "maxValue": "2000",
      "minUnits": "kb",
      "minValue": 0,
      "extensions": []
    }
  },
  "localizeInfos": {
    "title": "Archivo"
  },
  "additionalFields": []
}

Imagen: Una imagen, por ejemplo, una fotografía, un dibujo.

Ejemplo:

{
  "type": "imagen",
  "value": {},
  "marker": "imagen",
  "position": 11,
  "listTitles": [],
  "validators": {
    "sizeInPixelsValidator": {
      "maxX": "500",
      "maxY": "500"
    }
  },
  "localizeInfos": {
    "title": "Imagen"
  },
  "additionalFields": []
}

Grupo de Imágenes: Una colección de imágenes, por ejemplo, un álbum de fotos.

Ejemplo:

{
  "type": "grupoDeImágenes",
  "value": {},
  "marker": "grupo_de_imagenes",
  "position": 12,
  "listTitles": [],
  "validators": {},
  "localizeInfos": {
    "title": "Grupo de Imágenes"
  },
  "additionalFields": []
}

Botón de Opción: Un botón de selección del cual solo se puede elegir una opción.

Ejemplo:

{
  "type": "botónDeOpción",
  "value": {},
  "marker": "radio",
  "position": 13,
  "listTitles": [
    {
      "title": "A",
      "value": "a",
      "extended": {
        "type": null,
        "value": null
      },
      "position": 1
    },
    {
      "title": "B",
      "value": "b",
      "extended": {
        "type": null,
        "value": null
      },
      "position": 2
    }
  ],
  "validators": {},
  "localizeInfos": {
    "title": "Radio"
  },
  "additionalFields": []
}

Lista: Una lista de elementos, por ejemplo, una lista de compras.

Ejemplo:

{
  "type": "lista",
  "value": {},
  "marker": "lista",
  "position": 14,
  "listTitles": [
    {
      "title": "A",
      "value": "a",
      "extended": {
        "type": null,
        "value": null
      },
      "position": 1
    },
    {
      "title": "B",
      "value": "b",
      "extended": {
        "type": null,
        "value": null
      },
      "position": 2
    },
    {
      "title": "C",
      "value": "c",
      "extended": {
        "type": "cadena",
        "value": "Valor Adicional"
      },
      "position": 3
    }
  ],
  "validators": {},
  "localizeInfos": {
    "title": "Lista"
  },
  "additionalFields": []
}

Entidad: Una entidad que representa un objeto.

Ejemplo:

{
  "type": "entidad",
  "value": {},
  "marker": "entidad",
  "position": 15,
  "listTitles": [
    {
      "title": "Productos",
      "value": {
        "id": 1,
        "depth": 0,
        "parentId": null,
        "position": 1,
        "selected": true
      }
    },
    {
      "title": "Página Normal",
      "value": {
        "id": 4,
        "depth": 0,
        "parentId": null,
        "position": 2,
        "selected": true
      }
    },
    {
      "title": "Error",
      "value": {
        "id": 2,
        "depth": 0,
        "parentId": null,
        "position": 3,
        "selected": true
      }
    }
  ],
  "validators": {},
  "localizeInfos": {
    "title": "Entidad"
  },
  "additionalFields": [
    {
      "type": "cadena",
      "value": "Campo de Prueba",
      "marker": "campo_de_prueba"
    }
  ]
}

Intervalo de Tiempo: Un calendario flexible con una interfaz fácil de usar para gestionar datos de intervalos de tiempo.

Ejemplo:

{
  "type": "intervaloDeTiempo",
  "value": {},
  "marker": "intervalo_de_tiempo",
  "position": 16,
  "listTitles": [],
  "validators": {},
  "localizeInfos": {
    "title": "Intervalo de Tiempo"
  },
  "additionalFields": []
}

JSON: Algunos datos en formato JSON.

Ejemplo:

{
  "type": "json",
  "value": {},
  "marker": "json",
  "position": 17,
  "listTitles": [],
  "validators": {},
  "localizeInfos": {
    "title": "Json"
  },
  "additionalFields": []
}

La interfaz de llenado de contenido corresponderá al tipo de dato seleccionado para cada campo de atributo.

💡 Notas Importantes

Validadores

Puedes agregar validadores para atributos para asegurar la calidad de los datos:

Campos requeridos
Longitud mínima/máxima para texto
Límites de tamaño de archivo para cargas
Dimensiones en píxeles para imágenes
Rangos de fechas

Aprende más: Consulta la sección "Validadores" para una configuración detallada.

Conjuntos de Atributos Compartidos

⚠️ Importante: Si un conjunto de atributos es utilizado por múltiples entidades, ten cuidado al hacer cambios:

Eliminar un atributo:

❌ Lo elimina en todas partes donde se usa el conjunto
❌ Elimina todo el contenido en ese campo
⚠️ ¡No se puede deshacer!

Agregar un atributo:

✅ Se agrega en todas partes donde se usa el conjunto
✅ El contenido existente no cambia
ℹ️ El nuevo campo estará vacío para los elementos existentes

Ejemplo:

"Información del Producto" utilizado por:
- Productos Físicos
- Productos Digitales
- Servicios

Eliminar el atributo "peso" → ¡Eliminado de los TRES! ⚠️

📊 Tabla de Referencia Rápida - Métodos Comunes

Método	Qué Hace	Cuándo Usar
getAttributes()	Obtener todos los objetos de conjuntos de atributos.
getAttributesByMarker()	Obtener todos los atributos por marcador con datos del conjunto de atributos.
getAttributeSetByMarker()	Obtener un solo objeto de conjunto de atributos por marcador.
getSingleAttributeByMarkerSet()	Obtener un atributo con datos del conjunto de atributos.

❓ Preguntas Comunes (FAQ)

¿Cuál es la diferencia entre cadena y texto?

cadena - Texto corto, línea única (máx. ~255 caracteres). Usar para nombres, títulos, correos.
texto - Texto largo, múltiples párrafos, soporta formateo y HTML. Usar para descripciones, artículos.

¿Cuándo debo usar entero vs flotante?

entero - Solo números enteros: 1, 2, 100, -5. Usar para cantidades, conteos, edades.
flotante - Números decimales: 19.99, 4.5, -0.25. Usar para precios, calificaciones, medidas.
real - Como flotante pero con mayor precisión. Usar para cálculos científicos.

Mejor práctica: Planifica tus tipos de atributos antes de agregar contenido.

¿Qué pasa si elimino un atributo?

No puedes eliminar un atributo si se utiliza en un conjunto de atributos.

¿Puedo reutilizar el mismo atributo en diferentes conjuntos de atributos?

No, cada atributo pertenece a un conjunto de atributos. Pero puedes:

Crear atributos similares con diferentes markers
Reutilizar conjuntos de atributos completos en múltiples entidades

¿Qué es el "marker" y por qué es importante?

El marker es el identificador técnico que usas en el código:

// En tu código:
product.attributeValues.product_name  // ← "product_name" es el marker

// VS el nombre (mostrado en administración):
"Nombre del Producto"  // ← Esto es solo para humanos

Reglas para markers:

Deben ser únicos
Sin espacios (usa _)
No pueden comenzar con números
Usa minúsculas
Elige nombres descriptivos

¿Cómo sé qué tipo usar para mis datos?

Pregúntate:

¿Es texto?
- ¿Corto (< 255 caracteres)? → cadena
- ¿Largo con formateo? → texto
- ¿Necesita un título? → textoConEncabezado
¿Es un número?
- ¿Sin decimales? → entero
- ¿Con decimales? → flotante
- ¿Precisión científica? → real
¿Es una elección?
- ¿Elegir una opción? → botónDeOpción
- ¿Menú desplegable? → lista
¿Es un archivo?
- ¿Foto? → imagen o grupoDeImágenes
- ¿Documento? → archivo
¿Es una fecha?
- ¿Solo fecha? → fecha
- ¿Fecha + hora? → fechaHora
- ¿Período de tiempo? → intervaloDeTiempo

¿Puedo tener atributos anidados (atributos dentro de atributos)?

No directamente, pero puedes usar:

Tipo entidad para enlazar a otro contenido
Tipo json para almacenar datos estructurados
Múltiples conjuntos de atributos para organizar campos relacionados

¿Cómo agrego reglas de validación?

En el panel de administración de OneEntry:

Ve a tu conjunto de atributos
Haz clic en un atributo
Agrega validadores (requerido, min/max, regex, etc.)
Guarda los cambios

Validadores comunes:

Campo requerido
Longitud mínima/máxima
Formato de correo
Formato de URL
Límites de tamaño de archivo
Dimensiones de imagen

🎓 Mejores Prácticas

Usa markers descriptivos (product_price no pp)
Planifica los tipos de atributos antes de agregar contenido
Reutiliza conjuntos de atributos cuando sea posible
Agrega validadores para asegurar la calidad de los datos
Documenta para qué es cada atributo

Más información sobre la interfaz de usuario del módulo https://doc.oneentry.cloud/docs/attributes/introduction

Definición del módulo AttributesSets


const { AttributesSets } = defineOneEntry(
  "tu-url-de-proyecto", {
    "token": "tu-token-de-aplicación"
  }
);

🔗 Documentación Relacionada

Módulo de Productos - Usa conjuntos de atributos para datos de productos
Módulo de Páginas - Usa conjuntos de atributos para contenido de páginas
Módulo de Bloques - Usa conjuntos de atributos para bloques reutilizables
Módulo de Formularios - Crea formularios con campos personalizados

Introducción

🎯 ¿Qué hace este módulo?​

📖 Explicación Simple​

✨ Conceptos Clave​

¿Qué es un Atributo?​

¿Qué es un Conjunto de Atributos?​

¿Por qué Usar Conjuntos de Atributos?​

📋 Lo Que Necesitas Saber​

Tres Términos Importantes​

Reutilización​

📚 Tipos de Datos Disponibles​

Tabla de Referencia Rápida​

🔍 Descripciones Detalladas de Tipos de Datos​

Tipos de Texto​

Tipos de Números​

Tipos de Fecha/Hora​

Tipos de Archivo e Imagen​

Tipos de Selección​

Tipos Avanzados​

📖 Ejemplos de Tipos de Datos​

Referencia de Tipos de Datos​

💡 Notas Importantes​

Validadores​

Conjuntos de Atributos Compartidos​

📊 Tabla de Referencia Rápida - Métodos Comunes​

❓ Preguntas Comunes (FAQ)​

¿Cuál es la diferencia entre cadena y texto?​

¿Cuándo debo usar entero vs flotante?​

¿Qué pasa si elimino un atributo?​

¿Puedo reutilizar el mismo atributo en diferentes conjuntos de atributos?​

¿Qué es el "marker" y por qué es importante?​

¿Cómo sé qué tipo usar para mis datos?​

¿Puedo tener atributos anidados (atributos dentro de atributos)?​

¿Cómo agrego reglas de validación?​

🎓 Mejores Prácticas​

Definición del módulo AttributesSets​

🔗 Documentación Relacionada​

🎯 ¿Qué hace este módulo?

📖 Explicación Simple

✨ Conceptos Clave

¿Qué es un Atributo?

¿Qué es un Conjunto de Atributos?

¿Por qué Usar Conjuntos de Atributos?

📋 Lo Que Necesitas Saber

Tres Términos Importantes

Reutilización

📚 Tipos de Datos Disponibles

Tabla de Referencia Rápida

🔍 Descripciones Detalladas de Tipos de Datos

Tipos de Texto

Tipos de Números

Tipos de Fecha/Hora

Tipos de Archivo e Imagen

Tipos de Selección

Tipos Avanzados

📖 Ejemplos de Tipos de Datos

Referencia de Tipos de Datos

💡 Notas Importantes

Validadores

Conjuntos de Atributos Compartidos

📊 Tabla de Referencia Rápida - Métodos Comunes

❓ Preguntas Comunes (FAQ)

¿Cuál es la diferencia entre cadena y texto?

¿Cuándo debo usar entero vs flotante?

¿Qué pasa si elimino un atributo?

¿Puedo reutilizar el mismo atributo en diferentes conjuntos de atributos?

¿Qué es el "marker" y por qué es importante?

¿Cómo sé qué tipo usar para mis datos?

¿Puedo tener atributos anidados (atributos dentro de atributos)?

¿Cómo agrego reglas de validación?

🎓 Mejores Prácticas

Definición del módulo AttributesSets

🔗 Documentación Relacionada