Saltar al contenido principal

Bloques URL manuales (plantillas de producto)

Los bloques URL manuales te permiten mostrar PDFs en plantillas de producto sin vincularlos primero en la app.

Úsalo cuando quieras una o varias URLs de PDF iguales para toda una plantilla de producto (por ejemplo, todos los productos que usan product o product.custom).

Qué son los bloques manuales

PDF Connect ofrece dos bloques manuales de producto:

  • PDF Embedded Manual - Muestra PDFs integrados en la página
  • PDF Button Manual - Muestra botones clicables que abren PDFs

A diferencia de los bloques vinculados, los bloques manuales:

  • No leen recursos vinculados
  • No leen metafields de PDF
  • No requieren vinculación por producto
  • Se renderizan solo desde la configuración del bloque en el editor de temas de Shopify

Cómo añadir bloques manuales

Desde la app (recomendado)

  1. Abre una página de detalle de PDF en PDF Connect
  2. Abre el desplegable Vincular/Añadir
  3. Elige Add PDF block to product template (manual URLs)
  4. Selecciona:
    • Una plantilla de producto (por ejemplo product o product.custom)
    • Tipo de bloque (pdf_embedded_manual o pdf_button_manual)
  5. Continúa para abrir el editor de temas de Shopify
  6. Pega una o varias URLs de PDF en la configuración del bloque
  7. Guarda el tema

Directamente en el editor de temas de Shopify

  1. Ve a Tienda online > Temas > Personalizar
  2. Abre una plantilla de producto
  3. Añade un bloque de app desde PDF Connect
  4. Elige PDF Embedded Manual o PDF Button Manual
  5. Completa URLs/ajustes y guarda

Tipos de visor en bloques manuales

Los bloques manuales admiten los mismos cuatro tipos de visor:

  • Native Browser
  • Custom Viewer (PDF.js)
  • Flipbook
  • Light Viewer

En bloques manuales, el comportamiento del visor se configura en los ajustes del bloque (no desde configuración guardada por PDF en la app), y un perfil de visor por bloque aplica a todas las URLs de ese bloque.

Múltiples URLs y etiquetas

  • Introduce múltiples URLs de PDF separadas por salto de línea.
  • En el bloque manual de botón, las etiquetas son opcionales y también separadas por línea.
  • Si hay menos etiquetas que URLs, las URLs restantes usan nombre de archivo/texto por defecto.

Bloques vinculados vs manuales

TipoFuente de datosMejor para
Bloques vinculados (pdf_embedded, pdf_button)Vinculación en app + metafieldsPDFs por recurso, configuración por PDF
Bloques manuales (pdf_embedded_manual, pdf_button_manual)Solo ajustes del esquema del bloque en temaPDFs compartidos por plantilla sin vinculación

Limitaciones importantes

  • El despliegue actual está limitado a plantillas de producto en el flujo manual inicial de la app.
  • Los bloques manuales son por plantilla, no por recurso.
  • Los bloques manuales no se sincronizan automáticamente con registros PDF de tu biblioteca en la app.

Comprobaciones rápidas de resolución

Si un bloque manual no muestra contenido:

  1. Confirma que hay al menos una URL https:// válida de PDF
  2. Confirma que el bloque está en la plantilla de producto activa
  3. Guarda cambios del tema y haz recarga forzada en storefront
  4. Cambia temporalmente a Native Browser para aislar problemas del visor

Próximos pasos