Come scegliere un modulo Drupal 7 per visualizzare i PDF

Questo articolo spiega come scegliere un modulo Drupal 7 per visualizzare i PDF. Include una valutazione di diversi moduli potenziali.

Definisci cosa vuoi

Immagina che un cliente ti chieda di aggiungere una nuova funzionalità al sito Drupal dell'azienda: visualizzare i file PDF nel browser. Mentre navighi tra le opzioni su drupal.org, ti rendi conto che ci sono alcune opzioni tra cui scegliere.

Il primo passo è definire quello che vuoi. In generale, questi sono requisiti abbastanza standard che ti aspetteresti.

• La possibilità di visualizzare file PDF in un browser Web, simile a questo esempio
  instagram viewer
  . Il cliente caricherebbe i PDF della newsletter aziendale e i visitatori sarebbero in grado di leggerli facilmente.
• Il sito è Drupal 7, quindi il modulo dovrebbe corrispondere a quello versione principale. (Drupal 7 è uscito da un po' di tempo, quindi se uno sviluppatore di moduli non è ancora uscito con una versione di Drupal 7, probabilmente non lo farà.)
• Potresti anche voler evitare di fare affidamento su un servizio di terze parti. Per i video, potresti essere felice di pubblicare il contenuto su YouTube o Vimeo e poi incorporarlo in un sito Drupal, ma per i PDF, non pensiamo che la possibile esposizione extra supererebbe il potenziale fastidio, rottura e spese.
• Probabilmente vorrai mantenere il modulo il più leggero e specifico possibile. Potresti cercare qualcosa di più simile Scatola dei colori, che ingrandisce le immagini per una migliore visualizzazione ma rimane completamente indipendente da come scegli di gestire i file di immagine.
• Come al solito, vogliamo seguire le linee guida generali per la scelta di un modulo Drupal. Fondamentalmente, scegli un modulo che è già stato utilizzato da qualche migliaio di persone (se possibile) per un po ', con un minimo di dipendenze, che sembra essere mantenuto da uno sviluppatore attivo che prevede di continuare a supportare il progetto in futuro e non richiede una licenza tassa.

Cerca su Drupal.org

Con questi obiettivi in ​​mente, il passo successivo è stato un semplice ricerca su Drupal.org. È ora di saltare nella fossa delle palline del modulo Bontà.

Pagina "Confronto" per moduli PDF

La mia prima tappa è stata (o avrebbe dovuto essere), questa pagina: a Confronto tra i moduli del visualizzatore PDF PDF. Drupal.org ha un'eccellente tradizione di pagine di documentazione che delineano i pro ei contro di vari moduli nello stesso spazio. C'è un elenco centrale delle pagine di confronto, ma sono anche sparsi in tutto il sito.

La pagina di confronto PDF includeva quattro moduli di visualizzazione PDF. Li tratteremo qui, così come un paio di altri che abbiamo trovato dalla ricerca. Inizieremo con i candidati che abbiamo deciso di saltare.

Ora approfondiamo nello specifico il motivo per cui questi moduli hanno funzionato (o per lo più non hanno funzionato) per questo progetto.

Formattatore di file del visualizzatore di Google

Formattatore di file del visualizzatore di Google è come sembra: un modo per utilizzare Google Docs per incorporare visualizzazioni di file nella tua pagina web. Sebbene ci piacesse la versatilità di Google Documenti, uno dei nostri obiettivi era rimanere indipendenti da qualsiasi servizio di terze parti.

Inoltre, questo modulo aveva meno di 100 installazioni.

Visualizzatore di documenti Ajax

Sebbene "AJAX" sia un termine Javascript generico, Visualizzatore di documenti Ajax si è rivelato fare affidamento su uno specifico servizio di terze parti. Solo circa 100 installazioni. Andare avanti...

Scaldare PDF

Scaldare PDF aveva solo 40 installazioni, ma abbiamo dovuto dare un'occhiata poiché era chiaramente parte di un progetto più ampio chiamato (sì) Scottare. Come ha spiegato la pagina del progetto Scald: "Scald è una versione innovativa di come gestire Atomi multimediali a Drupal."

Quella frase ha sollevato due enormi bandiere rosse: "prendere in modo innovativo" e la parola "Media" abbinata a "Atom". "Atomo" era ovviamente una parola riproposta per "cosa", che lo ha reso una bandiera rossa da solo. Drupal ha un debole per queste parole a scatola vuota: nodo, entità, caratteristica... Più generica è la parola, più radicali possono essere i cambiamenti.

Leggerai affermazioni entusiaste di come Scald reinventerà sostanzialmente il modo in cui gestisci i media sul tuo sito.

Ora, la verità è che la gestione dei media di Drupal potrebbe aver bisogno di essere reinventata. Scald non è l'unico progetto ambizioso in questo spazio.

Scald potrebbe essere il prossimo Visualizzazioni. Sarebbe rock. Ma potrebbe anche essere abbandonato, con una (piccola) scia di siti rotti lasciati a piangere.

Shadowbox

Shadowbox ci ha sorpreso: affermava di essere un'unica soluzione per visualizzare tutti i tipi di media, dai PDF alle immagini ai video. Non era così radicale come Scald poiché si sarebbe concentrato solo su visualizzazione media senza introdurre concetti completamente nuovi come "Media Atoms". Ma ci piace già Colorbox, come detto.

Tuttavia, abbiamo notato (con un gemito interiore) che con over 16,000 installa, Shadowbox potrebbe essere un'alternativa più potente nello stesso spazio. Noi aveva dare un'occhiata.

Il modulo Shadowbox Drupal è fondamentalmente un ponte verso una libreria Javascript, Shadowbox.js, quindi abbiamo controllato il sito web della biblioteca. Lì, abbiamo scoperto due motivi per andare avanti:

• La biblioteca richiede un canone di licenza per uso commerciale. La tariffa era abbastanza ragionevole, ma cerchiamo di evitare il software open source che non è gratuito.
• Un'attenta ricerca delle FAQ ha rivelato che, contrariamente alla descrizione nella pagina del modulo Drupal, i PDF sono non Supportato al 100% dalla libreria Shadowbox. Ops.

I due contendenti: "PDF" e "PDF Reader"

Dopo aver eliminato il resto, siamo ora giunti ai due ovvi contendenti: PDF e Lettore PDF

Questi due progetti avevano somiglianze fondamentali:

• Entrambi avevano quasi 3.000 installazioni, molto più delle alternative (eccetto Shadowbox).
• Entrambi utilizzavano la stessa libreria Javascript esterna, pdf.js.

E le differenze?

Lettore PDF aveva anche l'opzione per l'integrazione di Google Documenti.

Nel frattempo, PDF è stato contrassegnato come "Cercasi co-manutentori". Questo potrebbe essere un segno che lo sviluppatore abbandonerà presto il progetto, ma d'altra parte, il commit più recente risale a una settimana fa, quindi almeno lo sviluppatore era fermo attivo.

D'altro canto, Lettore PDF è stato contrassegnato come "Mantenuto attivo", ma il commit più recente risale a un anno fa.

Senza un chiaro vincitore, abbiamo deciso di testarli entrambi.

Testare i contendenti

Abbiamo testato entrambi i moduli su una copia del nostro sito live. (Non importa quanto un modulo appaia solido e innocuo, non provarlo mai prima su un sito live. Potresti rompere l'intero sito.)

Eravamo prevenuti verso Lettore PDF perché sembrava avere più opzioni (come Google Docs) di PDF. Così abbiamo deciso di provare PDF prima, per toglierlo di mezzo.

PDF non riuscito: compilazione richiesta?

Tuttavia, quando abbiamo installato PDF e leggere "README.txt", abbiamo scoperto un problema che avevamo visto ma ignorato nella pagina del progetto. Per qualche ragione, questo modulo sembra richiedere la compilazione manuale di pdf.js. Sebbene la pagina del progetto suggerisse che questo non era necessariamente richiesto, README.txt suggeriva che lo fosse.

Da Lettore PDF utilizzerebbe la stessa identica libreria senza richiedere questo passaggio, dopo tutto abbiamo deciso di provarlo prima. Se non funzionava, potremmo sempre tornare a PDF e prova a compilare manualmente pdf.js.

Lettore PDF: successo! Una specie di

Così, finalmente, abbiamo provato Lettore PDF. Questo modulo fornisce un nuovo widget per la visualizzazione di a File campo. Aggiungi un campo file a quello che desideri tipo di contenuto e imposta il tipo di widget su Lettore PDF. Quindi, crei un nodo di questo tipo e carichi il tuo PDF. Il PDF appare incorporato in un "riquadro" sulla pagina.

Puoi provare diverse opzioni di visualizzazione modificando nuovamente il tipo di contenuto e modificando le impostazioni di visualizzazione per il campo.

Abbiamo scoperto che ogni opzione di visualizzazione aveva vantaggi e svantaggi:

• Il documenti Google reader ha funzionato bene come incorporamento, ma quando abbiamo fatto clic su di esso per passare a schermo intero, siamo finiti su una pagina di Google Documenti che si è scusata per il superamento del limite di frequenza. Ops. Forse questo sarebbe più affidabile se collegassimo il modulo a un account Google Apps a pagamento, ma non ci siamo preoccupati di scoprirlo.
• Il pdf.js l'opzione ha funzionato meravigliosamente... su Firefox e Chrome. Ma quando abbiamo avviato Internet Explorer, la casella sembrava vuota. Apparentemente, questo è un problema con pdf.js stesso, non con il Lettore PDF modulo. Supponiamo che sia prevedibile, dato che pdf.js è sviluppato da Mozilla e Internet Explorer è... stesso. Tuttavia, è deludente che non avessimo pensato di confermare che pdf.js funzionasse in modo affidabile su tutti i browser in primo luogo.
• Il incorporare l'opzione era la più affidabile. Questo in realtà ha eseguito Adobe Reader in una casella nella pagina web. Firefox preferiva ancora eseguire pdf.js, ma pensiamo che fosse un'impostazione del browser. Ad ogni modo, finché un visitatore aveva Firefox o un visualizzatore PDF come Adobe Reader, il PDF verrebbe visualizzato.

Quindi, alla fine, la nostra soluzione è usare il Lettore PDF con il Incorporare opzione di visualizzazione. Questa opzione ti consentirà di allegare un PDF a un nodo Drupal e di visualizzarlo in modo affidabile su una pagina Web Drupal.

Sfortunatamente, a volte "affidabile" non è abbastanza.