Zum Hauptinhalt springen

Manuelle URL-Blöcke (Produkt-Templates)

Mit manuellen URL-Blöcken können Sie PDFs auf Produkt-Templates anzeigen, ohne PDFs vorher in der App zu verknüpfen.

Verwenden Sie dies, wenn Sie eine oder mehrere identische PDF-URLs für ein ganzes Produkt-Template möchten (z. B. alle Produkte mit product oder product.custom).

Was manuelle Blöcke sind​

PDF Connect bietet zwei manuelle Produkt-Blöcke:

  • PDF Embedded Manual - Zeigt PDFs inline auf der Seite
  • PDF Button Manual - Zeigt anklickbare Buttons, die PDFs öffnen

Im Unterschied zu verknüpften Blöcken gelten bei manuellen Blöcken:

  • Es werden keine verknüpften Ressourcen gelesen
  • Es werden keine PDF-Metafelder gelesen
  • Keine Verknüpfung pro Produkt erforderlich
  • Rendering erfolgt ausschließlich aus Blockeinstellungen im Shopify-Theme-Editor

So fügen Sie manuelle Blöcke hinzu​

Aus der App (empfohlen)​

  1. Öffnen Sie in PDF Connect eine PDF-Detailseite
  2. Öffnen Sie das Dropdown Verknüpfen/Hinzufügen
  3. Wählen Sie PDF-Block zum Produkt-Template hinzufügen (manuelle URLs)
  4. Wählen Sie:
    • Ein Produkt-Template (z. B. product oder product.custom)
    • Blocktyp (pdf_embedded_manual oder pdf_button_manual)
  5. Fahren Sie fort und öffnen Sie den Shopify-Theme-Editor
  6. Fügen Sie eine oder mehrere PDF-URLs in die Blockeinstellungen ein
  7. Speichern Sie das Theme

Direkt im Shopify-Theme-Editor​

  1. Gehen Sie zu Onlineshop > Themes > Anpassen
  2. Öffnen Sie ein Produkt-Template
  3. Fügen Sie einen App-Block von PDF Connect hinzu
  4. Wählen Sie PDF Embedded Manual oder PDF Button Manual
  5. Tragen Sie URLs/Einstellungen ein und speichern Sie

Viewer-Typen in manuellen Blöcken​

Manuelle Blöcke unterstützen dieselben vier Viewer-Typen:

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

Bei manuellen Blöcken wird das Viewer-Verhalten in den Blockeinstellungen konfiguriert (nicht aus gespeicherter Pro-PDF-App-Konfiguration), und ein Viewer-Profil auf Blockebene gilt für alle URLs dieses Blocks.

Mehrere URLs und Labels​

  • Tragen Sie mehrere PDF-URLs zeilenweise ein.
  • Im manuellen Button-Block sind Labels optional und ebenfalls zeilenweise.
  • Wenn es weniger Labels als URLs gibt, verwenden verbleibende URLs Dateiname/Standardtext.

Verknüpfte Blöcke vs. manuelle Blöcke​

TypDatenquelleGeeignet für
Verknüpfte Blöcke (pdf_embedded, pdf_button)App-Verknüpfung + MetafelderPDF pro Ressource, Pro-PDF-Viewer-Konfiguration
Manuelle Blöcke (pdf_embedded_manual, pdf_button_manual)Nur Theme-Blockschema-EinstellungenVorlagenweite gemeinsame PDFs ohne Verknüpfung

Wichtige Einschränkungen​

  • Der aktuelle Rollout ist im frühen manuellen App-Flow auf Produkt-Templates begrenzt.
  • Manuelle Blöcke sind template-basiert, nicht ressourcenbasiert.
  • Manuelle Blöcke synchronisieren sich nicht automatisch mit PDF-Datensätzen in Ihrer App-Bibliothek.

Schnelle Troubleshooting-Checks​

Wenn ein manueller Block nichts anzeigt:

  1. Prüfen Sie, ob mindestens eine gültige https://-PDF-URL gesetzt ist
  2. Prüfen Sie, ob der Block zum aktiven Produkt-Template hinzugefügt wurde
  3. Speichern Sie Theme-Änderungen und führen Sie ein Hard-Refresh im Storefront aus
  4. Wechseln Sie testweise auf Native Browser, um viewer-spezifische Probleme zu isolieren

Nächste Schritte​