Zum Hauptinhalt springen

Anzeigeprobleme beheben

Beheben Sie häufige Probleme, wenn PDFs nicht auf Ihrer Storefront erscheinen.

PDFs werden überhaupt nicht angezeigt​

Überprüfen Sie diese drei Anforderungen:

✅ PDF ist verknüpft mit der Ressource (Produkt, Seite usw.)
✅ PDF-Status ist Aktiv (nicht inaktiv)
✅ Theme App Extension hinzugefügt zu Ihrem Theme

Alle drei müssen zutreffen. Überprüfen Sie jedes einzeln:

  1. Öffnen Sie Ihre PDF-Bibliothek
  2. Klicken Sie auf das PDF, das erscheinen sollte
  3. Überprüfen Sie, ob es mit der richtigen Ressource verknüpft ist
  4. Prüfen Sie, ob Status auf Aktiv gesetzt ist
  5. Gehen Sie zum Theme-Editor und bestätigen Sie, dass die Extension hinzugefügt ist

Wenn Sie manuelle Blöcke verwenden (PDF Embedded Manual oder PDF Button Manual), gelten diese Prüfungen für verknüpfte PDFs nicht. Verwenden Sie stattdessen die manuellen Prüfungen unten.

Manueller URL-Block zeigt nichts an​

  1. Prüfen Sie, ob mindestens eine gültige https://...pdf-URL eingetragen ist
  2. Prüfen Sie, ob der Block im aktiven Produkt-Template liegt
  3. Speichern Sie im Theme-Editor und führen Sie ein Hard-Refresh im Storefront aus
  4. Setzen Sie den Viewer-Typ testweise auf Native Browser, um viewer-spezifische Parameterprobleme zu isolieren
  5. Wenn Sie manuelle Button-Labels verwenden: Anzahl der Label-Zeilen muss zur Anzahl der URL-Zeilen passen

PDFs erscheinen auf falschen Seiten​

Mögliche Ursachen:

Falsche Ressource verknüpft

  • Überprüfen Sie, mit welchen Ressourcen das PDF verknüpft ist
  • Entknüpfen Sie von falschen Ressourcen
  • Verknüpfen Sie mit richtigen Ressourcen

Template-Filter-Fehlanpassung

  • Template-Filtereinstellungen überprüfen
  • Überprüfen Sie, ob die Seite das erwartete Template verwendet
  • Template-Filter entfernen oder anpassen

Mehr über Template-Filterung erfahren →

Einige PDFs werden angezeigt, andere nicht​

Einzelnen PDF-Status überprüfen:

  • Versteckte PDFs sind wahrscheinlich auf Inaktiv gesetzt
  • Status auf Aktiv ändern für fehlende PDFs

Template-Filter überprüfen:

  • Einige PDFs könnten Template-Filter angewendet haben
  • Filtereinstellungen für nicht angezeigte PDFs überprüfen

Theme App Extension nicht im Theme-Editor​

Theme-Kompatibilitätsproblem:

Ihr Theme unterstützt möglicherweise keine App-Extensions:

  1. Theme-Dokumentation auf App-Extension-Unterstützung prüfen
  2. Theme auf neueste Version aktualisieren
  3. Theme-Entwickler um Support kontaktieren
  4. Wechsel zu einem Extension-kompatiblen Theme in Betracht ziehen

Die meisten modernen Shopify-Themes (2.0+) unterstützen App-Extensions.

PDFs laden langsam​

Dateigröße optimieren:

  • PDFs vor dem Hochladen komprimieren
  • Dateien wenn möglich unter 5 MB halten
  • Unnötige Seiten oder Bilder entfernen

Internetverbindung prüfen:

  • Langsame Verbindungen beeinflussen das Laden
  • In einem anderen Netzwerk testen
  • Mobile Daten vs. WLAN ausprobieren

Button-Anzeige verwenden:

  • Button-Stil lädt schneller als eingebettet
  • Kunden laden nur PDFs, die sie anklicken
  • Besser für Mobilnutzer

Eingebetteter Viewer zeigt leer an​

PDF könnte beschädigt sein:

  • Versuchen Sie, das PDF erneut hochzuladen
  • Öffnen Sie das PDF zuerst auf Ihrem Computer, um zu überprüfen, ob es funktioniert
  • PDF mit anderer Software neu speichern

Browser-Kompatibilität:

  • Anderen Browser ausprobieren
  • Browser auf neueste Version aktualisieren
  • Browser-Cache leeren

Falsches PDF erscheint​

Verknüpfungen überprüfen:

  • Verknüpfte Ressourcen für dieses PDF anzeigen
  • Von Seiten entknüpfen, auf denen es nicht erscheinen sollte
  • Überprüfen Sie, ob das richtige PDF mit jeder Ressource verknüpft ist

Mehrere PDFs verknüpft:

  • Wenn mehrere PDFs verknüpft sind, erscheinen alle
  • Ungewünschte PDFs entknüpfen
  • Bei Bedarf neu ordnen

Für manuelle Blöcke prüfen Sie stattdessen die URL-Zeilen direkt in den Blockeinstellungen.

PDF-Button öffnet nicht​

JavaScript-Problem:

  • Browser-Konsole auf Fehler prüfen
  • Anderen Browser ausprobieren
  • Konflikt verursachende Apps vorübergehend deaktivieren

Theme-Konflikt:

  • Einige Themes blockieren Popups
  • Theme-Einstellungen prüfen
  • Theme-Entwickler kontaktieren

Template-Filterung funktioniert nicht​

Häufige Fehler:

Falscher Template-Name:

  • Template-Namen sind case-sensitiv
  • Rechtschreibung sorgfältig prüfen
  • Überprüfen Sie, ob Template in Ihrem Theme existiert

Template nicht aktiv:

  • Seite verwendet möglicherweise anderes Template
  • Tatsächliches Template im Theme-Editor prüfen
  • Richtiges Template der Seite zuweisen

Template-Probleme beheben →

Änderungen erscheinen nicht​

Cache-Verzögerung:

  • 30-60 Sekunden nach Änderungen warten
  • Seite neu laden (Hard Refresh: Cmd/Strg + Umschalt + R)
  • Browser-Cache bei Bedarf leeren

Theme nicht gespeichert:

  • Stellen Sie sicher, dass Sie im Theme-Editor auf Speichern geklickt haben
  • Auf Indikator für nicht gespeicherte Änderungen prüfen

Immer noch Probleme?​

Probieren Sie diese Schritte:

  1. Alles aktualisieren:

    • Hard Refresh des Browsers
    • Theme im Editor neu speichern
    • Einige Minuten warten

  2. Im Inkognito-Modus testen:

    • Öffnet neue Browser-Sitzung
    • Umgeht Cache-Probleme
    • Schließt Browser-Erweiterungen aus

  3. Verschiedene Seiten prüfen:

    • Andere Ressource (Produkt/Seite) anzeigen
    • Homepage vs. Produktseite testen
    • Isolieren, wo das Problem auftritt

  4. Support kontaktieren:

    • Beschreiben Sie, was Sie sehen vs. was Sie erwarten
    • Screenshots wenn möglich teilen
    • Ihren Theme-Namen erwähnen
    • Plan-Typ angeben

Nächste Schritte​