Hosting con 20% de descuento comprando por el enlace

Campos

Los 18 tipos de campo que deciden qué edita el cliente — texto, imágenes, listas, enlaces, referencias —, más campos condicionales, filas con nombre, grupos, pestañas y conjuntos reutilizables.

Los campos son las casillas que el cliente completa en el panel. Cada página y cada tipo de contenido tienen los campos que describes, y cada campo tiene un tipo que decide qué muestra el panel: una línea, un editor de texto, un selector de imagen, una lista de filas. Solo el título, la dirección y, en los tipos de contenido, la fecha de publicación vienen integrados. Todo lo demás es un campo que tú nombras.

Los 18 tipos de campo

TipoPara qué sirve
textUna línea: un título, un nombre, el texto de un botón.
textareaUn párrafo sin formato: un resumen, un subtítulo.
richtextContenido con formato: negrita, títulos, listas, citas, enlaces, imágenes, código y tablas simples.
imageUna imagen de la biblioteca de medios.
galleryVarias imágenes, en un orden que arrastras.
fileCualquier archivo de la biblioteca de medios — un PDF, un video, un audio —, con la opción de limitar los tipos aceptados.
selectUna opción de una lista cerrada: Casa, Departamento, Terreno.
booleanUna casilla de sí o no, útil para activar o desactivar una sección.
numberUn número: una cantidad, un año, minutos.
emailUna dirección de correo electrónico.
urlUna dirección web.
dateUna fecha, elegida en un calendario.
repeaterFilas con los mismos campos: servicios, cada uno con nombre y resumen.
flexibleUna lista de bloques de distintos tipos, cada fila con su propio formato (consulta Páginas por bloques).
linkDirección, texto del enlace y “abrir en una pestaña nueva”, en un solo campo.
itemUna referencia a otra entrada del sitio: la propiedad destacada, el autor de un artículo.
groupUn recuadro plegable que organiza campos en el panel.
tabsPestañas que dividen un formulario largo en el panel.

Pídele a la IA

En el tipo Propiedad de Casa Viva, una inmobiliaria, agrega: un código de referencia (una línea), el tipo de propiedad (Casa, Departamento o Terreno), el número de dormitorios, una galería de fotos, el plano en PDF, una lista de características donde cada una es un nombre corto, y el barrio. El código y el tipo son obligatorios. Muéstrame los nombres y las etiquetas de los campos antes de aplicar.

Decir qué guarda cada campo — una línea, una opción, un PDF, una lista — alcanza para que la IA elija el tipo. Revisar los nombres antes de aplicar es el momento barato para cambiarlos.

Etiqueta y nombre

Cada campo tiene dos nombres. La etiqueta es lo que el cliente lee en el panel (“Código de referencia”); cámbiala cuando quieras. El nombre es el interno, el que lee la plantilla (codigo_referencia); decídelo antes de que exista contenido.

Renombrar un campo después sale caro: lo que se guardó con el nombre anterior deja de aparecer en el panel y se descarta la próxima vez que se guarde esa entrada. Si no hay otra salida, dilo y pídele a la IA que lleve el contenido existente al nombre nuevo.

Ayuda, placeholder y obligatorio

Un campo puede llevar una línea de ayuda debajo (“Tamaño recomendado: 1200 × 630”), un placeholder — un ejemplo dentro de la casilla vacía de una línea — y ser obligatorio: su etiqueta lleva un asterisco y, en los campos de una línea, el panel no guarda mientras esté vacío. En un sitio en varios idiomas, obligatorio vale solo para el idioma principal: desde la v3.7.4, las pestañas de traducción nunca bloquean el guardado.

Campos que aparecen solo cuando hacen falta

Con show_if, un campo aparece solo cuando otro tiene cierto valor: el enlace del video aparece cuando “Tiene recorrido en video” está marcado; la dirección del mapa, cuando el tipo de sección es Mapa o Cómo llegar. Hay dos operadores — equals para un valor, in para una lista de valores.

  • Un campo oculto deja de ser obligatorio mientras está oculto.
  • Lo que se escribió en él se conserva, así que marcar y desmarcar no pierde nada.
  • La condición mira los campos de al lado; dentro de una fila de una lista, solo los campos de esa fila.

Pídele a la IA

En la plantilla de página Taller, agrega una casilla Taller en línea. Si está marcada, muestra un campo para el enlace de la transmisión; si no, muestra la dirección del lugar. Cada uno es obligatorio solo mientras está visible.

La IA escribe las condiciones con show_if, y schema:validate comprueba que cada una apunte a un campo que existe.

Listas, grupos y pestañas

Un repeater guarda filas con los mismos campos; el cliente agrega, quita y arrastra filas. Pide un title_field para que cada fila cerrada muestre un valor — el nombre del servicio — en lugar de Item 01, Item 02. Funciona con campos cuyo valor es texto: text, textarea, number, email, url, select y link.

group reúne campos relacionados en un recuadro plegable, cerrado por defecto o abierto si lo pides. tabs reparte un formulario largo en pestañas, como Contenido, Contacto y Ajustes. Los dos solo organizan el panel: agregarlos o quitarlos después no cambia nada de lo guardado.

Referencias y enlaces

El campo item apunta a otra entrada: el cliente busca entre las entradas publicadas de un tipo y elige una — la propiedad destacada en el inicio, por ejemplo —, y el tema muestra el título, la imagen o el precio de esa entrada. Para varias referencias, como artículos relacionados, la IA pone un campo item dentro de un repeater. Si la entrada se elimina, el campo vuelve vacío.

El campo link guarda dirección, texto y “abrir en una pestaña nueva” en un solo recuadro. Acepta direcciones internas y externas, enlaces de correo y anclas (enlaces a un punto de la página), y un enlace en blanco nunca bloquea el guardado — así que pide un campo link, no tres.

Pídele a la IA

En el inicio, deja que el cliente elija la propiedad destacada entre las publicadas, más un botón con su propio texto y enlace. Si no hay ninguna propiedad elegida, oculta esa sección.

La IA usa un campo item para la propiedad y un campo link para el botón, y la plantilla omite la sección mientras el campo esté vacío.

Conjuntos de campos reutilizables

Cuando los mismos campos se repiten en varios lugares — dirección, teléfono y horario en Contacto y en cada sede de una cadena de clínicas —, la IA los declara una vez como un grupo de campos (field_groups) y lo reutiliza. Un cambio en el conjunto llega a todos los lugares que lo usan. No lo confundas con el tipo group, que solo dibuja un recuadro en el panel.

Lo que ejecuta la IA
# revisa cada campo, condición y nombre de fila $ ./bin/velk schema:validate ✓ site.json is valid. # muestra los campos de un tipo de contenido $ ./bin/velk item:schema property
schema:validate detecta lo que rompería el panel: una condición que apunta a un campo que no existe, un title_field de un tipo que no sirve para nombrar filas, dos pestañas con campos del mismo nombre.