Hvordan velge en Drupal 7-modul for visning av PDF-filer

Denne artikkelen forklarer hvordan du velger en Drupal 7-modul for visning av PDF-filer. Det inkluderer en evaluering av flere potensielle moduler.

Definer hva du vil

Tenk deg en klient ber deg om å legge til en ny funksjon på selskapets Drupal-side: å vise PDF-filer i nettleseren. Når du blar gjennom alternativene på drupal.org, innser du at det er ganske mange alternativer du kan velge mellom.

Det første trinnet er å definere hva du vil ha. Generelt er dette ganske standardkrav som du forventer.

• Muligheten til å vise PDF-filer i en nettleser, som ligner på dette eksemplet. Kunden lastet opp PDF-filer av firmaets nyhetsbrev, og besøkende kunne enkelt lese dem.
instagram viewer
• Nettstedet er Drupal 7, så modulen må matche det hovedversjon. (Drupal 7 har vært ute en stund nå, så hvis en modulutvikler ikke har kommet ut med en Drupal 7-versjon ennå, vil de sannsynligvis ikke.)
• Det kan også være lurt å unngå å stole på en tredjepartstjeneste. For videoer kan du gjerne legge ut innholdet på YouTube eller Vimeo og deretter legge det inn på et Drupal-nettsted, men for PDF-filer, tror vi ikke den mulige ekstraeksponeringen vil oppveie potensiell problemer, brudd og kostnader.
• Du vil sannsynligvis ha modulen så lett og spesifikk som mulig. Du leter kanskje etter noe mer som Fargeboks, som forstørrer bilder for bedre visning, men forblir helt uavhengig av hvordan du velger å administrere bildefilene.
• Som vanlig ønsker vi å følge de generelle retningslinjene for valg av Drupal-modul. I utgangspunktet velger du en modul som allerede har vært i bruk av noen få tusen mennesker (hvis mulig) en stund, med et minimum av avhengighet, som ser ut til å bli vedlikeholdt av en aktiv utvikler som planlegger å fortsette å støtte prosjektet inn i fremtiden og ikke krever lisensiering avgift.

Søk på Drupal.org

Med disse målene i tankene var neste trinn a enkelt søk på Drupal.org. På tide å hoppe inn i Ball Pit of Module Goodness.

'Sammenligningsside' for PDF-moduler

Mitt første stopp var (eller burde vært), denne siden: a Sammenligning av PDF-visningsmoduler. Drupal.org har en utmerket tradisjon med dokumentasjonssider som skisserer fordeler og ulemper med forskjellige moduler i samme rom. Det er en sentral liste over sammenligningssider, men de er også strødd over hele nettstedet.

PDF-sammenligningssiden inkluderte fire PDF-visningsmoduler. Vi vil dekke dem her, så vel som et par andre vi fant fra å søke. Vi begynner med kandidatene vi bestemte oss for å hoppe over.

La oss nå gå nærmere inn på detaljene i hvorfor disse modulene fungerte (eller for det meste ikke) for dette prosjektet.

Google Viewer-filformatering

Google Viewer-filformatering er hvordan det høres ut: en måte å bruke Google Dokumenter til å bygge inn visning av filer på websiden din. Selv om vi likte allsidigheten til Google Docs, var et av målene våre å være uavhengig av tredjeparts tjenester.

Denne modulen hadde også mindre enn 100 installasjoner.

Ajax Document Viewer

Selv om "AJAX" er et generelt Javascript-begrep, Ajax Document Viewer viste seg å stole på en bestemt tredjepartstjeneste. Bare om lag 100 installasjoner. Går videre...

Scald PDF

Scald PDF hadde bare 40 installasjoner, men vi måtte ta en titt siden det helt klart var en del av et større prosjekt kalt (ja) Skålding. Som Scald-prosjektsiden forklarte: "Scald er en innovativ måte å håndtere Media Atomer i Drupal. "

Den setningen hevet to enorme røde flagg: "innovative take" og ordet "Media" parret med "Atom". "Atom" var åpenbart et nytt ord for "ting", som gjorde det til et rødt flagg helt av seg selv. Drupal har en forkjærlighet for disse ordene med tom boks: node, enhet, trekk... Jo mer generelt ordet er, desto mer feiende kan endringene være.

Du vil lese spente påstander om hvordan Scald i utgangspunktet vil finne ut hvordan du håndterer media på nettstedet ditt.

Nå er sannheten at Drupals mediehåndtering kan bruke noe på nytt. Scald er ikke det eneste ambisiøse prosjektet i dette rommet.

Scald kan være den neste Visninger. Det ville rocke. Men det kan også være abandonware, med et (lite) spor av ødelagte nettsteder igjen å gråte.

Shadowbox

Shadowbox overrasket oss: det hevdet å være en enkelt løsning for å vise alle slags medier, fra PDF-filer til bilder til video. Dette var ikke så feiende som Scald siden det bare ville fokusere på viser media uten å introdusere helt nye konsepter som "Media Atoms". Men vi liker allerede Colorbox, som nevnt.

Imidlertid la vi merke til (med et indre stønn) at med over 16,000 installerer, kan Shadowbox være et kraftigere alternativ i samme rom. Vi hadde å ta en titt.

Shadowbox Drupal-modulen er i utgangspunktet en bro til et Javascript-bibliotek, Shadowbox.js, så vi sjekket ut bibliotekets nettsider. Der oppdaget vi to grunner til å gå videre:

• Biblioteket krever lisensavgift for kommersiell bruk. Gebyret var rimelig nok, men vi prøver å unngå åpen kildekode-programvare som ikke er gratis.
• Et nøye søk på FAQ viste at PDF-filer er i motsetning til beskrivelsen på Drupal-modulsiden ikke 100% støttet av Shadowbox-biblioteket. Beklager.

The Two Contenders: 'PDF' og 'PDF Reader'

Etter å ha eliminert resten kom vi nå til de to åpenbare konkurrentene: PDF og PDF-leser

Disse to prosjektene hadde sentrale likheter:

• Begge hadde nesten 3000 installasjoner, langt mer enn alternativene (unntatt Shadowbox).
• Begge brukte det samme eksterne Javascript-biblioteket, pdf.js.

Hva med forskjeller?

PDF-leser hadde også muligheten for Google Docs-integrering.

I mellomtiden, PDF ble merket som "Søker medarbeider (e)." Det kan være et tegn på at utvikleren snart vil forlate prosjekt, men på den annen side var den siste forpliktelsen for en uke siden, så i det minste var utvikleren fortsatt aktiv.

På den andre siden, PDF-leser ble merket som "Aktivt vedlikeholdt", men den siste forpliktelsen var for et år siden.

Uten en klar vinner bestemte vi oss for å teste dem begge.

Testing av konkurrentene

Vi testet begge modulene på en kopi av vårt live nettsted. (Uansett hvor solid og ufarlig en modul vises, prøv den først på et live nettsted. Du kan ødelegge hele nettstedet.)

Vi var partisk mot PDF-leser fordi det så ut til å ha flere alternativer (for eksempel Google Docs) enn PDF. Så vi bestemte oss for å prøve PDF først, for å få det ut av veien.

PDF mislykkes: kompilering påkrevd?

Imidlertid når vi installerte PDF og les "README.txt," oppdaget vi et problem som vi hadde sett, men ignorert på prosjektsiden. Av en eller annen grunn ser det ut til at denne modulen krever at du kompilerer pdf.js manuelt. Selv om prosjektsiden antydet at dette ikke nødvendigvis var nødvendig, foreslo README.txt at det var det.

Siden PDF-leser bruker nøyaktig samme bibliotek uten å kreve dette trinnet, bestemte vi oss for å prøve det først. Hvis det ikke fungerte, kunne vi alltid gå tilbake til PDF og prøv å kompilere pdf.js. manuelt

PDF-leser: suksess! På en måte

Så til slutt, vi prøvde PDF-leser. Denne modulen gir en ny widget for visning av en Fil felt. Du legger til et filfelt etter eget ønske innholdstype og sett widgetypen til PDF-leser. Deretter oppretter du en node av denne typen og laster opp PDF-filen. PDF-filen vises innebygd i en "rute" på siden.

Du kan prøve forskjellige visningsalternativer ved å redigere innholdstypen igjen og endre skjerminnstillingene for feltet.

Vi fant ut at hvert skjermalternativ hadde fordeler og ulemper:

• De google Dokumenter leseren fungerte bra som en innebygging, men da vi klikket på den for å gå til fullskjerm, avviklet vi på en Google Docs-side som beklaget at takstgrensen vår var overskredet. Beklager. Kanskje dette ville være mer pålitelig hvis vi koblet modulen til en betalende Google Apps-konto, men vi gadd ikke finne ut av det.
• De pdf.js alternativet fungerte fantastisk... på Firefox og Chrome. Men da vi fyrte Internet Explorer, virket boksen tom. Tilsynelatende er dette et problem med pdf.js i seg selv, ikke PDF-leser modul. Vi antar at det er å forvente, gitt at pdf.js er utviklet av Mozilla og Internet Explorer er... seg selv. Likevel er det skuffende at vi ikke hadde tenkt å bekrefte at pdf.js fungerte pålitelig i alle nettlesere.
• De legge inn alternativet var det mest pålitelige. Dette kjørte faktisk Adobe Reader i en rute på websiden. Firefox foretrakk fortsatt å kjøre pdf.js, men vi tror dette var en nettleserinnstilling. Uansett, så lenge en besøkende hadde enten Firefox eller en PDF-visning som Adobe Reader, ville PDF-filen vises.

Dermed til slutt er løsningen vår å bruke PDF-leser med Bygg inn visningsalternativ. Dette alternativet lar deg legge ved en PDF til en Drupal-node og på en pålitelig måte vise den på en Drupal-webside.

Dessverre er det ikke nok med "pålitelig".