Splendidi flipbook
sul tuo sito WordPress

Che cosa aggiunge il plugin al tuo sito — e che cosa no

Un plugin lo fai entrare nella tua installazione, quindi è giusto chiedersi che cosa porti con sé. Questo è volutamente piccolo. Sul lato pubblico produce un solo <div> con dentro un <iframe> contrassegnato loading="lazy": un flipbook più in basso in una pagina lunga viene scaricato solo quando il lettore ci arriva.

Non carica fogli di stile né JavaScript sul lato pubblico. Non crea tabelle nel database e non aggiunge voci di menu all'amministrazione. Non telefona a casa, non conta nulla e non chiede chiavi API. Tutto ciò che fa funzionare il flipbook gira dentro l'iframe, da parte nostra — ed è anche il motivo per cui il tuo punteggio di velocità non si muove quando ne aggiungi uno.

Disattivarlo è altrettanto tranquillo: lo shortcode non viene più riconosciuto, perciò [toombler id="…"] compare come testo normale nell'articolo finché non lo togli. Nel database non resta nulla, perché nulla vi era stato messo.

La versione testuale, e perché conviene attivarla

Un flipbook è un'immagine delle tue pagine. Va benissimo per chi vede e ha un mouse, ed è inutile per uno screen reader, che trova una cornice e nient'altro da leggere. Aggiungendo text="1" allo shortcode, sotto il libro compare un pannello richiudibile Read the text version, riempito con il vero livello di testo del tuo PDF.

Il recupero avviene sul tuo server, non nel browser del visitatore, e il risultato viene conservato in un transient di WordPress: dodici ore se il testo è stato trovato, un'ora se no — così un flipbook il cui testo è ancora in estrazione lo recupera poco dopo e non il giorno seguente. Vengono memorizzati al massimo 60.000 caratteri, più di una brochure normale, e abbastanza da evitare che un manuale di quattrocento pagine ti riempia la tabella delle opzioni.

C'è un secondo motivo, meno nobile ma reale: quel testo sta sulla tua pagina, nel tuo HTML, sotto il tuo dominio. Un motore di ricerca che legge l'articolo vede che cosa dice davvero il documento, invece di una cornice in cui non può entrare. Se pubblichi cataloghi o newsletter che vuoi far trovare, questo singolo attributo fa più di tutto il resto di questa pagina.

Funziona solo con PDF che contengono testo vero. Una scansione senza OCR non ha un livello di testo, e allora il pannello non compare invece di aprirsi vuoto.

Requisiti, versioni e licenza

Il plugin richiede WordPress 5.8 o successivo e PHP 7.4 o successivo, ed è provato contro la versione corrente di WordPress. Sono soglie basse di proposito: il codice non usa nulla di esotico e continua quindi a funzionare su hosting rimasto indietro di qualche anno.

Trattandosi di uno shortcode ordinario, funziona nell'editor a blocchi, nell'editor classico, in un widget di testo e nei page builder come Elementor, Divi, Beaver Builder e Bricks — ovunque gli shortcode vengano interpretati. Il blocco Gutenberg è una comodità in più, non un requisito.

È software libero sotto licenza GPL, versione 2 o successiva, la stessa di WordPress. Puoi leggerlo, modificarlo e far girare una tua versione sui tuoi siti.

Come tratta quello che scrivi

Tutto ciò che finisce nell'HTML di una pagina merita uno sguardo sospettoso, quindi ecco che cosa succede ai tuoi attributi. L'ID del file deve corrispondere a [A-Za-z0-9_-] ed essere lungo tra dieci e sessanta caratteri; tutto il resto viene rifiutato con un messaggio visibile invece di finire incollato in un URL. Larghezza e altezza passano da absint(), così una lettera vagante produce il valore predefinito anziché rompere l'impaginazione. L'URL composto viene messo in escape prima di arrivare nel src.

Una cosa vale la pena saperla perché coglie di sorpresa: WordPress scarta in silenzio gli attributi di shortcode che non conosce. Scrivi hight="600" e non si rompe niente — ottieni semplicemente l'altezza predefinita e nessun avviso da nessuna parte. Se un'opzione sembra non fare nulla, controlla prima l'ortografia nella tabella qui sopra.

Il plugin fa esattamente una richiesta dal tuo server al nostro, e solo quando text="1" è attivo: chiede il testo di quel singolo flipbook. Nulla che riguardi i tuoi visitatori viene trasmesso, perché di loro non sa nulla.

Blocco o shortcode?

Producono lo stesso HTML, quindi è una questione di come ti piace lavorare. Il blocco offre un'anteprima dal vivo nell'editor e una barra laterale con le opzioni come controlli veri, più comoda mentre provi le misure. Lo shortcode è testo, e questo lo rende facile da copiare tra articoli, da incollare in un page builder e da cercare in seguito quando vuoi ritrovare ogni flipbook del sito.

Se gestisci il sito per qualcun altro, lo shortcode ha un vantaggio pratico: sopravvive a un cambio di tema, a un cambio di editor e a una migrazione verso un page builder senza dover essere rifatto. Per un confronto del plugin con gli altri tre modi di incorporare — iframe nudo, frammento JavaScript e oEmbed — vedi la guida su come incorporare un PDF in WordPress.