Kuinka valita Drupal 7 -moduuli PDF-tiedostojen katseluun

Tässä artikkelissa kerrotaan, kuinka Drupal 7 -moduuli valitaan PDF-tiedostojen katselua varten. Se sisältää useiden potentiaalisten moduulien arvioinnin.

Määritä mitä haluat

Kuvittele, että asiakas pyytää sinua lisäämään uuden ominaisuuden yrityksen Drupal-sivustoon: PDF-tiedostojen näyttäminen selaimessa. Kun selaat vaihtoehtoja drupal.org-sivustossa, huomaat, että voit valita melko monista vaihtoehdoista.

Ensimmäinen vaihe on määritellä mitä haluat. Yleensä nämä ovat melko vakiovaatimuksia, joita odotat.

• Mahdollisuus tarkastella PDF-tiedostoja verkkoselaimessa, samanlainen kuin tämä esimerkki
  instagram viewer
  . Asiakas latasi yrityksen uutiskirjeen PDF-tiedostot, ja kävijät pystyivät lukemaan ne helposti.
• Sivusto on Drupal 7, joten moduulin olisi vastattava sitä pääversio. (Drupal 7 on ollut poissa jonkin aikaa, joten jos moduulikehittäjä ei ole vielä tullut Drupal 7 -versiolla, he todennäköisesti eivät.)
• Voit myös välttää luottamista kolmannen osapuolen palveluun. Videoiden osalta voit lähettää sisältöä mielellään YouTubeen tai Vimeoon ja upottaa sen sitten Drupal-sivustoon, mutta PDF-tiedostojen osalta emme usko, että mahdollinen ylimääräinen altistuminen olisi suurempi kuin mahdollinen hässäkkä, rikkoutuminen ja kustannuksella.
• Haluat todennäköisesti pitää moduulin mahdollisimman kevyenä ja tarkkana. Saatat etsiä jotain muuta Värityslaatikko, joka suurentaa kuvia parempaa katselua varten, mutta pysyy täysin riippumattomana siitä, miten valitset kuvatiedostojen hallinnan.
• Kuten tavallista, haluamme noudattaa Drupal-moduulin valinnan yleisiä ohjeita. Valitse periaatteessa moduuli, jota muutamat tuhannet ihmiset ovat jo käyttäneet (jos mahdollista) jonkin aikaa, vähäisillä riippuvuuksilla, Tämän näyttää ylläpitävän aktiivinen kehittäjä, joka aikoo jatkaa projektin tukemista tulevaisuudessa eikä vaadi lisenssiä maksu.

Hae Drupal.org-sivustolta

Nämä tavoitteet mielessä seuraava askel oli a yksinkertainen haku Drupal.org-sivustolta. Aika hypätä moduulihyvän pallokuoppaan.

PDF-moduulien vertailusivu

Ensimmäinen pysähdyspaikkani oli (tai sen olisi pitänyt olla), tämä sivu: a PDF-katseluohjelmamoduulien vertailu. Drupal.orgilla on erinomainen perinne dokumentointisivuille, joissa hahmotellaan eri moduulien edut ja haitat samassa tilassa. Siellä vertailusivujen luettelo, mutta niitä ripotellaan myös koko sivustoon.

PDF-vertailusivu sisälsi neljä PDF-katseluyksikköä. Käsittelemme ne täällä, samoin kuin pari muuta, jotka löysimme etsinnästä. Aloitamme ehdokkaista, jotka päätimme ohittaa.

Kaivetaan nyt yksityiskohtia, miksi nämä moduulit toimivat (tai eivät useimmiten) toimineet tässä projektissa.

Google Viewer File Formatter

Google Viewer File Formatter on miltä se kuulostaa: tapa käyttää Google-dokumentteja upottamaan tiedostojen näytöt verkkosivullesi. Vaikka pidimme Google-dokumenttien monipuolisuudesta, yksi tavoitteistamme oli pysyä riippumattomana mistään kolmannen osapuolen palvelusta.

Lisäksi tässä moduulissa oli alle 100 asennusta.

Ajax Document Viewer

Vaikka "AJAX" on yleinen Javascript-termi, Ajax Document Viewer osoittautui luottavansa tiettyyn kolmannen osapuolen palveluun. Vain noin 100 asennusta. Siirtyminen eteenpäin...

Palaa PDF

Palaa PDF vain 40 asennusta, mutta meidän piti katsoa, ​​koska se oli selvästi osa suurempaa projektia nimeltä (kyllä) Palaa. Kuten Scald-projektisivu selitti: "Scald on innovatiivinen tapa käsitellä Media-atomit Drupalissa. "

Tuo lause nosti kaksi valtavaa punaista lippua: "innovatiivinen otto" ja sana "Media" pariksi "Atom". "Atom" oli ilmeisesti uudelleen käytetty sana "asia", mikä teki siitä itsestään punaisen lipun. Drupalilla on taipumus näitä tyhjiä laatikoita sisältäviä sanoja: solmu, kokonaisuus, ominaisuus... Mitä yleisempi sana, sitä laajemmat muutokset voivat olla.

Luet innostuneita väitteitä siitä, kuinka Scald pohtii pohjimmiltaan uudelleen sivustosi median käsittelyä.

Totuus on, että Drupalin medianhallinta voisi käyttää joitain keksiä. Scald ei ole ainoa kunnianhimoinen projekti tässä tilassa.

Palovamma saattaa olla seuraava Näkymät. Se rokkaisi. Mutta se voi olla myös hylkäämistä, ja (pieni) polku rikkoutuneista alueista jätetään itkemään.

Varjolaatikko

Varjolaatikko yllätti meidät: se väitti olevan yksi ratkaisu kaikenlaisen median näyttämiseen PDF-tiedostoista kuviin videoihin. Tämä ei ollut niin laajaa kuin Scald, koska se keskittyi vain näytetään mediassa ottamatta käyttöön aivan uusia käsitteitä, kuten "Media Atoms". Mutta pidämme jo Colorboxista, kuten mainittiin.

Huomasimme kuitenkin (sisäisen valituksen kanssa), että yli 16,000 Asennukset, Shadowbox voisi olla tehokkaampi vaihtoehto samassa tilassa. Me oli katsoa.

Shadowbox Drupal -moduuli on pohjimmiltaan silta Javascript-kirjastoon, Shadowbox.js, joten tutustuimme kirjaston verkkosivustoon. Siellä löysimme kaksi syytä siirtyä eteenpäin:

• Kirjasto vaatii lisenssimaksun kaupalliseen käyttöön. Maksu oli riittävän kohtuullinen, mutta yritämme välttää avoimen lähdekoodin ohjelmistoja, jotka eivät ole ilmaisia.
• Huolellinen UKK-haku paljasti, että toisin kuin Drupal-moduulisivulla on kuvattu, PDF-tiedostot ovat ei 100% tukee Shadowbox-kirjasto. Oho.

Kaksi kilpailijaa: 'PDF' ja 'PDF Reader'

Poistettuamme loput pääsimme nyt kahteen ilmeiseen kilpailijaan: PDF ja PDF-lukija

Näillä kahdella projektilla oli keskeisiä yhtäläisyyksiä:

• Molemmilla oli lähes 3000 asennusta, huomattavasti enemmän kuin vaihtoehdot (paitsi Shadowbox).
• Molemmat käyttivät samaa ulkoista Javascript-kirjastoa, pdf.js.

Entä erot?

PDF-lukija myös mahdollisuus integroida Google Docs.

Sillä välin, PDF oli merkitty "etsiville ylläpitäjille". Se voi olla merkki siitä, että kehittäjä hylkää pian toisaalta viimeisin sitoutuminen oli viikko sitten, joten ainakin kehittäjä oli vielä aktiivinen.

Toisaalta, PDF-lukija merkittiin "Aktiivisesti ylläpidetyksi", mutta viimeisin sitoumus tehtiin vuosi sitten.

Ilman selkeää voittajaa päätimme testata molemmat.

Kilpailijoiden testaaminen

Testasimme molemmat moduulit live-sivustomme kopiossa. (Riippumatta siitä, kuinka kiinteä ja vaaraton moduuli näyttää, älä koskaan kokeile sitä ensin suoralla sivustolla. Voit rikkoa koko sivustosi.)

Olimme puolueellisia kohti PDF-lukija koska sillä näytti olevan enemmän vaihtoehtoja (kuten Google Docs) kuin PDF. Joten päätimme kokeilla PDF ensinnäkin saada se pois tieltä.

PDF-tiedosto epäonnistui: vaaditaanko kääntäminen?

Kuitenkin, kun asennimme PDF ja luimme "README.txt", löysimme ongelman, jonka olimme nähneet mutta jättäneet huomiotta projektisivulta. Jostain syystä tämä moduuli näyttää vaativan, että käännät pdf.js manuaalisesti. Vaikka projektisivun mukaan tätä ei välttämättä vaadittu, README.txt ehdotti sen olevan.

Siitä asti kun PDF-lukija käyttää täsmälleen samaa kirjastoa tarvitsematta tätä vaihetta, päätimme kokeilla sitä ensin. Jos se ei toiminut, voisimme aina palata PDF ja yritä kääntää pdf.js manuaalisesti.

PDF-lukija: Menestys! Eräänlainen

Joten viimeinkin yritimme PDF-lukija. Tämä moduuli tarjoaa uuden widgetin a Tiedosto ala. Lisää tiedostokenttä haluamaasi sisältötyyppi ja aseta widget-tyypiksi PDF-lukija. Sitten luot tämän tyyppisen solmun ja lataat PDF-tiedoston. PDF näkyy upotettuna sivun "laatikkoon".

Voit kokeilla erilaisia ​​näyttövaihtoehtoja muokkaamalla sisältötyyppiä uudelleen ja muuttamalla kentän näyttöasetuksia.

Huomasimme, että jokaisella näyttövaihtoehdolla oli etuja ja haittoja:

•  Google Docs lukija toimi hyvin upotuksena, mutta kun napsautimme sitä siirtyäksesi koko ruudulle, lopetimme Google Docs -sivun, joka pyysi anteeksi, että hintaraja oli ylitetty. Oho. Ehkä tämä olisi luotettavampaa, jos kiinnitämme moduulin maksavalle Google Apps -tilille, mutta emme vaivautuneet selvittämään.
•  pdf.js vaihtoehto toimi ihanasti... Firefoxilla ja Chromella. Mutta kun käynnistimme Internet Explorerin, ruutu näytti tyhjältä. Ilmeisesti tämä on ongelma itse pdf.js: ssä, ei PDF-lukija moduuli. Oletetaan, että tämä on odotettavissa, kun otetaan huomioon, että Mozilla on kehittänyt pdf.js: n ja Internet Explorer on itse. Silti on pettymys, että emme olleet ajatelleet vahvistaa, että pdf.js toimi ensinnäkin luotettavasti kaikissa selaimissa.
•  upottaa vaihtoehto oli luotettavin. Tämä suoritti Adobe Readerin verkkosivun laatikossa. Firefox halusi silti käyttää pdf.js: ää, mutta mielestämme tämä oli selainasetus. Joko niin, niin kauan kuin kävijällä oli joko Firefox tai PDF-katseluohjelma, kuten Adobe Reader, PDF näytetään.

Niinpä lopulta ratkaisumme on käyttää PDF-lukija kanssa Upottaa näyttövaihtoehto. Tämän vaihtoehdon avulla voit liittää PDF-tiedoston Drupal-solmuun ja näyttää sen luotettavasti Drupal-verkkosivulla.

Valitettavasti joskus "luotettava" ei riitä.