Builder PDF Presenter

English

Kurzvorstellung

PDFs mit wenig Aufwand veröffentlichen: leichte Titelbild-Karten zum Stöbern und ein komfortabler Reader, der bei Bedarf öffnet. Für Vereinszeitschriften, Protokolle, Gemeindebriefe und Dokumentarchive in beliebigen geeigneten Inhaltstypen.

Deine Daten in deinem WordPress. Punkt. Kostenlos, ohne Werbung, Lesertracking oder Pro-Version.

Version 1.0.0 · WordPress 6.9+ · PHP 8.3+

Einstieg · Anleitung · Fragen nach Themen · Anwendungsbeispiele

Inhalt

• Auf einen Blick
• Einstieg
• Feature Highlights
• Häufige Fragen
• Änderungsverlauf
• Zum Projekt
• Hilfe, Sicherheit und Unterstützung

Auf einen Blick

• Einzelne PDF oder sortierbare Sammlung je Beitrag, Seite oder eigenständigem Block.
• Drei Kartendesigns: Titelbild, kompakt und Dokumentliste; responsive Raster.
• Lokaler PDF.js-Reader im Modal oder neuen Tab; direkter Dateiaufruf ebenfalls möglich.
• Einstellbare Lesen-/Download-Buttons, Beschriftungen, Titelbilder und Reader-Funktionen.
• Globale Vorgaben mit Ausnahmen je Inhaltstyp, Beitrag und Dokument.
• Block-Editor-Block, acht Patterns, Shortcodes und drei native Bricks-Elemente.
• Optionales zentrales Reader-Wasserzeichen; ausdrückliche PDF-Poster-Migration mit Wiederherstellung.
• Lokale Website-Zustand-Prüfungen und berechtigungsabhängige Schnellzugriffe in der Befehlspalette.

Einstieg

1. Plugin-ZIP unter Plugins → Plugin hinzufügen → Plugin hochladen installieren und aktivieren.
2. Einstellungen → Builder PDF Presenter öffnen. Inhaltstypen mit PDF-Verwaltung auswählen und globale Vorgaben festlegen.
3. Im Beitrag PDFs aus der Mediathek wählen oder hochladen. Reihenfolge und Anzeigetitel bei Bedarf anpassen.
4. Den Block „Builder PDF Presenter“ einfügen und zugeordnete Dokumente verwenden. Alternativ direkt im Block eine eigene Sammlung erstellen, [builder_pdf_presenter] oder ein natives Bricks-Element verwenden.
5. Seite ansehen und Lesen/Download testen. Änderungen vor dem Verlassen der Einstellungsseite speichern.

PDFs einbinden: Unter Einstellungen → Builder PDF Presenter → PDFs einbinden werden die Einbindungswege erklärt. [builder_pdf_presenter] funktioniert im Shortcode-Block oder Classic Editor; die Shortcode-Referenz enthält alle Parameter mit Beispielen. Alternativ stehen Block-Editor-Blöcke/Patterns und native Bricks-Elemente bereit.

Von einem anderen PDF-Plugin wechseln: Unter Werkzeuge → PDF-Migration unterstützte PDF-Poster-/PDF-Embedder-Inhalte prüfen und ausgewählte Beiträge umstellen. Die Migrationsanleitung erklärt unterstützte Formate, Ergebnisberichte und Wiederherstellung.

Bricks und Meta Box sind nicht erforderlich. Die native Bricks-Integration wurde mit Bricks 2.4.5 getestet. Ein mit Bricks gebautes Layout benötigt weiterhin Bricks; ein Theme-Wechsel wandelt es nicht in Block-Editor um.

Feature Highlights

Schnelle Übersicht, Reader bei Bedarf

Das Raster zeigt normale Titelbilder. Es startet nicht für jede Karte einen eigenen PDF.js-Reader. Der Reader lädt erst beim Öffnen eines Dokuments. Große Original-PDFs können weiterhin Ladezeit benötigen; die Übersicht komprimiert die Dateien nicht.

Einfache Dokumentpflege

Mehrere PDFs auswählen oder hochladen, sortieren, Anzeigetitel bearbeiten, Dateien ersetzen und Titelbilder zuweisen. Administratoren begrenzen die Anzahl. Ein niedrigeres Limit entfernt keine vorhandenen Einträge.

Einheitliche Vorgaben und passende Ausnahmen

Übliche Einstellungen an einer Stelle pflegen. Inhaltstypen, Beiträge und Dokumente können übernehmbare Werte überschreiben. Die feste Speicherleiste zeigt ungespeicherte Änderungen; nach einem Speicherfehler bleiben die Eingaben erhalten.

Block-Editor und native Bricks-Abläufe

Block-Editor-Farb-, Typografie-, Abstands- und weitere unterstützte Stiloptionen gestalten den jeweiligen Block. Die kompakte Leiste „PDF Presenter · Block“ gehört nur zum Editor. In Bricks arbeitet „PDF-Dokument“ innerhalb von Beitragsabfragen, „PDF-Sammlung“ zeigt die Dokumente eines Beitrags. Native Stile, Dynamic Tags und Conditions bleiben nutzbar.

Zentrales Reader-Branding

Administratoren aktivieren eine gemeinsame Wasserzeichenvorlage mit Text/Logo und erlauben bei Bedarf Ein-/Aus-Ausnahmen je Dokument. Die Einblendung betrifft nur den Reader; Originale und Downloads bleiben unverändert.

Bewusst überschaubar

Keine Flipbook-Effekte, Pro-Version, Werbung, Leserstatistik oder Cloud-Synchronisierung. Ausgeblendete Download-Buttons sind kein Kopierschutz. Dokumentdateien und Titelbilder behalten die bestehenden Zugriffsregeln des Servers.

Sortieren und wiederfinden

Benannte Sammlungen lassen sich nach Titeln und Dateinamen durchsuchen, sortieren und nach Dateigröße filtern. Die Suche erfasst die gesamte zugängliche Sammlung vor der Seitennavigation, keine PDF-Inhalte. Fertige Patterns verbinden Raster und Filterleiste, auch in einer Sidebar.

Häufige Fragen

Brauche ich einen Builder oder ein Custom-Field-Plugin?

Nein. Der Kern funktioniert mit Block-Editor und Shortcodes. Bricks ist optional.

Kann ein Beitrag mehrere PDFs enthalten?

Ja. Eine sortierbare Sammlung im Beitrag oder direkt im Block anlegen und als Karten oder Liste anzeigen.

Kann ich ein Archiv über mehrere Beiträge erstellen?

Ja. Die Beitragsabfrage des Blocks oder einen nativen Query Loop verwenden. Die Plugin-Abfrage zeigt das erste oder alle PDFs je Quellbeitrag und filtert alle zugänglichen Ergebnisse vor der Paginierung.

Warum fehlt ein Vorschaubild?

Automatische PDF-Vorschauen hängen vom Server ab. Eine fehlende Vorschau erzeugen, sofern unterstützt, oder ein eigenes Titelbild auswählen.

Ist das ein Dateischutz- oder Mitgliedersystem?

Nein. Button-Sichtbarkeit schützt keine Datei. Vorhandene Server-Berechtigungen gelten weiterhin.

Verändert das Wasserzeichen die Downloads?

Nein. Es erscheint ausschließlich im eingebetteten Reader.

Gibt es eine Pro-Version oder Lesertracking?

Nein. Es gibt keine Pro-Version, kein Upselling und kein Lesertracking durch das Plugin.

Alle Fragen und Antworten lesen →

Änderungsverlauf

1.0.0 · 2026-11-06

• Neu: PDF-Karten mit Vorschau, Reader und Download für einzelne Dokumente und Sammlungen.
• Neu: Globale Vorgaben und individuelle Einstellungen für beliebige Inhaltstypen.
• Neu: Block-Editor, Shortcodes und native Bricks-Integration einschließlich Metadatenfiltern und Sortierung.
• Neu: Migration von PDF Poster und PDF Embedder mit Ergebnisbericht und Wiederherstellung.

Zum Projekt

Seit Jahren brauchten Kunden aus Vereinen und Gemeinden eine einfache PDF-Veröffentlichung. Fehlende Funktionen, Upselling und umständliche Bedienung standen immer wieder im Weg. Ein Kundenprojekt im Herbst 2026 war schließlich der Anlass für meine eigene Lösung.

— David Decker · Die Entstehungsgeschichte

Hilfe, Sicherheit und Unterstützung

Anleitung · Fragen nach Themen · Plugin-Website

Sicherheitslücken vertraulich melden; dazu die Sicherheitsrichtlinie beachten. Keine Kundendateien, Zugangsdaten oder Exploit-Details öffentlich in Hilfeanfragen teilen.

Das Projekt unterstützen: Ko-fi · Buy Me a Coffee · PayPal.

© 2026 David Decker – DECKERWEB. Plugin-Lizenz: GPL v2 oder höher. PDF.js: Apache-2.0, siehe vendor/pdfjs/LICENSE. Eingebundene deckerweb-Komponenten behalten ihre Lizenzhinweise. Eigene PDF-Presenter-UI-Symbole von David Decker – DECKERWEB. Verbliebene Tabler-Hinweise: vendor/tabler/LICENSE.

Marketinggrafiken: eigene Vektorgrafiken von David Decker – DECKERWEB. Schriftzüge aus Bricolage Grotesque und Manrope unter SIL OFL 1.1; Lizenztexte unter assets/branding/licenses.

Anleitung

English · Überblick · Fragen nach Themen

Den passenden Ablauf wählen

Ein Beitrag mit einem oder mehreren Dokumenten: Unter Einstellungen → Builder PDF Presenter den Inhaltstyp aktivieren. PDFs im Dokumentbereich hinzufügen und den Block mit „Diesem Beitrag zugeordnete Dokumente“ einfügen. Eine Zuordnung fügt die PDF nicht automatisch in andere Beiträge ein.

Ein eigenständiger Block: „Eigene PDF-Sammlung“ wählen und Dateien auswählen oder hochladen. Diese Zuordnungen gehören zum Block. Dokumente dort sortieren und Anzeigetitel festlegen. Das Entfernen eines Eintrags aus der Sammlung löscht nicht die Mediathek-Datei.

Ein Archiv über mehrere Beiträge: „Dokumentbeiträge abfragen“ wählen, Inhaltstyp und erstes oder alle PDFs auswählen. Leere Zuordnungen belegen keine Ergebnisplätze. Sammlungs-ID und Seitengröße verbinden Filter und Seitennavigation.

Einstellungen und Speichern

Die linke Navigation springt zu Inhalt/Pflege, Karten, Buttons, Reader, Inhaltstyp-Ausnahmen, Wasserzeichen und Vorschau. Alles bleibt ein Formular; ein Bereichswechsel behält die Eingaben. Auf kleinen Bildschirmen erscheint die Navigation oben.

Die feste untere Leiste zeigt gespeicherte oder ungespeicherte Änderungen. Ein Punkt neben „Änderungen speichern“ kennzeichnet ebenfalls offene Eingaben. Speichern erfolgt ohne Seitenwechsel; bei einem Fehler bleiben die Felder für einen erneuten Versuch erhalten. Beim Verlassen mit offenen Änderungen warnt der Browser, soweit unterstützt. Ohne JavaScript bleibt das normale WordPress-Formular nutzbar.

Die Vererbung läuft von eingebauten Vorgaben über globale und Inhaltstyp-Vorgaben zu Beitrag und Dokument/Ausgabe. „Übernehmen“ verwendet die vorherige Ebene. Sammlungslimits und Wasserzeichenrichtlinie bleiben administrative Vorgaben. Ein niedrigeres Limit entfernt keine vorhandenen Dokumente.

Block-Editor gestalten

Die Leiste „PDF Presenter · Block“ ist nur für die Bedienung im Editor da, keine Seitenüberschrift. „Bearbeiten“ öffnet die Dokumentpflege, „Vorschau“ zeigt die Karten. „Reader testen“ öffnet einen ausdrücklichen Testlink. Block-Stile gestalten die Ausgabe, nicht die Werkzeugleiste. Das Theme bestimmt mit, welche nativen Block-Editor-Stilbereiche angeboten werden.

Titelbild-Karten, kompakte Karten oder Dokumentliste verwenden. Einheitliche Rahmen oder Originalproportionen wählen. Titel und Dateiangaben sollen Dokumente unterscheidbar machen. Sehr lange Buttontexte in schmalen Spalten vermeiden.

Bricks

PDF-Dokument: Im nativen Beitrags-Query-Loop einsetzen oder eine PDF ausdrücklich auswählen. Ohne Datei gilt das erste zugeordnete PDF des aktuellen/gewählten Quellbeitrags. Der Hinweis im Builder erklärt die Quelle. Das Element ist keine Dateikopie.

PDF-Sammlung: Alle zugeordneten Dokumente eines Quellbeitrags anzeigen. Die inneren Spalten steuert das Plugin. Alternativ eine Plugin-Abfrage über Inhaltstypen wählen. Dafür sind die Plugin-Filter vorgesehen.

Für gleich hohe Abfragekarten die Kinder des äußeren Rasters strecken und die PDF-Elemente im Schleifen-Container mitstrecken lassen. Die native Plugin-Hülle füllt diese verfügbare Höhe; Buttons bleiben unten. Keine feste Pixelhöhe nötig. Abweichende eigene Elternausrichtungen können das Ergebnis weiterhin verändern.

Dynamic Tags: {bpp_count}, {bpp_id}, {bpp_title}, {bpp_url}, {bpp_reader_url}, {bpp_cover}. Außer der Anzahl beziehen sie sich auf das erste gültige Dokument. Eine Bedingung wie {bpp_count} > 0 am PDF-Element innerhalb der Beitragsschleife setzen. Native Bricks-Stile, Klassen und Component-Eigenschaftsverbindungen bleiben nutzbar. Ohne Bricks pausiert nur diese Integration; der Kern behält Zuordnungen.

Shortcodes und Classic Editor

Unter Einstellungen → Builder PDF Presenter → PDFs einbinden stehen kopierbare Einbindungsbeispiele. Einen Shortcode-Block oder den Classic Editor verwenden. Die eigene Shortcode-Referenz erklärt alle Parameter und Einsatzfälle.

[builder_pdf_presenter]
[builder_pdf_presenter post_id="123"]
[builder_pdf_presenter pdf_id="456" mode="tab" show_title="0"]

IDs sind Beitrags-/Anhang-IDs der eigenen Website. Standardmäßig gilt der aktuelle Beitrag. Öffnungsarten: modal, tab (lokaler Reader in neuem Tab), file (Original-PDF). Sichtbarkeit verwendet 1/0; Texte lassen sich mit read_label und download_label überschreiben.

Reader und Wasserzeichen

Administratoren wählen Navigation, Zoom, Suche auf aktueller Seite, Vollbild und Dateilinks. Die Suche betrifft die gerenderte Seite, nicht das gesamte Archiv. Die Seitenerinnerung gilt während der Browsersitzung. Der Original-PDF-Link bleibt bei Reader-Problemen als Ausweg.

Unter Wasserzeichen die zentrale Vorlage aktivieren, Text/Logo, Position, Deckkraft und Größe festlegen. Redakteure können sie nur bei ausdrücklich erlaubten Ausnahmen je Dokument ausschalten. Kein PDF-Bearbeitungs- oder Schutzfeature: Original, Downloads und außerhalb des Readers geöffnete Dateien werden nicht gestempelt.

Migration und Wiederherstellung

Werkzeuge → PDF-Migration erscheint bei erkanntem Quellplugin, passenden Inhalten oder Wiederherstellungssicherungen. PDF-Poster-/PDF-Embedder-Quellen prüfen, ausdrücklich migrieren und Bericht ansehen. Das alte Plugin erst nach Prüfung der neuen Ausgabe entfernen. Die Migrationsanleitung erklärt unterstützte Formate, Grenzen, Ergebnisberichte und Wiederherstellung. Normale Website-Sicherungen beibehalten.

Fehlerhilfe und Daten

Werkzeuge → Website-Zustand informiert über lokale Reader-Dateien und Server-PDF-Vorschauen. Ohne Konvertierungsunterstützung lassen sich eigene Titelbilder verwenden. Die Befehlspalette bietet passende Navigationszugriffe nach Berechtigung, keine direkt ausgeführten Importe.

Daten liegen in Mediathek, Beitragsmetadaten und websitebezogenen Optionen. Deaktivierung/Deinstallation erhalten Dokumente und Einstellungen standardmäßig. Es gibt keine Leserprofile. Optionale deckerweb-Library-/Updater-Anfragen versorgen Kataloge/Updates, kein PDF-Hosting; die enthaltene Komponenten-Dokumentation und Bedienelemente erläutern dies.

Anwendungsbeispiele · Fragen nach Themen

Sortierung, Suche und Filter

Sammlungen behalten zunächst ihre gespeicherte Reihenfolge. „Reihenfolge auf Sammlung anwenden“ sortiert die Einträge einmalig; anschließend den Beitrag speichern. „Ausgabesortierung“ im Block oder Bricks-Element sortiert diese Darstellung dauerhaft, ohne die redaktionelle Reihenfolge zu ändern. Besuchersortierung gilt nur für die aktuelle URL.

Für ein Archiv die Quelle „Dokumentbeiträge abfragen“ wählen, Inhaltstyp angeben und erstes oder alle PDFs je Beitrag auswählen. Veröffentlichungsdatum, Beitragstitel und menu_order beziehen sich auf Beiträge; Upload-Datum auf die PDF-Mediathekdatei. menu_order ist nur sinnvoll, wenn Werte an den Beiträgen gepflegt sind.

Für Filter eine eindeutige Sammlungs-ID wie newsletters vergeben. Im Block bzw. Bricks-Element „PDF-Filter und Suche“ dieselbe Ziel-ID eintragen. Die beiden Filter-Patterns stellen passende Kombinationen bereit, auch mit Sidebar. Suche, Sortierung und Größe werden über „Filter anwenden“ vor der Seitennavigation auf alle zugänglichen Dokumente angewendet. Keine PDF-Volltextsuche. Bekannte Dateigrößen kommen aus WordPress-Metadaten; unbekannte Größen bleiben unbekannt. Keine PDF-Analyse beim Seitenaufruf.

Native Bricks-Beitragsschleifen verwenden weiterhin native Bricks-Abfragen und -Filter. Das zusätzliche Filterelement ist für Plugin-Sammlungen gedacht, nicht für fremde Post Loops.

Komfort und übertragbare Vorgaben

Entfernen löscht nur die Zuordnung; „Entfernen rückgängig“ stellt sie vor dem Speichern wieder her. Neue, zwischenzeitlich hinzugefügte Einträge bleiben erhalten. Ersetzen ändert nur diese Zuordnung, nicht eine mehrfach verwendete Datei. Die angegebene Mehrfachverwendung zählt Plugin-Zuordnungen in bearbeitbaren Quellbeiträgen, keine beliebigen fremden Builder-Einbettungen.

Unter „PDFs einbinden“ stehen kopierbare Beispiele und Links. Unter „Vorgaben übertragen“ gespeicherte Einstellungen exportieren oder JSON einfügen und Quell-Inhaltstypen ausdrücklich zuordnen. Der Import ersetzt die Plugin-Vorgaben, nicht Dokumente. Keine PDF-Dateien, Zuordnungen oder Medien-IDs werden übertragen. Wasserzeichen bleiben nach Import aus, bis Text und lokales Logo geprüft sind. Vor Änderungen an der Einstellungsseite zuerst speichern, wenn diese mit exportiert werden sollen.

Reader-Fehlerhilfe: MIME-Typen für .mjs

PDF.js verwendet JavaScript-Module. Liefert der Server pdf.mjs oder pdf.worker.mjs als text/plain oder application/octet-stream, kann der Browser sie mit einem Fehler zur strikten MIME-Typ-Prüfung ablehnen. Das betrifft die Hosting-Konfiguration; andere Reader-Fehler können andere Ursachen haben. In den Netzwerkwerkzeugen des Browsers den tatsächlichen Antwortheader Content-Type beider Dateien unter wp-content/plugins/builder-pdf-presenter/vendor/pdfjs/build/ prüfen. Erforderlich ist ein JavaScript-MIME-Typ wie text/javascript oder application/javascript. HTTP 200 allein bestätigt das nicht.

Apache

Im betroffenen Virtual Host oder in .htaccess, sofern der Hoster AddType erlaubt (AllowOverride FileInfo), ergänzen:

AddType application/javascript .mjs

Vorhandene Regeln erhalten und die Zeile außerhalb der automatisch erzeugten WordPress-Markierungen einfügen. Sind .htaccess-Anpassungen nicht erlaubt, den Hoster ansprechen. Siehe Apache-Dokumentation zu AddType.

nginx

Die Serveradministration ergänzt mjs beim JavaScript-Eintrag der wirksamen MIME-Tabelle, häufig mime.types. Aus einem bestehenden Eintrag application/javascript js; wird beispielsweise:

application/javascript js mjs;

Verwendet der vorhandene Eintrag text/javascript, diesen Typ beibehalten und mjs ergänzen. Alle anderen Zuordnungen erhalten: Die vollständige types-Tabelle nicht durch diese einzelne Zeile ersetzen und js nicht doppelt zuordnen. nginx liest keine .htaccess. Vor dem Neuladen über die übliche Serververwaltung die Konfiguration mit nginx -t prüfen. Siehe nginx-Dokumentation zu types.

Hosting-Oberflächen wie Plesk

Bei der betroffenen Domain Apache und nginx → MIME-Typen öffnen, einen eigenen Wert wählen und application/javascript .mjs ergänzen. Bestehende Einträge erhalten und die Änderung übernehmen. Die Aktivierung kann einige Minuten dauern. Bezeichnungen und Verfügbarkeit hängen vom Hoster ab. Liefert nginx die Dateien direkt aus, muss auch dessen wirksame MIME-Zuordnung stimmen. Siehe Plesk-Anleitung für MIME-Typen.

Prüfen und Downloads weiter anbieten

Nach der Änderung betroffene Browser-/Proxy-Caches aktualisieren, beide Modulantworten erneut prüfen und den Reader öffnen. Das Plugin ändert die Serverkonfiguration nicht automatisch.

Ist die Einstellung nicht änderbar, den Download-Button aktivieren und den Lesen-Button gegebenenfalls ausblenden, bis der Reader funktioniert. Ein zugängliches Original-PDF lässt sich weiterhin ohne PDF.js herunterladen. Alternativ kann das Original-PDF direkt in einem neuen Tab geöffnet werden; Browser und Server bestimmen, ob es angezeigt oder heruntergeladen wird. Vorhandene Zugriffsbeschränkungen gelten weiterhin. Für diesen Ausweichweg ist kein externer Google- oder Adobe-Viewer erforderlich.

Anwendungsbeispiele

Drei Wege zu Dokumenten

1. Eine PDF im Beitrag: Das Protokoll, Programm oder Heft direkt im passenden Beitrag anbieten.
2. Mehrere PDFs in einem Beitrag: Eine geordnete Sammlung mit mehreren Unterlagen als Raster oder Liste anzeigen.
3. Ein Archiv aus mehreren Beiträgen: Beiträge abfragen und deren Dokumente als Karten darstellen. Für ein Heftarchiv ist ein Beitrag je Ausgabe besonders einfach.

Die Quelle „Dokumentbeiträge abfragen“ zeigt wahlweise das erste oder alle zugeordneten PDFs je Beitrag. Benannte Plugin-Sammlungen durchsuchen und sortieren alle zugänglichen Ergebnisse vor der Seitennavigation. Native Beitragsabfragen behalten ihre eigene Abfrage und Paginierung; für Bricks-Beitragsschleifen sind die nativen Bricks-Filter zuständig.

Typische Nutzungsszenarien

PDF auswählen, veröffentlichen, wiederfinden. Kostenlos, ohne Werbung, ohne Plugin-Tracking und ohne Pro-Version. PDFs und Vorschaubilder behalten die Zugriffsregeln der Website; durch die Darstellung werden sie nicht automatisch geschützt.

Warum ich Builder PDF Presenter entwickelt habe

Seit Jahren wünschen sich Kunden aus Vereinen und Gemeinden etwas scheinbar Einfaches: ein paar PDFs auf ihrer WordPress-Website sinnvoll ablegen und ansprechend zeigen.

In der Praxis standen die üblichen Möglichkeiten dabei immer wieder im Weg. Mal fehlten wichtige Funktionen. Mal waren sie eigentlich vorhanden, aber hinter Pro-Upgrades und Upselling versteckt. Und selbst wenn der Funktionsumfang passte, wirkten die Pflege im Admin und die Darstellung auf der Website häufig wenig durchdacht.

Ein Kundenprojekt im Herbst 2026 hat diese Probleme schließlich so deutlich gemacht, dass für mich eine eigene Lösung nötig wurde. Dokumente zu pflegen war zu umständlich, PDF-Übersichten luden langsam, und ein schönes Ergebnis erforderte zu viele Anpassungen.

Daraus ist Builder PDF Presenter entstanden: PDF auswählen, übersichtlich präsentieren und bei Bedarf komfortabel lesen. Leichte Vorschaubilder machen Dokumentarchive praktikabel; der lokale PDF.js-Reader wird erst beim Öffnen geladen.

Deine Daten in deinem WordPress. Punkt.

Es gibt keine Pro-Version, keine Werbung und kein Upselling. Das Plugin verfolgt keine Leser und synchronisiert Dokumente nicht mit einem Cloud-Dienst. Seine Aufgabe ist die einfache Veröffentlichung von Dokumenten, ohne Flipbook-Effekte oder ein eigenes Mitgliedersystem.

— David Decker

Fragen nach Themen

Einstieg

Ist das ein Flipbook oder ein Plugin mit Magazin-Effekten?

Nein. Im Mittelpunkt stehen einfache Dokumentpflege, schnelle Titelbild-Übersichten und komfortables Lesen. Blättereffekte gehören nicht dazu.

Gibt es Pro-Version, Werbung oder Cloud-Synchronisierung?

Nein. Es gibt keine gesperrten Bezahlfunktionen, Werbung oder Cloud-Synchronisierung. Die Dokumente werden in der WordPress-Mediathek verwaltet.

Brauche ich Bricks oder Meta Box?

Nein. Kern, Block-Editor-Block und Shortcodes arbeiten eigenständig. Native Bricks-Elemente stehen bei aktivem Bricks bereit. Ohne Bricks bleiben Dokumentzuordnungen und die anderen Ausgabewege erhalten; ein Bricks-Layout benötigt zum Rendern weiterhin Bricks.

Dokumente im Alltag

Was ist eine Sammlung?

Die PDFs, die einem Beitrag, einer Seite oder einem eigenständigen PDF-Block zugeordnet sind. Sie lassen sich sortieren und als Raster oder Liste darstellen. Eine Sammlung kann auch nur eine PDF enthalten.

Wie entsteht ein Archiv aus mehreren Beiträgen?

Bei einem Heft je Beitrag: im Block „Dokumentbeiträge abfragen“ wählen oder einen nativen WordPress-/Bricks-Query-Loop verwenden. Die direkte Blockabfrage zeigt wahlweise das erste oder alle PDFs je Beitrag und filtert Metadaten vor der Paginierung. Im WordPress-Query-Loop verwendet der PDF-Block den jeweiligen Schleifenbeitrag als Quelle. „PDF-Dokument“ in Bricks zeigt dessen erstes PDF; „PDF-Sammlung“ zeigt eine Beitragssammlung oder ein Plugin-Archiv.

Warum zeigt ein neues Bricks-Element schon ein PDF?

Ohne ausdrücklich ausgewählte Datei verwendet „PDF-Dokument“ das erste zugeordnete PDF des aktuellen Quellbeitrags beziehungsweise Schleifenbeitrags. Dies ist echter Inhalt, keine Beispieldatei. Das Einfügen des Elements legt keine zusätzliche Dokumentzuordnung an.

Gehört „PDF Presenter · Block“ zu meiner Seite?

Nein. Die kompakte Kennzeichnung und „Bearbeiten/Vorschau“ sind Editor-Bedienelemente und erscheinen nicht auf der Website. Der eigentliche Dokumenttitel steht in der Karte darunter.

Wie funktionieren Vorgaben und Ausnahmen?

Eingebaute Vorgaben → globale Vorgaben → Vorgaben je Inhaltstyp → Beitragseinstellungen → einzelne Dokument-/Ausgabeeinstellungen. „Übernehmen“ lässt den Wert aus der vorigen Ebene gelten. Zentrale Sammlungslimits und die Wasserzeichenrichtlinie bleiben unter Kontrolle des Administrators.

Warum fehlt ein Titelbild?

WordPress benötigt eine geeignete PDF-Vorschau; alternativ lässt sich ein eigenes Bild auswählen. Automatische Erzeugung hängt von Bildverarbeitung und PDF-Unterstützung des Servers ab. „Fehlende Vorschauen erzeugen“ verwenden oder ein Titelbild manuell zuordnen. Bei Besucheraufrufen erzeugt das Plugin keine PDF-Bilder.

Reader, Daten und Zugriff

Warum PDF.js?

PDF.js ist eine Open-Source-PDF-Technik, die auch in Firefox eingesetzt wird. Die Reader-Skripte werden lokal ausgeliefert. Adobe und Google Docs werden für die Darstellung nicht benötigt und auch nicht als automatischer Ersatzdienst genutzt.

Was passiert bei einem Reader-Ladefehler?

Eine verständliche Meldung verweist auf den Link zur Original-PDF. Die Zugriffsregeln der Datei gelten weiterhin. Ob der Browser das Original öffnet oder herunterlädt, hängt von Browser und Server-Headern ab.

Sind Dokumente geschützt, wenn „Herunterladen“ ausgeblendet ist?

Nein. Ausgeblendete Bedienelemente sind weder Zugriffsschutz noch Kopierschutz. Original-URLs und Vorschaubilder behalten die bestehenden Server-Berechtigungen. Das Plugin stellt keinen geschützten Dokumentenspeicher und kein Mitgliedersystem bereit.

Verändert ein Wasserzeichen die PDF?

Nein. Es wird im Reader darübergelegt. Original, Downloads und außerhalb des Readers geöffnete Dateien bleiben unverändert. Administratoren geben die Vorlage vor und können Ein-/Aus-Ausnahmen je Dokument erlauben. Redakteure können keine beliebigen Wasserzeichenlogos einsetzen.

Werden Leser verfolgt oder PDFs in eine Cloud übertragen?

Das Plugin bietet keine Leserstatistik, Profilbildung oder Cloud-Synchronisierung. Der Reader verwendet lokale Dateien. Optionale deckerweb-Update-/Library-Funktionen können die separat dokumentierten Katalog-/Updateanfragen senden; dabei werden keine PDFs hochgeladen.

Was speichert der Reader im Browser?

Die optionale Seiten-Erinnerung verwendet den Sitzungsspeicher, um die aktuelle Seite je Dokument während des Besuchs zu merken. Dies dient der Bedienung, nicht einer Statistik. Mit dem Ende der Sitzung verschwindet die Erinnerung.

Verwaltung und Fehlerhilfe

Was prüft „Website-Zustand“?

Lokale Reader-Dateien und die von WordPress gemeldete PDF-Bildverarbeitungsunterstützung. Es werden weder Dokumente hochgeladen noch alle Mediendateien durchsucht. Die Prüfung garantiert keine Konvertierung jeder PDF. Fehlt die Vorschauerzeugung, bleiben eigene Titelbilder nutzbar.

Was machen die Schnellzugriffe in der Befehlspalette?

Sie öffnen Anleitung, Einstellungen oder die PDF-Poster-Migration, abhängig von Berechtigung und Verfügbarkeit. Sie führen keine Migration aus und speichern keine Änderungen.

Wie funktioniert die Migration?

Unter Werkzeuge → PDF-Migration die gefundenen Beiträge prüfen und ausdrücklich migrieren. Vorher-/Nachher-Sicherungen und Ergebnisberichte ermöglichen eine Wiederherstellung je Beitrag. Spätere Änderungen können einen Konflikt auslösen und werden nicht still überschrieben. Das Werkzeug erscheint bei erkanntem PDF Poster beziehungsweise passenden Einbettungen/Sicherungen; vorhandene Mediathek-Dateien werden genutzt.

Was gilt für Multisite und Deinstallation?

Einstellungen, Zuordnungen und Migrationsberichte gelten je Website. Deaktivierung und Deinstallation erhalten Dokumente und Einstellungen standardmäßig. Eingebundene Komponenten verwalten ihre gemeinsam benötigten temporären Daten gesondert. Normale Sicherungen von Website und Mediathek bleiben sinnvoll.

Warum kann das Theme die Darstellung trotzdem beeinflussen?

Das Plugin bietet begrenzte, lesbare Standardstile. Block-Editor-Stiloptionen und native Bricks-Stile passen die jeweilige Ausgabe an. Sehr allgemeine oder wichtige Theme-Regeln können weiterhin eingreifen; beliebige fremde CSS-Regeln lassen sich nicht vollständig ausschließen.

Suche und übertragbare Vorgaben

Durchsucht die Sammlungssuche PDF-Inhalte?

Nein. Sie durchsucht die ausgewählten Anzeigetitel, tatsächlichen Quellbeitragstitel, Mediathektitel und Dateinamen. „Filter anwenden“ erfasst die gesamte zugängliche Sammlung vor der Seitennavigation. Das ist unabhängig von der optionalen Suche auf der aktuell angezeigten PDF-Seite im Reader. Such-URLs lassen sich teilen; das Plugin führt keine Suchstatistik.

Warum ist eine PDF-Dateigröße unbekannt?

In älteren WordPress-Anhangsmetadaten kann die Byte-Größe fehlen. Das Plugin lädt oder analysiert dafür während eines Besucheraufrufs keine Datei. Unbekannte Größen haben einen eigenen Filter und stehen bei beiden Sortierrichtungen zuletzt.

Überträgt der Vorgabenimport Dokumente auf eine andere Website?

Nein. Übertragen werden nur gespeicherte Anzeigevorgaben. Inhaltstypen müssen ausdrücklich zugeordnet werden; doppelte Zielzuordnungen werden abgewiesen. Medien-IDs und PDF-Zuordnungen werden nicht kopiert. Wasserzeichen sind nach dem Import aus und ihr Logo wird aus den importierten Vorgaben entfernt, bis der Administrator die lokale Vorlage geprüft hat. Der Import ersetzt Plugin-Vorgaben, keine Dokumente oder Wiederherstellungssicherungen der Migration.

PDF-Poster- und PDF-Embedder-Migration: Ablauf, Grenzen und Wiederherstellung

Warum meldet der Reader einen MIME-Typ-Fehler für .mjs-Dateien?

Der Server liefert die PDF.js-Module möglicherweise als einfachen Text statt als JavaScript aus. Die MIME-Zuordnung für .mjs lässt sich in Apache, nginx oder der Hosting-Oberfläche korrigieren. Die MIME-Fehlerhilfe enthält Beispiele und Prüfschritte. Ist keine Lösung möglich, den Download-Button aktiviert lassen und Lesen gegebenenfalls ausblenden: Zugängliche Original-PDFs bleiben ohne Reader verfügbar.

Shortcodes

English · Anleitung

Shortcodes funktionieren im Classic Editor, im Shortcode-Block und in geeigneten Builder-Elementen. IDs in den Beispielen sind Platzhalter aus der eigenen Mediathek bzw. Website. Ein sichtbarer Quellbeitrag ist erforderlich; Shortcodes umgehen keine Beitragsberechtigungen oder Passwörter.

[builder_pdf_presenter]

Anzeige und Reader: vererbte Vorgaben

Ohne Wert gilt: Plugin-Vorgabe → Website → Inhaltstyp → Beitrag → Dokument → ausdrücklicher Ausgabeparameter. Leere Werte übernehmen. Boolesche Werte: 1/true oder 0/false. Die folgende Tabelle nennt die eingebauten Vorgaben; gespeicherte Website-Vorgaben können davon abweichen.

[builder_pdf_filters]

Die Suche erfasst nur konfigurierte Titel und Dateinamen, keinen PDF-Inhalt. „Anwenden“ lädt die Seite mit GET-Parametern neu; teilbare URLs, keine Speicherung von Besuchersortierungen und keine Suchstatistik. Größenbereiche: unter 1 MiB, 1 bis unter 5 MiB, ab 5 MiB und unbekannt; 1 MiB = 1.048.576 Byte. Unbekannte Größen werden nicht aus PDFs nachgeladen und beim Sortieren zuletzt angezeigt.

Vollständige Beispiele

Aktueller Beitrag

[builder_pdf_presenter]

Anderer Quellbeitrag

[builder_pdf_presenter post_id="123"]

Einzelne PDF

[builder_pdf_presenter post_id="123" pdf_id="456" mode="tab"]

Alle PDFs eines Beitrags, sortiert

[builder_pdf_presenter post_id="123" collection_id="minutes" orderby="title" order="ASC" page_size="12"]

Archiv mit Filterleiste

[builder_pdf_filters target="newsletters"]
[builder_pdf_presenter source="posts" post_type="post" per_post="all" collection_id="newsletters" page_size="12" columns="3"]

Abweichende Aktionen und Reader

[builder_pdf_presenter mode="modal" show_download="0" reader_download="0" zoom="1" search="1" read_label="Jetzt lesen"]

Jede Sammlung benötigt einen eigenen Namen, wenn sie getrennt gefiltert werden soll. Die Filterleiste darf mit Zwischeninhalten darüber oder in einer anderen Spalte stehen. Kopierte Patterns erhalten einen vorbereiteten Namen; bei mehreren Kopien auf derselben Seite die zusammengehörigen Namen jeweils ändern. Für native Bricks-Beitragsschleifen die nativen Bricks-Filter verwenden.

PDF-Migration

English · Überblick

Entscheiden, ob der Wechsel passt

Unter Werkzeuge → PDF-Migration unterstützte Einbettungen prüfen und ausgewählte Beiträge ausdrücklich umstellen. Unterstützt werden PDF-Poster-Blöcke und PDF-Embedder-Blöcke/Shortcodes im normalen Beitragsinhalt. Vorhandene lokale Mediathek-PDFs werden genutzt, nicht hochgeladen, kopiert oder gelöscht. Für die Erkennung muss das Quellplugin nicht aktiv bleiben. Damit wiederhergestellte ursprüngliche Einbettungen funktionieren, muss es wieder verfügbar sein.

Auch PDF Embedder verwendet lokales PDF.js. Der Wechsel ist sinnvoll für Vorschaukarten, Sammlungen und Archive mit Lesen-/Download-Aktionen. Die Darstellung ändert sich: Aus Inline-Viewern werden Titelbild-Karten mit Lesen-Aktion gemäß den aktuellen Plugin-Vorgaben, etwa dem Modal-Reader. Breite, Höhe, Toolbarposition, Hover-Verhalten, Startseite und anfänglicher Zoom werden nicht übernommen. Ergebnis vor Entfernen des Quellplugins prüfen.

Unterstützte und übersprungene Inhalte

• PDF Poster: unterstützte Blöcke; dessen Shortcodes weiterhin manuell prüfen.
• PDF Embedder: Blöcke pdfemb/pdf-embedder-viewer und echte Shortcodes [pdf-embedder url="…"]. Der Adapter wurde anhand der kostenlosen Version 5.0.2 entwickelt; andere Formate müssen geprüft werden.
• Die PDF muss eindeutig einer normalen lokalen Mediathek-PDF mit vorhandener Datei entsprechen. Widersprüchliche ID/URL-Angaben werden nicht erraten.
• Externe URLs, fehlende/mehrdeutige Anhänge und geschützte securepdfs-Dokumente werden übersprungen. Keine entfernten PDFs werden geladen, kein Schutz wird entfernt.
• HTML-/Codebeispiele, beliebige Builder-Metadaten, Templates und Premium-Sonderinhalte werden nicht automatisch umgestellt. Maskierte Shortcode-Beispiele bleiben erhalten.

Eine nicht unterstützte PDF-Referenz lässt den ganzen Beitrag unverändert. Mehrere unabhängige Beiträge eines Durchlaufs können unterschiedliche Ergebnisse haben. Der Bericht erklärt jeden Ausgang.

Prüfen, umstellen und kontrollieren

1. Werkzeuge → PDF-Migration öffnen. Nach Änderungen an Quellinhalten „Erneut prüfen“ verwenden.
2. Gefundene Beiträge durchsehen. Auswählbare Einträge haben eindeutig zugeordnete lokale PDFs; andere zeigen den Grund. Aktivierung und Seitenaufruf starten keine Migration.
3. Bis zu 50 Beiträge auswählen und ausdrücklich umstellen. Sammlungslimits und Berechtigungen gelten weiterhin.
4. Ergebnisbericht, Quellseite und zugehörige Archive prüfen. Mehrere Einbettungen behalten Position und Reihenfolge; jede zeigt ihr eigenes Dokument statt wiederholt die ganze Beitragssammlung. Eindeutige Dokumente werden zusätzlich dem Beitrag für Archive zugeordnet. Vorhandene Zuordnungen bleiben erhalten.
5. Vor Deaktivierung/Entfernung des alten Plugins alle Quellseiten, Templates, Builder-Integrationen und übersprungenen Fälle kontrollieren. Das Werkzeug prüft Beitragsinhalte, nicht jeden möglichen Speicherort.

Beitragsstatus, Passwörter und weitere Beitragseinstellungen bleiben erhalten. Mediendateien behalten ihre Zugriffsregeln. Die Migration schafft keinen geschützten Speicher und keinen Kopierschutz.

Wiederherstellung und spätere Änderungen

Das Werkzeug sichert den exakten ursprünglichen Beitragsinhalt und die vorherigen PDF-Zuordnungen. Unter Wiederherstellungssicherungen einzelne Beiträge zurücksetzen. Spätere Änderungen führen zu einem Konflikt und erfordern ausdrückliche Bestätigung zum Überschreiben. Die Wiederherstellung ersetzt den gesicherten Inhalt und die Sammlung, bei bestätigtem Überschreiben einschließlich späterer Änderungen; Mediendateien werden nicht gelöscht. Die letzten 20 Ergebnisberichte bleiben abrufbar. Allgemeine Website-Sicherungen bleiben sinnvoll.

Das Migrationswerkzeug in der Praxis

PDF-Poster- und PDF-Embedder-Beiträge unter Werkzeuge prüfen

Werkzeuge → PDF-Migration zeigt unterstützte lokale PDFs und erklärt, warum unklare oder externe Quellen nicht auswählbar sind. Die Quellen vor der Umstellung prüfen.

Ergebnisbericht und Wiederherstellung für einzelne Beiträge

Nach der Umstellung nennt der Bericht das Ergebnis je Beitrag. Über die Wiederherstellungssicherungen lässt sich ein einzelnes Original gezielt zurücksetzen. Die Screenshots zeigen neutrale Beispieldaten.

Security / Sicherheit

Report suspected vulnerabilities privately through GitHub private vulnerability reporting. Include the plugin version, minimal reproduction steps and expected impact. Never post customer PDFs, passwords or exploit details in public issues. If the private form is temporarily unavailable, wait or use an already established private contact with David Decker; do not publish the details.

Sicherheitslücken vertraulich über GitHubs private Sicherheitsmeldungen melden. Pluginversion, minimale Reproduktionsschritte und erwartete Auswirkungen nennen. Keine Kunden-PDFs, Passwörter oder Exploit-Details in öffentlichen Issues veröffentlichen. Falls das private Formular vorübergehend nicht verfügbar ist, warten oder einen bereits bekannten privaten Kontakt zu David Decker nutzen; keine Details öffentlich melden.