Saltar al contenido principal

Resumen

Un Content Template es el blueprint que define la estructura, el tipo y el comportamiento de una familia de Content Instances. Un template fija el tipo de la familia, es dueño de los attributes personalizados que llevan sus instances, define reglas de authoring (workflow y publicación por defecto) y — para los templates de producto — define las columnas de line items y las opciones de variantes. Cada content instance se crea desde un template y hereda su tipo y su esquema de attributes. Para el panorama completo, consulta el overview de Content.

Dónde encontrarlo

Los content templates están en Content → Templates.

Tipos de template

El tipo de un template se elige al crearlo y no se puede cambiar después. Determina cómo se comportan las instances:
TipoPara qué sirveComportamiento específico del tipo
StoriesContenido editorial — artículos, posts, páginasContenido simple + versions.
ProductsBienes y servicios vendiblesAgrega opciones de commerce (abajo): item codes, SKU, precios, inventario, variantes. Impulsa Commerce.
LocationsLugares físicos o virtualesSe usan como locations de inventory en Commerce.
BlocksFragmentos de contenido reutilizablesContenido componible reutilizado dentro de otro contenido.
TaxonomiesÁrboles de categorizaciónDefine una taxonomy acotada a un object type; puede enlazarse a otro template.

Properties

PropertyTipoRequeridoDescripción
titlestringNombre visible del template.
slugstringIdentificador (a–z, 0–9, -); agrupa las instances del template.
descriptionstringNoDescripción opcional.
typeenumstories, products, locations, blocks o taxonomies — se define una vez, al crear.
taxonomy_object_typestringCondicionalSolo taxonomies — el object type que categoriza esta taxonomy.

Opciones de producto

Un template de products agrega un conjunto de flags de commerce que determinan cómo se validan sus instances y qué requieren:
OpciónEfecto
SellableEl producto se puede vender — puede ir en orders, tener precio y trackearse.
Manage inventorySe trackea el stock — las instances requieren un SKU, precio por defecto y costo estándar.
Manage serialsTracking por unidad (números de serie / asignación por unidad).
Allows variationsEl producto tiene múltiples SKUs (p. ej. talla × color), construidos desde opciones de variante.

Attributes

Un template es dueño de los attributes personalizados que se aplican al contenido de sus instances. Los attributes se definen contra el object type Content Version y se acotan al template, así que cada familia de contenido tiene sus propios campos — agrupados, tipados y validados.

Authoring

La configuración de authoring de un template fija los valores por defecto que heredan sus instances:
  • El workflow por defecto en el que arrancan las instances nuevas.
  • Las reglas de publicación de la familia.

Columnas de line items

Para los products, el template define las columnas y fórmulas que se muestran en los line items de una order — precio, cantidad, descuento, totales — y puede sobrescribirlas por tipo de order. Una order renderiza sus line items usando la configuración de columnas del product template, así que el mismo producto puede mostrar columnas distintas en una venta vs. una compra.

Variantes

Un product template con variations habilitado define sus opciones de variante (por ejemplo Talla y Color). Combinar las opciones genera los SKUs individuales del producto (item codes) en sus instances.

Comportamiento y reglas

  • El tipo es fijo al crear — eliges stories, products, locations, blocks o taxonomies al crear el template; no se puede cambiar después.
  • Eliminar está protegido — un template con instances activas no se puede eliminar; primero quita o archiva sus instances.
  • Validación de producto — las opciones de producto de arriba determinan qué deben proveer las instances (item codes, SKU, precios). Alinear las instances con la configuración de producto del template es obligatorio para que se guarden.
  • Las taxonomies requieren un taxonomy_object_type y pueden estar enlazadas a otro template para que ambos se mantengan en sincronía.

Seeds

Los content templates viajan entre entornos como Seeds estructurales. Una vez definida la estructura de un template, puedes cargar grandes volúmenes de sus registros con un seed de instance — ver Content Instances.
Tipo de seedSoportadoNotas
StructuralExport/import de fidelidad completa del template y sus attributes.
InstanceVía instancesLos instance seeds apuntan a las instances de un template, no al template.

Gobernanza y permisos

Solo un super admin o un Master puede crear, editar y eliminar content templates.

Acceso por API

Los content templates tienen CRUD completo, más operaciones para leer y fijar el workflow por defecto y para gestionar las opciones de variante de producto. Consulta la API reference.

Relacionado

Content Instances

Los registros creados desde un template.

Attributes

Los campos personalizados de los que un template es dueño.

Taxonomies

Templates de tipo taxonomy.

Guía: Crear un blog

Un template en acción, de principio a fin.