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)
- Abre una página de detalle de PDF en PDF Connect
- Abre el desplegable Vincular/Añadir
- Elige Add PDF block to product template (manual URLs)
- Selecciona:
- Una plantilla de producto (por ejemplo
productoproduct.custom) - Tipo de bloque (
pdf_embedded_manualopdf_button_manual)
- Una plantilla de producto (por ejemplo
- Continúa para abrir el editor de temas de Shopify
- Pega una o varias URLs de PDF en la configuración del bloque
- Guarda el tema
Directamente en el editor de temas de Shopify
- Ve a Tienda online > Temas > Personalizar
- Abre una plantilla de producto
- Añade un bloque de app desde PDF Connect
- Elige PDF Embedded Manual o PDF Button Manual
- 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
| Tipo | Fuente de datos | Mejor para |
|---|---|---|
Bloques vinculados (pdf_embedded, pdf_button) | Vinculación en app + metafields | PDFs por recurso, configuración por PDF |
Bloques manuales (pdf_embedded_manual, pdf_button_manual) | Solo ajustes del esquema del bloque en tema | PDFs 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:
- Confirma que hay al menos una URL
https://válida de PDF - Confirma que el bloque está en la plantilla de producto activa
- Guarda cambios del tema y haz recarga forzada en storefront
- Cambia temporalmente a Native Browser para aislar problemas del visor