Saltar al contenido principal

Controlar la visualización de PDFs por tipo de extensión

Cuando múltiples PDFs están vinculados al mismo recurso y tu plantilla tiene ambas extensiones de aplicación de tema (integrado y botón), puedes controlar qué PDFs aparecen en cada extensión.

El desafío con múltiples PDFs​

Cuando vinculas múltiples PDFs al mismo recurso (como un producto) y agregas tanto el Visor PDF integrado como las extensiones de Botón PDF a la plantilla:

Comportamiento predeterminado: Todos los PDFs vinculados se muestran en AMBAS extensiones

Lo que podrías querer: Diferentes PDFs en cada extensión

Escenario de ejemplo:

  • Manual del producto → Mostrar solo en el visor integrado debajo de la descripción del producto
  • Información de garantía → Mostrar solo en la extensión de botón al final de la página

Cuándo aparece la opción​

Las casillas de verificación para controlar la visualización de la extensión solo aparecen cuando:

  1. Has vinculado múltiples PDFs al mismo recurso
  2. La plantilla tiene AMBAS extensiones de aplicación de tema agregadas (integrado Y botón)

Verás esto en la sección Publicar de la página de detalles del PDF.

Usar las casillas de control de extensión​

En la sección Publicar, verás:

Extensiones publicadas:
☑ pdf_embedded (habilitado)
☑ pdf_button (habilitado)

Para ocultar un PDF de una extensión específica:

  • Desmarca la casilla para ese tipo de extensión
  • El PDF se elimina del array de plantilla de esa extensión
  • El PDF ya no aparecerá en esa extensión

Ejemplo:

Extensiones publicadas:
☑ pdf_embedded (habilitado)  ← El PDF se muestra en el visor integrado
☐ pdf_button (deshabilitado)   ← PDF oculto de la extensión de botón

Casos de uso​

Escenario 1: Contenido principal vs. complementario​

Producto con 2 PDFs:

  • Manual de usuario (principal) → Solo visor integrado
  • Tarjeta de garantía (complementario) → Solo extensión de botón

Configuración:

  1. Vincula ambos PDFs al producto
  2. Agrega ambas extensiones a la plantilla del producto
  3. Manual de usuario: ☑ integrado, ☐ botón
  4. Tarjeta de garantía: ☐ integrado, ☑ botón

Escenario 2: Referencia rápida vs. documentos detallados​

Colección con 3 PDFs:

  • Guía de compra rápida → Visor integrado
  • Catálogo completo → Extensión de botón
  • Tabla de tallas → Extensión de botón

Configuración:

  1. Vincula todos los PDFs a la colección
  2. Agrega ambas extensiones a la plantilla de colección
  3. Guía rápida: ☑ integrado, ☐ botón
  4. Catálogo completo: ☐ integrado, ☑ botón
  5. Tabla de tallas: ☐ integrado, ☑ botón

Escenario 3: Mostrar todos los PDFs en ambas extensiones​

Producto con múltiples manuales:

  • Todos los PDFs disponibles tanto en el visor como en el botón

Configuración:

  1. Vincula todos los PDFs
  2. Agrega ambas extensiones
  3. Mantén todas las casillas marcadas (predeterminado)

Seguimiento de archivos de plantilla​

Para cada PDF, la aplicación rastrea:

Ejemplo de plantilla de artículo:

article.articleTemp2 - 1 extensión
  Extensiones publicadas:
    pdf_button

blog.blogTemp2 - 2 extensiones
  Extensiones publicadas:
    ☑ pdf_embedded (habilitado)
    ☐ pdf_button (deshabilitado)

Esto muestra:

  • La plantilla de artículo solo tiene la extensión de botón
  • La plantilla de blog tiene ambas extensiones, pero este PDF solo se muestra en el visor integrado

Gestión de múltiples plantillas​

Si el mismo tipo de recurso usa diferentes archivos de plantilla, verás cada plantilla listada por separado con sus propios controles de extensión:

Páginas de artículos - Publicadas

  article.articleTemp1 - 1 extensión
    ☑ pdf_button

  article.articleTemp2 - 1 extensión  
    ☑ pdf_button

Cada plantilla puede tener diferentes configuraciones de extensión para el mismo PDF.

Mejores prácticas​

Comienza simple​

Empieza con una extensión de aplicación de tema por plantilla. Agrega la segunda extensión solo si necesitas una organización diferente de PDFs.

Planifica tu jerarquía de PDFs​

Antes de agregar ambas extensiones, decide qué PDFs son principales (integrados) vs. complementarios (botón).

Usa patrones consistentes​

Si usas ambas extensiones en múltiples plantillas, mantén asignaciones similares de PDFs para una gestión más fácil.

Prueba la experiencia del cliente​

Visualiza tus páginas como lo haría un cliente: asegúrate de que los PDFs correctos aparezcan en los lugares correctos.

Solución de problemas​

Las casillas de verificación no aparecen:

  • Solo se agregó un tipo de extensión a la plantilla
  • Agrega ambas extensiones para ver las casillas de verificación

El PDF aparece en la extensión incorrecta:

  • Verifica la configuración de las casillas de verificación en la sección Publicar
  • Verifica que estás viendo el archivo de plantilla correcto

El PDF no aparece en ninguna parte:

  • Al menos una casilla de verificación debe estar marcada
  • Verifica que el PDF esté vinculado al recurso
  • Verifica que el estado del PDF sea Activo

Los cambios no se muestran en la tienda:

  • Actualiza la página (puede tomar unos segundos)
  • Limpia la caché del navegador
  • Verifica que guardaste los cambios en la aplicación

Próximos pasos​