Zum Hauptinhalt springen

Theme-Einrichtung

Fügen Sie PDF Connect Theme App Extensions zu Ihrem Shopify-Theme hinzu, damit Kunden PDFs auf Ihrer Storefront sehen können.

Warum Theme-Einrichtung wichtig ist​

PDFs zu verknüpfen und auf aktiv zu setzen reicht nicht aus. Sie müssen Theme App Extensions zu Ihrem Theme hinzufügen, damit PDFs in Ihrem Shop erscheinen.

Denken Sie so darüber:

  • Verknüpfung = PDFs mit Seiten/Ressourcen verbinden
  • Theme App Extensions = PDFs für Kunden im Theme-Editor sichtbar machen. Nur einmal pro Template erforderlich.

Beides ist erforderlich, um ein PDF auf Ihrer Storefront anzuzeigen.

Nur ein Konfigurationsschritt in Ihrer PDF-Einrichtung!

Zwei Möglichkeiten zum Veröffentlichen​

1. Direkt von der PDF-Detailseite veröffentlichen (Empfohlen)​

Der schnellste Weg, eine Theme App Extension hinzuzufügen:

  1. Öffnen Sie den Abschnitt Veröffentlichen auf der PDF-Detailseite
  2. Wenn die Theme App Extension noch nicht zum Theme-Template hinzugefügt wurde, sehen Sie eine Aufforderung zum Veröffentlichen
  3. Klicken Sie auf Veröffentlichen und wählen Sie den Anzeigestil (Eingebetteter Viewer oder Button)
  4. Ein neuer Tab oder ein neues Fenster öffnet sich zu Ihrem Theme-Editor mit bereits hinzugefügter Extension
  5. Passen Sie die Extension-Einstellungen bei Bedarf an und klicken Sie dann im Theme-Editor auf Speichern

2. Theme App Extension manuell über den Theme-Editor hinzufügen​

Für mehr Kontrolle über die Extension-Platzierung:

  1. Gehen Sie zu Onlineshop > Themes
  2. Klicken Sie auf Anpassen bei Ihrem aktiven Theme
  3. Navigieren Sie zu einer Seite, auf der Sie ein PDF verknüpft haben (z. B. eine Produktseite)
  4. Klicken Sie auf Abschnitt hinzufügen oder Block hinzufügen (abhängig von Ihrem Theme)
  5. Suchen Sie nach PDF Connect im Apps-Bereich
  6. Fügen Sie entweder PDF Embedded Viewer oder PDF Button hinzu
  7. Klicken Sie auf Speichern

Oder siehe Anzeigeoptionen anpassen →

Wo Sie PDF Connect Theme App Extensions finden​

PDF Connect Theme App Extensions erscheinen unter Apps in Ihrem Theme-Editor. Suchen Sie nach:

  • PDF Embedded Viewer - Zeigt PDFs inline auf der Seite an
  • PDF Button - Zeigt anklickbare Buttons, die PDFs im Overlay öffnen

Beide Extensions sind für alle unterstützten Seitentypen verfügbar.

Unterstützte Seitentypen​

Fügen Sie PDF Connect Extensions zu diesen Seiten-Templates hinzu:

  • Produktseiten - Produkt-Template-Editor
  • Kollektionsseiten - Kollektions-Template-Editor
  • Seiten - Seiten-Template-Editor
  • Blog - Blog-Template-Editor
  • Artikel - Blog-Artikel-Template-Editor
  • Homepage - Index-Template-Editor
  • Suchseite - Such-Template-Editor

Position your extensions​

Control where PDFs appear:

Product pages:

  • Above Add to Cart button
  • In a separate tab
  • Below product description
  • In sidebar

Collection pages:

  • Above product grid
  • Below collection description
  • In sidebar

Other pages:

  • Above main content
  • Below main content
  • In dedicated sections

Position depends on your theme's section structure.

One extension shows all linked PDFs​

You only need to add one Theme App Extension per page type:

  • Add PDF Button extension to product template
  • Extension automatically shows PDFs for every product
  • Displays only PDFs linked to that specific product
  • No need to add extensions to individual products
  • If you need to exclude a PDF see Display PDF by Extension Type →

Same applies to collections, pages, and other resources.

Theme App Extension settings​

Customize how extensions appear on your page (not the PDF viewer features):

For Embedded Viewer extension:

  • Show heading (toggle)
  • Heading text
  • Viewer height (percentage of viewport, desktop only)
  • Show container border

For PDF Button extension:

  • Show heading (toggle)
  • Heading text
  • Button text and text source (generic, PDF name, or description)
  • Button alignment (left, center, right)
  • Button text alignment
  • Multiple PDFs layout (vertical or horizontal)
  • Show PDF icon
  • Show container border
  • Button background color
  • Button text color
  • Button hover background color
  • PDF viewer modal size (60%, 70%, 80%, 90%)

For PDF viewer features (zoom, download, toolbar, navigation, etc.), configure those in the app's PDF details page. Learn about viewer configuration →

Mix display styles​

You can use different display styles on different page types:

  • Embedded viewer on product pages
  • Button display on collection pages
  • Embedded on homepage

Or mix them on the same page if your theme allows multiple extensions.

Themes without Theme App Extension support​

Older or custom themes might not support Theme App Extensions:

  1. Check if your theme is compatible with Theme App Extensions
  2. Update to a newer theme version if needed
  3. Contact theme developer for support
  4. Consider switching to an Online Store 2.0 compatible theme

Most modern Shopify themes (Online Store 2.0) support Theme App Extensions.

Preview before publishing​

Test your setup before going live:

  1. Add extensions in theme editor
  2. Use the preview to see how PDFs look
  3. Try both display styles
  4. Check on mobile preview
  5. Make adjustments as needed
  6. Click Save when satisfied

Remove extensions​

To remove PDF display from a page type:

  1. Go to theme editor
  2. Navigate to that page type
  3. Find the PDF Connect extension
  4. Click the extension settings
  5. Choose Remove block
  6. Click Save

This hides PDFs without unlinking them.

Troubleshooting display issues​

PDFs don't appear:

  • Verify extension is added to correct page type
  • Check PDF status is Active
  • Confirm PDF is linked to the resource
  • Refresh the page

Extension not in Apps section:

  • Theme might not support Theme App Extensions
  • Try updating theme
  • Check theme compatibility (requires Online Store 2.0)

Wrong PDFs showing:

  • Verify you're viewing the correct resource
  • Check linking in PDF library
  • Review template filters (if used)

View full troubleshooting guide →

Next steps​