Landinker

Productos en Landings

Objetivo

Esta guía explica cómo vincular productos dentro del editor de landings y cómo mostrarlos correctamente en producción.

Módulos disponibles

• ProductsGrid: lista productos (opcionalmente por categoría).
• ProductTitle: nombre.
• ProductPrice: precio y descuento.
• ProductImage: imagen.
• ProductDescription: descripción.
• ProductCategory: categoría.

Formas de vincular un producto

1. productId fijo

Asignás directamente un ObjectId de producto.

Ejemplo:

• productId: "67f2c1ab8f6d0f1a2b3c4d5e"

Cuándo usarlo:

• Landings estáticas de un producto puntual.
• Secciones destacadas con un producto específico.

2. productId dinámico

Asignás una variable que viene del path dinámico.

Ejemplo:

• Path: /producto/:idProducto
• Variable: {{IDPRODUCTO}}
• En componente: productId: "{{IDPRODUCTO}}"

Cuándo usarlo:

• Plantillas reutilizables para múltiples productos.
• URLs de detalle dinámicas.

Configuración paso a paso (dinámico)

1. Definí un path dinámico, por ejemplo /producto/:idProducto.
2. En módulos de producto (ProductTitle, ProductPrice, ProductImage, ProductDescription, ProductCategory), usá productId: "{{IDPRODUCTO}}".
3. Publicá la landing.
4. Probá una URL real, por ejemplo /producto/67f2c1ab8f6d0f1a2b3c4d5e.

ProductsGrid y navegación a detalle

ProductsGrid soporta cardClickLink con {{card_product_id}}.

Ejemplo:

• cardClickLink: "/producto/{{card_product_id}}"

Resultado:

• Cada tarjeta abre la landing de detalle del producto clickeado.

Qué pasa si no se encuentra un producto

Podés controlar la estrategia con strictProductResolution en root props:

• false:

  • Se ocultan los componentes de producto faltantes.
  • La landing sigue renderizando el resto del contenido.

• true:

  • Si falta un producto requerido, la landing puede resolverse como no encontrada (404).

Recomendación:

• Landings de campaña o mixtas: false.
• Landings de detalle por URL: true.

Buenas prácticas

• Usar nombres de segmentos claros (:idProducto, :slug, :categoria).
• Mantener consistencia de IDs y paths al publicar.
• Probar siempre:
  • un ID válido,
  • un ID inválido,
  • y el comportamiento esperado según strictProductResolution.

Solución de problemas rápida

• No aparece contenido de producto:
  • Revisá productId del componente.
  • Si es dinámico, validá el mapping (:idProducto -> {{IDPRODUCTO}}).
• Aparece 404 y no debería:
  • Revisá strictProductResolution.
  • Confirmá que el producto exista y esté activo.
• El grid aparece vacío:
  • Verificá productos activos del grupo.
  • Si hay filtro por categoría, confirmá coincidencia exacta.