Co je třeba vědět
- Definujte, co chcete - prohlížet soubory PDF v prohlížeči - ale pamatujte na verzi Drupalu, jakékoli licenční poplatky a počet uživatelů.
- Vyhledejte Drupal.org pro Porovnání modulů prohlížeče PDF stránka s klady a zápory pro každou možnost. Vyberte několik pravděpodobných možností.
- Vyhodnoťte každý modul prohlížeče PDF a zjistěte, jak dobře vyhovuje vašim potřebám.
Tento článek vysvětluje, jak zvolit modul Drupal 7 pro prohlížení souborů PDF. Zahrnuje vyhodnocení několika potenciálních modulů.
Definujte, co chcete
Představte si, že vás klient požádá o přidání nové funkce na web společnosti Drupal: zobrazení souborů PDF v prohlížeči. Při procházení možností na webu drupal.org si uvědomíte, že máte na výběr z několika možností.
Prvním krokem je definovat, co chcete. Obecně se jedná o poměrně standardní požadavky, které budete očekávat.
- Možnost prohlížet soubory PDF ve webovém prohlížeči, podobně jako tento příklad. Klient by nahrál soubory PDF zpravodaje společnosti a návštěvníci by si je mohli snadno přečíst.
- Stránka je Drupal 7, takže modul by tomu musel odpovídat hlavní verze. (Drupal 7 je již nějakou dobu venku, takže pokud vývojář modulů ještě nepřišel s verzí Drupal 7, pravděpodobně nebude.)
- Možná se také nebudete chtít spoléhat na službu třetí strany. U videí můžete obsah zveřejnit na YouTube nebo Vimeo a poté jej vložit na web Drupalu, ale u souborů PDF si nemyslíme, že by případné další vystavení převažovalo nad potenciálními potížemi, rozbitím a výdaje.
- Pravděpodobně budete chtít udržet modul co nejlehčí a nejkonkrétnější. Možná hledáte něco podobnějšího Barevná krabice, který zvětšuje obrázky pro lepší prohlížení, ale zůstává zcela nezávislý na tom, jak se rozhodnete spravovat obrazové soubory.
- Jako obvykle se chceme řídit obecnými pokyny pro výběr modulu Drupal. V zásadě vyberte modul, který již nějakou dobu používá několik tisíc lidí (pokud je to možné), s minimem závislostí, to se zdá být udržováno aktivním vývojářem, který plánuje pokračovat v podpoře projektu do budoucna a nevyžaduje licenci poplatek.
Hledejte na Drupal.org
S ohledem na tyto cíle byl dalším krokem a jednoduché vyhledávání na Drupal.org. Je čas skočit do Kuličkové jámy modulu Dobrota.
Stránka „Porovnání“ pro moduly PDF
Moje první zastávka byla (nebo měla být), tato stránka: a Porovnání modulů prohlížeče PDF. Drupal.org má vynikající tradici dokumentačních stránek, které popisují výhody a nevýhody různých modulů ve stejném prostoru. Je tu centrální seznam srovnávacích stránek, ale jsou také pokropeny celým webem.
Stránka porovnání PDF obsahovala čtyři moduly prohlížeče PDF. Pokryjeme je zde, stejně jako pár dalších, které jsme našli při hledání. Začneme s kandidáty, které jsme se rozhodli přeskočit.
Pojďme se nyní věnovat konkrétnostem, proč tyto moduly pro tento projekt fungovaly (nebo většinou nefungovaly).
Google Viewer File Formatter
Google Viewer File Formatter jak to zní: způsob, jak pomocí Dokumentů Google vkládat zobrazení souborů na webovou stránku. Ačkoli se nám líbila všestrannost Dokumentů Google, jedním z našich cílů bylo zůstat nezávislý na jakékoli službě třetí strany.
Tento modul měl také méně než 100 instalací.
Prohlížeč dokumentů Ajax
Ačkoli je „AJAX“ obecný termín Javascript, Prohlížeč dokumentů Ajax Ukázalo se, že se spoléhá na konkrétní službu třetí strany. Pouze asi 100 instalací. Posouvat se...
Opaření PDF
Opaření PDF měl pouze 40 instalací, ale museli jsme se podívat, protože to bylo jasně součástí většího projektu s názvem (ano) Spařit. Jak vysvětlila stránka projektu Scald: „Scald je inovativní způsob, jak zacházet Atomy médií v Drupalu. “
Tato věta vyvolala dvě obrovské červené vlajky: „inovativní převzetí“ a slovo „Media“ spárované s „Atom“. „Atom“ byl zjevně novým slovem pro „věc“, což z něj samo o sobě udělalo červenou vlajku. Drupal má zálibu v těchto slovech s prázdnou krabičkou: uzel, subjekt, Vlastnosti... Čím obecnější je slovo, tím rozsáhlejší mohou být změny.
Přečtete si nadšená tvrzení o tom, jak Scald v zásadě změní způsob, jakým zacházíte s médii na vašem webu.
Pravda nyní je, že manipulace s médii společnosti Drupal by mohla použít nějaký nový objev. Scald není jediným ambiciózním projektem v tomto prostoru.
Příští může být Scald Pohledy. To by otřáslo. Může to však být také opuštěné zboží, s (malou) stopou rozbitých stránek, které zůstaly plakat.
Shadowbox
Shadowbox překvapilo nás: tvrdilo, že je to jediné řešení pro zobrazení všech druhů médií, od PDF přes obrázky až po video. To nebylo tak rozsáhlé jako Scald, protože by se soustředilo jen na zobrazování média bez zavedení zcela nových konceptů jako „Media Atoms“. Už se nám ale líbí Colorbox, jak bylo zmíněno.
Všimli jsme si však (s vnitřním zasténáním), že to skončilo 16,000 instalace, Shadowbox může být výkonnější alternativou ve stejném prostoru. My měl podívat se.
Modul Shadowbox Drupal je v podstatě mostem ke knihovně Javascript, Shadowbox.js, tak jsme zkontrolovali web knihovny. Tam jsme objevili dva důvody, proč jít dál:
- Knihovna vyžaduje licenční poplatek za komerční použití. Poplatek byl dostatečně rozumný, ale snažíme se vyhnout open-source softwaru, který není zdarma.
- Pečlivé prohledání FAQ odhalilo, že na rozdíl od popisu na stránce modulu Drupal, soubory PDF jsou ne 100% podporováno knihovnou Shadowbox. Jejda.
Dva uchazeči: „PDF“ a „PDF Reader“
Po vyloučení zbytku jsme nyní přišli ke dvěma zjevným uchazečům: PDF a Čtečka PDF
Tyto dva projekty měly klíčové podobnosti:
- Oba měli téměř 3 000 instalací, mnohem více než alternativy (kromě Shadowboxu).
- Oba používali stejnou externí knihovnu Javascript, pdf.js.
A co rozdíly?
Čtečka PDF měl také možnost integrace Dokumentů Google.
Mezitím, PDF byl označen jako „Hledám spolupracovníky.“ To by mohlo být znamením, že vývojář brzy opustí projekt, ale na druhou stranu, nejnovější potvrzení bylo před týdnem, takže alespoň vývojář stále byl aktivní.
Na druhou stranu, Čtečka PDF byl označen jako „Aktivně udržován“, ale poslední potvrzení bylo před rokem.
Bez jasného vítěze jsme se rozhodli oba otestovat.
Testování uchazečů
Oba moduly jsme otestovali na kopii našeho živého webu. (Bez ohledu na to, jak pevný a neškodný se modul objeví, nikdy to nezkuste nejprve na živém webu. Mohli byste rozbít celý svůj web.)
Byli jsme zaujatí směrem k Čtečka PDF protože se zdálo, že má více možností (například Dokumenty Google) než PDF. Takže jsme se rozhodli to zkusit PDF za prvé, dostat to z cesty.
Selhání PDF: Vyžaduje se kompilace?
Když jsme však nainstalovali PDF a přečíst „README.txt“, objevili jsme problém, který jsme viděli, ale na stránce projektu jsme jej ignorovali. Z nějakého důvodu se zdá, že tento modul vyžaduje ruční kompilaci souboru pdf.js. Ačkoli stránka projektu naznačovala, že to není nezbytně nutné, soubor README.txt navrhl, že tomu tak bylo.
Od té doby Čtečka PDF použijeme přesně stejnou knihovnu, aniž bychom tento krok vyžadovali, rozhodli jsme se to přeci jen nejdříve vyzkoušet. Kdyby to nefungovalo, vždy bychom se mohli vrátit PDF a zkuste ručně sestavit pdf.js.
Čtečka PDF: Úspěch! Něco takového
Nakonec jsme to zkusili Čtečka PDF. Tento modul poskytuje nový widget pro zobrazení a Soubor pole. Do požadovaného pole přidáte pole pro soubor typ obsahu a nastavte typ widgetu na Čtečka PDF. Poté vytvoříte uzel tohoto typu a nahrajete svůj PDF. PDF se objeví vložený do „pole“ na stránce.
Můžete zkusit různé možnosti zobrazení opětovnou úpravou typu obsahu a změnou nastavení zobrazení pro pole.
Zjistili jsme, že každá možnost zobrazení měla klady a zápory:
- The Google dokumenty čtenář fungoval dobře jako vložení, ale když jsme na něj klikli a dostali se na celou obrazovku, skončili jsme na stránce Dokumentů Google, která se omluvila za překročení našeho limitu rychlosti. Jejda. Možná by to bylo spolehlivější, kdybychom modul připojili k platícímu účtu Google Apps, ale neobtěžovali jsme se to zjistit.
- The pdf.js Tato možnost fungovala skvěle... ve Firefoxu a Chrome. Ale když jsme spustili Internet Explorer, pole vypadalo prázdné. Zdá se, že se jedná o problém samotné pdf.js, nikoli Čtečka PDF modul. Předpokládáme, že se to dá očekávat, vzhledem k tomu, že soubor pdf.js je vyvíjen společností Mozilla a Internet Explorer je... sám o sobě. Přesto je zklamáním, že nás nenapadlo potvrdit, že soubor pdf.js fungoval spolehlivě ve všech prohlížečích.
- The vložit možnost byla nejspolehlivější. Ve skutečnosti byl spuštěn program Adobe Reader v poli na webové stránce. Firefox stále dával přednost spuštění souboru pdf.js, ale myslíme si, že toto bylo nastavení prohlížeče. Ať tak či onak, pokud měl návštěvník prohlížeč Firefox nebo PDF, jako je Adobe Reader, PDF by se zobrazil.
Nakonec tedy naším řešením je použít Čtečka PDF s Vložit možnost zobrazení. Tato možnost vám umožní připojit PDF k uzlu Drupalu a spolehlivě jej zobrazit na webové stránce Drupalu.
Bohužel někdy „spolehlivé“ nestačí.