De superbes flipbooks
sur votre site WordPress

Ce que l'extension ajoute à votre site — et ce qu'elle n'ajoute pas

Une extension entre chez vous, il est donc légitime de demander ce qu'elle apporte. Celle-ci est délibérément petite. Côté visiteur, elle produit un seul <div> contenant un <iframe> marqué loading="lazy" : un flipbook placé bas dans une longue page n'est chargé que lorsque le lecteur y arrive.

Elle ne charge ni feuille de style ni JavaScript côté public. Elle ne crée aucune table en base et n'ajoute aucun menu à l'administration. Elle n'appelle personne, ne compte rien et ne réclame pas de clé d'API. Tout ce qui fait fonctionner le flipbook tourne dans l'iframe, chez nous — c'est aussi pourquoi votre score de vitesse ne bouge pas quand vous en ajoutez un.

La désactivation est tout aussi calme : le shortcode n'est plus reconnu, donc [toombler id="…"] s'affiche en texte brut dans votre article jusqu'à ce que vous l'enleviez. Rien ne reste en base, puisque rien n'y a jamais été écrit.

La version texte, et pourquoi l'activer

Un flipbook est une image de vos pages. Très bien pour un lecteur qui voit et qui a une souris, inutile pour un lecteur d'écran, qui trouve un cadre et rien à lire. Ajoutez text="1" au shortcode et un panneau dépliable Read the text version apparaît sous le livre, rempli avec la véritable couche de texte de votre PDF.

La récupération se fait sur votre serveur, pas dans le navigateur du visiteur, et le résultat est conservé dans un transient WordPress : douze heures si du texte a été trouvé, une heure sinon — ainsi un flipbook dont le texte est encore en cours d'extraction le récupère peu après, et non le lendemain. Au plus 60 000 caractères sont stockés, soit davantage qu'une brochure ordinaire, et de quoi éviter qu'un manuel de quatre cents pages ne remplisse votre table d'options.

Il y a une seconde raison, moins noble mais réelle : ce texte est sur votre page, dans votre HTML, sous votre domaine. Un moteur de recherche qui lit l'article voit ce que le document dit vraiment, au lieu d'un cadre dans lequel il ne peut pas entrer. Si vous publiez des catalogues ou des lettres d'information que vous voulez rendre trouvables, cet unique attribut fait plus que tout le reste de cette page.

Cela ne marche que pour les PDF contenant du vrai texte. Un scan sans OCR n'a pas de couche de texte : le panneau ne s'affiche alors pas, plutôt que de s'ouvrir sur du vide.

Prérequis, versions et licence

L'extension demande WordPress 5.8 ou plus récent et PHP 7.4 ou plus récent, et elle est testée avec la version courante de WordPress. Ces seuils sont bas volontairement : le code n'utilise rien d'exotique et continue donc de fonctionner sur un hébergement en retard de quelques années.

Comme c'est un shortcode ordinaire, il fonctionne dans l'éditeur de blocs, dans l'éditeur classique, dans un widget texte et dans les constructeurs de pages comme Elementor, Divi, Beaver Builder et Bricks — partout où les shortcodes sont interprétés. Le bloc Gutenberg est un confort supplémentaire, pas une obligation.

C'est un logiciel libre sous licence GPL, version 2 ou ultérieure, la même que WordPress lui-même. Vous pouvez le lire, le modifier et faire tourner votre propre version sur vos propres sites.

Comment elle traite ce que vous saisissez

Tout ce qui finit dans le HTML d'une page mérite un regard méfiant ; voici donc ce qui arrive à vos attributs. L'identifiant de fichier doit correspondre à [A-Za-z0-9_-] et faire entre dix et soixante caractères ; tout le reste est refusé par un message visible plutôt que collé dans une URL. La largeur et la hauteur passent par absint(), si bien qu'une lettre égarée donne la valeur par défaut au lieu de casser la mise en page. L'URL assemblée est échappée avant d'arriver dans le src.

Une chose mérite d'être sue parce qu'elle surprend : WordPress jette silencieusement les attributs de shortcode qu'il ne connaît pas. Écrivez hight="600" et rien ne casse — vous obtenez simplement la hauteur par défaut, sans le moindre avertissement. Si une option semble sans effet, vérifiez d'abord l'orthographe dans le tableau ci-dessus.

L'extension fait exactement une requête de votre serveur vers le nôtre, et seulement si text="1" est activé : elle demande le texte de ce flipbook-là. Rien n'est transmis sur vos visiteurs, car elle ne sait rien d'eux.

Bloc ou shortcode ?

Les deux produisent le même HTML : c'est donc une question de façon de travailler. Le bloc offre un aperçu en direct dans l'éditeur et une colonne latérale où les options sont de vrais réglages, ce qui est plus agréable quand on essaie des tailles. Le shortcode est du texte, donc facile à copier d'un article à l'autre, à coller dans un constructeur de pages, et à rechercher plus tard quand vous voulez retrouver chaque flipbook du site.

Si vous gérez le site pour quelqu'un d'autre, le shortcode a un avantage pratique : il survit à un changement de thème, à un changement d'éditeur et à une migration vers un constructeur de pages sans devoir être refait. Pour une comparaison de l'extension avec les trois autres méthodes d'intégration — iframe simple, extrait JavaScript et oEmbed — voyez le guide sur l'intégration d'un PDF dans WordPress.