Comment choisir un module Drupal 7 pour visualiser des PDF

Cet article explique comment choisir un module Drupal 7 pour visualiser les PDF. Il comprend une évaluation de plusieurs modules potentiels.

Définissez ce que vous voulez

Imaginez qu'un client vous demande d'ajouter une nouvelle fonctionnalité au site Drupal de l'entreprise: l'affichage des fichiers PDF dans le navigateur. En parcourant les options sur drupal.org, vous vous rendez compte qu'il y a pas mal d'options parmi lesquelles choisir.

La première étape consiste à définir ce que vous voulez. En général, ce sont des exigences assez standard auxquelles vous vous attendez.

• La possibilité d'afficher des fichiers PDF dans un navigateur Web, similaire à cet exemple. Le client téléchargerait les PDF du bulletin d'information de l'entreprise et les visiteurs pourraient les lire facilement.
• Le site est Drupal 7, le module devrait donc correspondre à cela version majeure. (Drupal 7 est sorti depuis un certain temps maintenant, donc si un développeur de module n'a pas encore sorti de version Drupal 7, il ne le fera probablement pas.)
• Vous pouvez également éviter de vous fier à un service tiers. Pour les vidéos, vous pourriez être heureux de publier le contenu sur YouTube ou Vimeo, puis de l'intégrer sur un site Drupal, mais pour les PDF, nous ne pensons pas que l'exposition supplémentaire possible l'emporterait sur les tracas potentiels, la casse et frais.
• Vous voudrez probablement garder le module aussi léger et spécifique que possible. Vous cherchez peut-être quelque chose comme Boîte de couleur, qui agrandit les images pour une meilleure visualisation mais reste totalement indépendant de la façon dont vous choisissez de gérer les fichiers images.
• Comme d'habitude, nous voulons suivre les directives générales pour choisir un module Drupal. En gros, choisissez un module déjà utilisé par quelques milliers de personnes (si possible) depuis un certain temps, avec un minimum de dépendances, qui semble être maintenu par un développeur actif qui prévoit de continuer à soutenir le projet à l'avenir et ne nécessite pas de licence frais.

Rechercher sur Drupal.org

Avec ces objectifs à l'esprit, la prochaine étape était une recherche simple sur Drupal.org. Il est temps de sauter dans la piscine à balles de Module Goodness.

Page « Comparaison » pour les modules PDF

Mon premier arrêt était (ou aurait dû être), cette page: un Comparaison des modules de visualisation PDF. Drupal.org a une excellente tradition de pages de documentation qui décrivent les avantages et les inconvénients de divers modules dans le même espace. Il y a un liste centrale des pages de comparaison, mais ils sont également éparpillés sur tout le site.

La page de comparaison PDF comprenait quatre modules de visualisation PDF. Nous les couvrirons ici, ainsi que quelques autres que nous avons trouvés en cherchant. Nous allons commencer par les candidats que nous avons décidé d'ignorer.

Examinons maintenant en détail pourquoi ces modules ont fonctionné (ou n'ont pas fonctionné pour la plupart) pour ce projet.

Formateur de fichiers de la visionneuse Google

Formateur de fichiers de la visionneuse Google est ce que cela ressemble: un moyen d'utiliser Google Docs pour intégrer des affichages de fichiers dans votre page Web. Bien que nous ayons apprécié la polyvalence de Google Docs, l'un de nos objectifs était de rester indépendant de tout service tiers.

De plus, ce module a eu moins de 100 installations.

Visionneuse de documents Ajax

Bien que "AJAX" soit un terme Javascript général, Visionneuse de documents Ajax s'est avéré s'appuyer sur un service tiers spécifique. Seulement environ 100 installations. Avancer...

Ébouillanter PDF

Ébouillanter PDF n'avait que 40 installations, mais nous avons dû jeter un coup d'œil car cela faisait clairement partie d'un projet plus vaste appelé (oui) Ébouillanter. Comme l'expliquait la page du projet Scald: "Scald est une approche innovante sur la façon de gérer Atomes de médias dans Drupal."

Cette phrase a soulevé deux énormes drapeaux rouges: « prise innovante » et le mot « Media » associé à « Atom ». "Atom" était évidemment un mot réutilisé pour "chose", ce qui en faisait un drapeau rouge à lui tout seul. Drupal a un penchant pour ce genre de mots vides: nœud, entité, fonctionnalité... Plus le mot est général, plus les changements peuvent être radicaux.

Vous lirez des affirmations enthousiastes sur la façon dont Scald réinventera fondamentalement la façon dont vous gérez les médias sur votre site.

Maintenant, la vérité est que la gestion des médias de Drupal aurait besoin d'être réinventée. Scald n'est pas le seul projet ambitieux dans cet espace.

L'échaudure pourrait être la prochaine Vues. Ce serait rock. Mais cela pourrait aussi être un abandonware, avec une (petite) traînée de sites cassés laissés à pleurer.

Shadowbox

Shadowbox nous a surpris: il prétendait être une solution unique pour afficher toutes sortes de médias, des PDF aux images en passant par la vidéo. Ce n'était pas aussi radical que Scald car il ne se concentrerait que sur affichage médias sans introduire de nouveaux concepts comme "Media Atoms". Mais nous aimons déjà Colorbox, comme mentionné.

Cependant, nous avons noté (avec un gémissement intérieur) qu'avec plus de 16,000 installe, Shadowbox pourrait être une alternative plus puissante dans le même espace. Nous eu jeter un oeil.

Le module Shadowbox Drupal est essentiellement un pont vers une bibliothèque Javascript, Shadowbox.js, nous avons donc consulté le site Web de la bibliothèque. Là, nous avons découvert deux raisons de passer à autre chose:

• La bibliothèque exige une redevance pour une utilisation commerciale. Les frais étaient assez raisonnables, mais nous essayons d'éviter les logiciels open source qui ne sont pas gratuits.
• Une recherche minutieuse de la FAQ a révélé que, contrairement à la description sur la page du module Drupal, les PDF sont ne pas 100% pris en charge par la bibliothèque Shadowbox. Oops.

Les deux concurrents: « PDF » et « PDF Reader »

Après avoir éliminé le reste, nous arrivons maintenant aux deux prétendants évidents: PDF et Lecteur PDF

Ces deux projets présentaient des similitudes essentielles:

• Les deux ont eu près de 3 000 installations, bien plus que les alternatives (à l'exception de Shadowbox).
• Les deux utilisaient la même bibliothèque Javascript externe, pdf.js.

Et les différences?

Lecteur PDF avait également la possibilité d'intégrer Google Docs.

Pendant ce temps, PDF a été marqué comme "Recherche de co-mainteneur(s)". Cela pourrait être un signe que le développeur abandonnerait bientôt le projet, mais d'un autre côté, le commit le plus récent était il y a une semaine, donc au moins le développeur était toujours actif.

D'autre part, Lecteur PDF a été marqué comme « maintenu activement », mais le commit le plus récent remonte à un an.

Sans vainqueur clair, nous avons décidé de les tester tous les deux.

Tester les prétendants

Nous avons testé les deux modules sur une copie de notre site en direct. (Peu importe à quel point un module semble solide et inoffensif, ne l'essayez jamais d'abord sur un site en ligne. Vous pourriez casser tout votre site.)

Nous étions biaisés envers Lecteur PDF car il semblait avoir plus d'options (comme Google Docs) que PDF. Nous avons donc décidé d'essayer PDF d'abord, pour l'enlever du chemin.

Échec du PDF: compilation requise?

Cependant, lorsque nous avons installé PDF et lisez "README.txt", nous avons découvert un problème que nous avions vu mais ignoré sur la page du projet. Pour une raison quelconque, ce module semble exiger que vous compiliez pdf.js manuellement. Bien que la page du projet ait suggéré que cela n'était pas nécessairement requis, README.txt a suggéré que c'était le cas.

Depuis Lecteur PDF utiliserait exactement la même bibliothèque sans nécessiter cette étape, nous avons finalement décidé de l'essayer en premier. Si cela ne fonctionnait pas, nous pourrions toujours revenir à PDF et essayez de compiler manuellement pdf.js.

Lecteur PDF: Succès! Sorte de

Alors, enfin, nous avons essayé Lecteur PDF. Ce module fournit un nouveau widget pour afficher un Déposer domaine. Vous ajoutez un champ de fichier à votre type de contenu et définissez le type de widget sur Lecteur PDF. Ensuite, vous créez un nœud de ce type et téléchargez votre PDF. Le PDF apparaît intégré dans une "boîte" sur la page.

Vous pouvez essayer différentes options d'affichage en modifiant à nouveau le type de contenu et en modifiant les paramètres d'affichage du champ.

Nous avons constaté que chaque option d'affichage présentait des avantages et des inconvénients:

• le Google Docs Le lecteur a bien fonctionné en tant qu'intégration, mais lorsque nous avons cliqué dessus pour passer en plein écran, nous nous sommes retrouvés sur une page Google Docs qui s'est excusée que notre limite de débit avait été dépassée. Oops. Ce serait peut-être plus fiable si nous accrochions le module à un compte Google Apps payant, mais nous n'avons pas pris la peine de le savoir.
• le pdf.js L'option a fonctionné à merveille... sur Firefox et Chrome. Mais lorsque nous avons lancé Internet Explorer, la boîte est apparue vide. Apparemment, c'est un problème avec pdf.js lui-même, pas le Lecteur PDF module. Nous supposons que c'est normal, étant donné que pdf.js est développé par Mozilla et Internet Explorer est... lui-même. Néanmoins, il est décevant que nous n'ayons pas pensé à confirmer que pdf.js fonctionnait de manière fiable sur tous les navigateurs en premier lieu.
• le incorporer l'option était la plus fiable. Cela a en fait exécuté Adobe Reader dans une boîte sur la page Web. Firefox préférait toujours exécuter pdf.js, mais nous pensons qu'il s'agissait d'un paramètre du navigateur. Dans tous les cas, tant qu'un visiteur disposait de Firefox ou d'une visionneuse PDF comme Adobe Reader, le PDF s'affichait.

Ainsi, au final, notre solution est d'utiliser le Lecteur PDF avec le Intégrer possibilité d'affichage. Cette option vous permettra de joindre un PDF à un nœud Drupal et de l'afficher de manière fiable sur une page Web Drupal.

Malheureusement, parfois "fiable" ne suffit pas.