# Tipos de contenido

Los Tipos de contenido son la base para tus Entradas. Definen qué campos y validaciones son requeridas para las Entradas, contando con más de 15 tipos de campos.

A los Tipos de contenido se les puede asignar una cardinalidad. Esta variable indica cuantas Entradas pueden existir para este Tipo. Puedes agregar idiomas al repositorio y generar Entradas en varios idiomas, almacenadas en un solo lugar. Además, puedes crear Usuarios, con diferentes roles y permisos, logrando así una división de trabajo llamada Revisión de Equipo.

# Sobre la interfaz

Al ingresar por primera vez en la sección Tipos, haz click en el botón verde +Nuevo Tipo para crear un nuevo Tipo.

Una vez que has creado tu primer Tipo, podrás crear tipos adicionales, dando click en el botón +Nuevo Tipo en la parte superior derecha.

La barra de búsqueda te permite buscar y filtrar tus tipos por cualquier palabra que aparezca en el campo Nombre.

La tabla debajo de la barra de búsqueda muestra los Tipos ya creados, ordenados de manera predeterminada de acuerdo a la fecha y hora actualizada, comenzando desde el elemento más reciente y retrocediendo.

Para reordenar la tabla, haz click en los símbolos al costado de cada categoría. Las categorías por las cuales puedes reordenar son:

  • Nombre
  • Identificador (UID)
  • Fecha de Creación
  • Fecha de Actualización

Haz click en el nombre de un Tipo para abrir el editor correspondiente.

# Crear un Tipo

Para crear un nuevo tipo de contenido que servirá como base para tus entradas, sigue estos pasos:

  1. Desde el menú principal, haz click en Contenido.
  2. Selecciona el espacio donde quieres crear un nuevo Tipo.
  3. Haz click en Tipos.
  4. Haz click en el botón Nuevo Tipo.
  5. Escribe el nombre e identificador (UID).
  6. Selecciona la cardinalidad del tipo.
  7. Haz click en Crear.

Tip

Recomendamos escribir el formato de las entradas dentro del identificador, por ejemplo, videos, posts, etc. De esta manera, cualquier miembro del equipo sabrá de qué tipo de contenido se trata y podrá usarlo como plantilla para sus entradas sin necesidad de crear una nueva.

La cardinalidad se refiere al número de entradas que pueden existir para ese tipo de contenido. Si seleccionas "cardinalidad individual", solo se permite una entrada de ese tipo. Si eliges "cardinalidad múltiple", no hay límite en el número de entradas permitidas.

Atención

El número de tipos de contenido que puedes crear por espacio lo define el plan de tu cuenta, y por defecto es 50. Al intentar crear uno más allá del cupo, la creación falla con el mensaje "Has alcanzado el número máximo de tipos de contenido para el plan actual". Si necesitas un cupo mayor, conversa con tu ejecutivo de cuenta en Modyo.

En la interfaz de creación, encontrarás una plantilla vacía en el centro de la pantalla y al lado derecho, una tabla con tres pestañas:

  • Añadir campos
  • Configuración del campo
  • Configuración

Esta interfaz te permite crear cada uno de los tipos y darles el formato necesario, según tus requisitos.

# Campos

Tip

El nombre del campo es de suma importancia, ya que será utilizado para acceder a su valor en los SDK de Liquid y JS. Para acceder al valor de un campo de una entrada puedes utilizar la sintaxis {{entry["nombre del campo"]}}.

Para más información ve a la referencia de la API

Todos los campos que se pueden añadir en un tipo, tienen un nombre, y la posibilidad de ser requeridos.

Cuando un campo es marcado como requerido, al crear o modificar una entrada, se debes proporcionar un valor para ese campo. De lo contrario, no podrás guardar los cambios realizados.

# Texto de una línea

Este campo te permite ingresar textos de una sola linea. Cuenta con las siguientes restricciones:

  • Largo mínimo: Permite exigir un mínimo de caracteres para el texto ingresado.
  • Largo máximo: Permite limitar la cantidad máxima de caracteres para el texto ingresado.
  • Validación por expresión regular: Te permite añadir una expresión regular para validar que el texto ingresado, al crear o modificar una entrada, cumpla con un formato determinado.
  • Único: Exige que el valor no se repita en otras entradas del mismo tipo. Es la única validación de unicidad de la plataforma, y Texto de una línea es el único campo que la ofrece. Si el valor ya está en uso, la entrada no se guarda y el campo muestra "Debe ser único".

El alcance de Único es el tipo completo: la comparación recorre todas las entradas del tipo, incluidas las que están en borrador o programadas y las traducciones a otros idiomas. Quedan fuera las versiones de respaldo y la propia entrada que estás editando, así que volver a publicar una entrada no choca consigo misma. Un campo vacío no se considera repetido.

Atención

Único no tiene efecto sobre un campo que está dentro de un Grupo. La casilla se sigue mostrando al configurar el campo, pero la validación no se evalúa y los valores repetidos se guardan sin error. Si necesitas garantizar unicidad, deja el campo fuera del grupo.

# Texto enriquecido

Este campo se traduce en un editor WYSIWYG de texto de múltiples líneas que también te permite modificar el código HTML del texto. Este campo cuenta con las siguientes restricciones:

  • Largo mínimo: Establece el mínimo de caracteres para el texto ingresado.
  • Largo máximo: Limita la cantidad máxima de caracteres para el texto ingresado.

Este campo te permite agregar una lista desplegable donde solo se puede seleccionar una opción.

# Radio

Utiliza este campo para agregar una lista fija de elementos para seleccionar solo una opción.

# Checkbox

Este campo te permite agregar una lista de la cual puedes seleccionar más de una opción o dejar en blanco.

# Opciones múltiples

Este campo te permite elegir uno o más valores desde un buscador que filtra a medida que escribes. El buscador solo ofrece los valores definidos en el tipo: al editar una entrada no puedes proponer un valor nuevo desde el campo. Los valores se administran en Valores permitidos, al configurar el campo.

Atención

Si cargas este campo por la API, envía las etiquetas exactas de los valores permitidos o los identificadores que devuelve la API. Un texto que no coincide con ninguna etiqueta se descarta en silencio: la entrada se guarda sin ese valor y sin mensaje de error. Un identificador numérico que no pertenece al campo, en cambio, impide guardar la entrada.

# Valores permitidos

En los campos de elección (Dropdown, Radio, Checkbox y Opciones múltiples), las opciones se gestionan en la sección Valores permitidos del campo: usa Agregar valor y Eliminar valor para administrarlas, y el selector para marcar el Valor predeterminado. Antes de guardar, la interfaz marca las opciones como Nueva o Modificada para que revises tus cambios.

Cada valor es un elemento individual del tipo de contenido:

  • Al renombrar un valor, las entradas que lo tenían seleccionado conservan su selección con el nuevo nombre, en todas sus versiones.
  • Al eliminar un valor en uso, este se archiva: deja de ofrecerse para nuevas selecciones, pero las entradas que ya lo tenían seleccionado lo siguen mostrando, sin pérdida de datos históricos.

Tip

El nombre de un valor activo no admite saltos de línea ni comenzar con el carácter *.

# Booleano

Este campo te permite agregar una pregunta o afirmación (Verdadero/True o Falso/False).

# Entero

Este campo te permite agregar un número entero entre -2147483648 y 2147483647. Puedes acotar ese rango con las siguientes restricciones:

  • Valor mínimo: Rechaza los valores menores al número que indiques.
  • Valor máximo: Rechaza los valores mayores al número que indiques.

Ambas restricciones acotan el valor del número, no la cantidad de dígitos. Déjalas vacías para no aplicar ese límite. Si el número queda fuera del rango, la entrada no se guarda y el campo muestra "Número inválido. Debe ser mayor o igual que 18" o "Número inválido. Debe ser menor o igual que 120", con los límites que hayas configurado.

# Decimal

Utiliza este campo para ingresar un número con decimales. Admite hasta dos decimales y valores entre -9999999999999.99 y 9999999999999.99. Si guardas más de dos decimales, el valor se redondea sin avisarte: 10.567 queda almacenado como 10.57. Puedes acotar el rango con las siguientes restricciones:

  • Valor mínimo: Rechaza los valores menores al número que indiques.
  • Valor máximo: Rechaza los valores mayores al número que indiques.

Ambas restricciones acotan el valor del número, no la cantidad de dígitos, y solo aceptan números enteros: para exigir un monto positivo, por ejemplo, usa 0 como Valor mínimo. Si el número queda fuera del rango, la entrada no se guarda y el campo muestra "Número inválido. Debe ser menor o igual que", con el límite que hayas configurado.

# Fecha

Utiliza este campo para agregar un selector de fechas. Limita las fechas seleccionables aplicando las siguientes restricciones:

  • Desde: Establece la fecha más temprana que se puede elegir.
  • Hasta: Establece la fecha más tardía que se puede elegir.

# Ubicación

Utiliza este campo para seleccionar una dirección geográfica, según los campos de Google Maps. En caso de que no dispongas de una clave de API de Google, puedes ingresar manualmente el nombre, la latitud, la longitud y las divisiones políticas de la ubicación. Estas divisiones administrativas no son estándar y varían según cada país. En el caso de Chile, las divisiones son: Región, Provincia, Comuna y Ciudad.

Atención

Para garantizar el correcto funcionamiento de los mapas de ubicación con la clave de API de Google configurada en tu cuenta, la clave tiene que tener permisos para acceder a:

  • API de mapas a través de JavaScript
  • API de lugares
  • API de geocodificación

# Archivo

Este campo te permite adjuntar un solo archivo a la entrada, utilizando el gestor de archivos.

# Listado de Archivos

Este campo te permite adjuntar múltiples archivos a la entrada, usando el gestor de archivos.

# Contenido (enlace a una)

Utiliza este campo para vincular una Entrada a otra Entrada existente y publicada dentro del Espacio. Este campo tiene las siguientes restricciones:

  • Tipos de contenido permitidos: Limita el enlace a las entradas de un tipo. Pese al plural del nombre, seleccionas un único tipo; el valor por defecto es Todos, que no restringe nada. Si la entrada enlazada no es del tipo elegido, la entrada no se guarda y el campo muestra "No calza con los valores permitidos", seguido del nombre del tipo exigido.

# Listado de Contenido (enlace a varias)

Este campo te permite vincular más de una Entrada existente dentro del Espacio a otra Entrada. Este campo tiene las siguientes restricciones:

  • Tipos de contenido permitidos: Limita los enlaces a las entradas de un tipo. Pese al plural del nombre, seleccionas un único tipo, que aplica a todas las entradas que enlaces; el valor por defecto es Todos, que no restringe nada. Si cualquiera de las entradas enlazadas no es del tipo elegido, la entrada no se guarda y el campo muestra "No calza con los valores permitidos", seguido del nombre del tipo exigido.

# Grupo

Utiliza el campo Grupo para albergar otro campo dentro él. Puedes asignar un nombre al grupo según tus necesidades, así como nombrar los campos dentro del grupo. En casilla pista, incluye el texto que deseas mostrar para ayudar a tus usuarios a completar correctamente el campo.

Una vez que tengas más de un tipo de campo dentro de un grupo, puedes arrastrarlos y ordenarlos según requieras.

No hay límite en la cantidad de campos que puedes incluir dentro de un grupo.

Puedes validar el contenido de los campos de la siguiente forma:

  • Requerido: Marca la casilla Requerido para obligar a que se complete el grupo o campo.
    • Si marcas el grupo como requerido, al menos un elemento dentro del grupo deberá ser completado.
    • Si marcas un elemento como requerido, ese elemento tiene que tener contenido.
  • Único: No aplica dentro de un grupo. La casilla aparece al configurar un campo de Texto de una línea que esté dentro del grupo, pero la validación no se evalúa y los valores repetidos se guardan sin error.

Tip

Un grupo puede albergar cualquier tipo de campo, menos otro grupo.

# Propiedades

En esta pestaña, puedes ver el nombre y UID del tipo. El UID es importante, ya que se utiliza para referirse al tipo desde los SDK de Liquid, JavaScript y la API. A continuación, verás un botón que puede estar en 2 estados:

  • Reindexar: Te permite volver a indexar el modelo en caso de problemas con la API pública.
  • Cancelar reindexación: Si hay una reindexación en curso, puedes cancelar el proceso haciendo click en este botón.

Atención

Al reindexar uno de tus tipos, el modelo previamente indexado seguirá disponible hasta que se complete la nueva indexación. Una vez finalizada la reindexación, el antiguo índice se sobrescribirá con el nuevo índice.

Atención

Ten en cuenta que dependiendo de la configuración de caché que tengas en tu espacio, es posible que no veas los cambios inmediatamente después de haber terminado la reindexación.