Wunderschöne Flipbooks
auf deiner WordPress-Website

Was das Plugin Ihrer Website hinzufügt — und was nicht

Ein Plugin lassen Sie in Ihre eigene Installation, also ist die Frage berechtigt, was es mitbringt. Dieses ist bewusst klein. Im Frontend gibt es ein einziges <div> aus, darin ein <iframe> mit loading="lazy" — ein Flipbook weiter unten auf einer langen Seite wird also erst geholt, wenn der Leser dort ankommt.

Es lädt im Frontend kein Stylesheet und kein JavaScript. Es legt keine Datenbanktabellen an und hängt keinen Menüpunkt in die Verwaltung. Es funkt nicht nach Hause, zählt nichts und verlangt keinen API-Schlüssel. Alles, was das Flipbook zum Laufen bringt, läuft im iframe auf unserer Seite — deshalb bewegt sich Ihr Geschwindigkeitswert auch nicht, wenn Sie eins einbauen.

Das Deaktivieren verläuft ebenso unspektakulär: Der Shortcode wird nicht mehr erkannt, [toombler id="…"] steht dann als gewöhnlicher Text im Beitrag, bis Sie ihn entfernen. In der Datenbank bleibt nichts zurück, weil dort nie etwas abgelegt wurde.

Die Textfassung, und warum sie sich lohnt

Ein Flipbook ist ein Bild Ihrer Seiten. Für Leser mit funktionierenden Augen und einer Maus ist das in Ordnung, für einen Screenreader nutzlos: Der findet einen Rahmen und sonst nichts. Mit text="1" im Shortcode erscheint unter dem Buch ein aufklappbares Feld Read the text version, gefüllt mit der echten Textebene aus Ihrem PDF.

Geholt wird sie auf Ihrem Server, nicht im Browser des Besuchers, und das Ergebnis landet in einem WordPress-Transient: zwölf Stunden, wenn Text gefunden wurde, eine Stunde, wenn nicht — damit ein Flipbook, dessen Text noch verarbeitet wird, ihn kurz darauf doch bekommt und nicht erst am nächsten Tag. Gespeichert werden höchstens 60.000 Zeichen; das ist mehr als eine übliche Broschüre und verhindert, dass ein Handbuch mit vierhundert Seiten Ihre Optionstabelle füllt.

Es gibt einen zweiten Grund, weniger edel, aber real: Dieser Text steht auf Ihrer Seite, in Ihrem HTML, unter Ihrer Domain. Eine Suchmaschine, die den Beitrag liest, sieht, was das Dokument tatsächlich sagt, statt eines Rahmens, in den sie nicht hineinkommt. Wenn Sie Kataloge oder Kundenzeitschriften veröffentlichen, die gefunden werden sollen, bewirkt dieses eine Attribut mehr als alles andere auf dieser Seite.

Es funktioniert nur bei PDFs mit echtem Text. Ein Scan ohne OCR hat keine Textebene, und dann bleibt das Feld weg, statt sich leer zu öffnen.

Voraussetzungen, Versionen und Lizenz

Das Plugin braucht WordPress 5.8 oder neuer und PHP 7.4 oder neuer und wird gegen die aktuelle WordPress-Version getestet. Diese Hürden liegen mit Absicht niedrig: Der Code benutzt nichts Exotisches und läuft deshalb auch auf Hosting, das ein paar Jahre hinterherhinkt.

Weil es ein gewöhnlicher Shortcode ist, funktioniert er im Block-Editor, im klassischen Editor, in einem Text-Widget und in Page-Buildern wie Elementor, Divi, Beaver Builder und Bricks — überall, wo Shortcodes ausgeführt werden. Der Gutenberg-Block ist eine Bequemlichkeit obendrauf, keine Bedingung.

Es ist freie Software unter der GPL, Version 2 oder später, derselben Lizenz wie WordPress selbst. Sie dürfen den Code lesen, ändern und Ihre eigene Abwandlung auf Ihren eigenen Seiten betreiben.

Wie es mit Ihren Eingaben umgeht

Alles, was im HTML einer Seite landet, verdient einen misstrauischen Blick — also hier, was mit Ihren Attributen passiert. Die Datei-ID muss [A-Za-z0-9_-] entsprechen und zwischen zehn und sechzig Zeichen lang sein; alles andere wird mit einer sichtbaren Meldung abgewiesen, statt in eine URL geklebt zu werden. Breite und Höhe laufen durch absint(), sodass ein verirrter Buchstabe den Standardwert ergibt und nicht Ihr Layout zerlegt. Die fertige URL wird escaped, bevor sie in das src kommt.

Eines sollten Sie wissen, weil es regelmäßig überrascht: WordPress verwirft Shortcode-Attribute, die es nicht kennt, stillschweigend. Schreiben Sie hight="600", geht nichts kaputt — Sie bekommen einfach die Standardhöhe und nirgends eine Warnung. Wenn eine Option nichts zu bewirken scheint, prüfen Sie zuerst die Schreibweise gegen die Tabelle oben.

Das Plugin stellt genau eine Anfrage von Ihrem Server an unseren, und nur wenn text="1" gesetzt ist: Es fragt nach dem Text dieses einen Flipbooks. Über Ihre Besucher wird nichts übermittelt, weil es nichts über Ihre Besucher weiß.

Block oder Shortcode?

Beide erzeugen dasselbe HTML, es ist also eine Frage der Arbeitsweise. Der Block zeigt eine Live-Vorschau im Editor und eine Seitenleiste mit den Optionen als echten Bedienelementen, was beim Ausprobieren von Größen angenehmer ist. Der Shortcode ist Text und lässt sich deshalb leicht zwischen Beiträgen kopieren, in einen Page-Builder einfügen und später wiederfinden, wenn Sie jedes Flipbook auf der Website aufspüren wollen.

Betreuen Sie die Website für jemand anderen, hat der Shortcode einen praktischen Vorteil: Er übersteht einen Themenwechsel, einen anderen Editor und den Umzug auf einen Page-Builder, ohne neu gebaut werden zu müssen. Einen Vergleich des Plugins mit den drei anderen Einbindungswegen — nacktes iframe, JavaScript-Schnipsel und oEmbed — finden Sie in der Anleitung zum Einbinden eines PDFs in WordPress.