Jak wybrać moduł Drupal 7 do przeglądania plików PDF

Z tego artykułu dowiesz się, jak wybrać moduł Drupal 7 do przeglądania plików PDF. Zawiera ocenę kilku potencjalnych modułów.

Określ, czego chcesz

Wyobraź sobie, że klient prosi Cię o dodanie nowej funkcji do witryny Drupal firmy: wyświetlanie plików PDF w przeglądarce. Przeglądając opcje na drupal.org, zdajesz sobie sprawę, że istnieje wiele opcji do wyboru.

Pierwszym krokiem jest określenie, czego chcesz. Ogólnie rzecz biorąc, są to dość standardowe wymagania, których możesz się spodziewać.

• Możliwość przeglądania plików PDF w przeglądarce internetowej, podobna do ten przykład. Klient przesyłałby pliki PDF biuletynu firmy, a odwiedzający mogliby je łatwo przeczytać.
instagram viewer
• Strona jest Drupal 7, więc moduł musiałby to dopasować wersja główna. (Drupal 7 jest już od jakiegoś czasu niedostępny, więc jeśli programista modułu nie wydał jeszcze wersji Drupala 7, prawdopodobnie nie zrobi tego.)
• Możesz także uniknąć polegania na usługach innych firm. W przypadku filmów możesz z przyjemnością opublikować treść na YouTube lub Vimeo, a następnie osadzić ją w witrynie Drupal, ale w przypadku plików PDF nie uważamy, że ewentualna dodatkowa ekspozycja przewyższałaby potencjalne problemy, uszkodzenia i koszt.
• Prawdopodobnie będziesz chciał, aby moduł był tak lekki i szczegółowy, jak to tylko możliwe. Być może szukasz czegoś bardziej jak Kolorowe pudełko, który powiększa obrazy w celu lepszego oglądania, ale pozostaje całkowicie niezależny od wybranego sposobu zarządzania plikami obrazów.
• Jak zwykle chcemy kierować się ogólnymi wytycznymi dotyczącymi wyboru modułu do Drupala. Zasadniczo wybierz moduł, który jest już używany przez kilka tysięcy osób (jeśli to możliwe) od jakiegoś czasu, z minimum zależności, który wydaje się być utrzymywany przez aktywnego programistę, który planuje nadal wspierać projekt w przyszłości i nie wymaga licencji opłata.

Szukaj na Drupal.org

Mając na uwadze te cele, następnym krokiem było: proste wyszukiwanie na Drupal.org. Czas wskoczyć do Ball Pit of Module Dobroci.

Strona „Porównanie” modułów PDF

Moim pierwszym przystankiem była (lub powinna była być) ta strona: a Porównanie modułów przeglądarki PDF. Drupal.org ma doskonałą tradycję stron z dokumentacją, które przedstawiają zalety i wady różnych modułów w tej samej przestrzeni. Jest centralna lista stron porównawczych, ale są też rozsiane po całej witrynie.

Strona porównania plików PDF zawierała cztery moduły przeglądarki plików PDF. Omówimy je tutaj, a także kilka innych, które znaleźliśmy podczas wyszukiwania. Zaczniemy od kandydatów, których zdecydowaliśmy się pominąć.

Teraz zagłębimy się w szczegóły, dlaczego te moduły działały (lub w większości nie działały) w tym projekcie.

Program do formatowania plików przeglądarki Google

Program do formatowania plików przeglądarki Google brzmi, jak to brzmi: sposób korzystania z Dokumentów Google do umieszczania wyświetlanych plików na swojej stronie internetowej. Chociaż podobała nam się wszechstronność Dokumentów Google, jednym z naszych celów było zachowanie niezależności od usług innych firm.

Ponadto ten moduł miał mniej niż 100 instalacji.

Przeglądarka dokumentów Ajax

Chociaż "AJAX" jest ogólnym terminem Javascript, Przeglądarka dokumentów Ajax okazało się polegać na konkretnej usłudze innej firmy. Tylko około 100 instalacji. Iść dalej...

Oparzenie PDF

Oparzenie PDF miał tylko 40 instalacji, ale musieliśmy się przyjrzeć, ponieważ był to wyraźnie część większego projektu o nazwie (tak) Oparzenie. Jak wyjaśniono na stronie projektu Scald: „Scald to innowacyjne podejście do obsługi Atomy mediów w Drupalu."

To zdanie podniosło dwa ogromne czerwone flagi: „innowacyjne podejście” i słowo „Media” w połączeniu z „Atomem”. „Atom” było oczywiście zmienionym słowem oznaczającym „rzecz”, co samo w sobie uczyniło z niego czerwoną flagę. Drupal ma upodobanie do takich pustych słów: węzeł, jednostka, funkcja... Im bardziej ogólne słowo, tym bardziej radykalne mogą być zmiany.

Przeczytasz podekscytowane twierdzenia o tym, jak Scald zasadniczo zmieni sposób obsługi multimediów w Twojej witrynie.

Prawda jest taka, że ​​obsługa mediów w Drupalu przydałaby się trochę na nowo. Scald to nie jedyny ambitny projekt w tej przestrzeni.

Oparzenie może być następnym Wyświetlenia. To by się kołysało. Ale może to być również porzucone oprogramowanie z (niewielkim) śladem niedziałających witryn, które mogą płakać.

Pudełko cieni

Pudełko cieni zaskoczył nas: twierdził, że jest to jedno rozwiązanie do wyświetlania wszelkiego rodzaju multimediów, od plików PDF po obrazy i wideo. To nie było tak rozległe jak Scald, ponieważ skupiałoby się tylko na wyświetlanie media bez wprowadzania zupełnie nowych koncepcji, takich jak „Media Atoms”. Ale już lubimy Colorbox, jak wspomniano.

Zauważyliśmy jednak (z wewnętrznym jękiem), że z ponad 16,000 instaluje się, Shadowbox może być potężniejszą alternatywą w tej samej przestrzeni. My miał spojrzeć.

Moduł Shadowbox Drupal jest w zasadzie pomostem do biblioteki Javascript, Shadowbox.js, więc sprawdziliśmy stronę internetową biblioteki. Tam odkryliśmy dwa powody, aby przejść dalej:

• Biblioteka wymaga opłaty licencyjnej do użytku komercyjnego. Opłata była dość rozsądna, ale staramy się unikać oprogramowania typu open source, które nie jest darmowe.
• Dokładne przeszukanie FAQ wykazało, że wbrew opisowi na stronie modułu Drupal, pliki PDF są nie W 100% obsługiwane przez bibliotekę Shadowbox. Ups.

Dwóch pretendentów: „PDF” i „Czytnik PDF”

Po wyeliminowaniu reszty doszliśmy teraz do dwóch oczywistych pretendentów: PDF i Czytnik PDF

Te dwa projekty miały kluczowe podobieństwa:

• Oba miały prawie 3000 instalacji, znacznie więcej niż alternatywy (z wyjątkiem Shadowbox).
• Oba korzystały z tej samej zewnętrznej biblioteki Javascript, pdf.js.

A co z różnicami?

Czytnik PDF miał również opcję integracji z Dokumentami Google.

W międzyczasie, PDF została oznaczona jako „Poszukuję współopiekunów”. Może to oznaczać, że deweloper wkrótce porzuci projekt, ale z drugiej strony ostatni commit miał miejsce tydzień temu, więc przynajmniej deweloper był nadal aktywny.

Z drugiej strony, Czytnik PDF został oznaczony jako „Aktywnie utrzymywany”, ale ostatnie zatwierdzenie miało miejsce rok temu.

Bez wyraźnego zwycięzcy postanowiliśmy przetestować je oba.

Testowanie pretendentów

Przetestowaliśmy oba moduły na kopii naszej działającej strony. (Bez względu na to, jak solidny i nieszkodliwy wydaje się moduł, nigdy nie próbuj go najpierw na działającej stronie. Możesz zepsuć całą witrynę.)

Byliśmy stronniczy w kierunku Czytnik PDF ponieważ wydawało się, że ma więcej opcji (takich jak Dokumenty Google) niż PDF. Postanowiliśmy więc spróbować PDF po pierwsze, aby usunąć to z drogi.

Błąd PDF: wymagana kompilacja?

Jednak kiedy zainstalowaliśmy PDF i przeczytaliśmy "README.txt", odkryliśmy problem, który widzieliśmy, ale zignorowaliśmy na stronie projektu. Z jakiegoś powodu ten moduł wydaje się wymagać ręcznej kompilacji pdf.js. Chociaż strona projektu sugerowała, że ​​nie jest to konieczne, README.txt sugerował, że tak.

Od Czytnik PDF używałby dokładnie tej samej biblioteki bez konieczności wykonywania tego kroku, zdecydowaliśmy się jednak najpierw spróbować. Gdyby to nie zadziałało, zawsze mogliśmy wrócić do PDF i spróbuj ręcznie skompilować pdf.js.

Czytnik PDF: Sukces! Raczej

Więc w końcu spróbowaliśmy Czytnik PDF. Ten moduł udostępnia nowy widżet do wyświetlania Plik pole. Dodajesz pole pliku do żądanego Typ zawartości i ustaw typ widżetu na Czytnik PDF. Następnie tworzysz węzeł tego typu i przesyłasz swój plik PDF. Plik PDF jest osadzony w „ramce” na stronie.

Możesz wypróbować różne opcje wyświetlania, ponownie edytując typ zawartości i zmieniając ustawienia wyświetlania pola.

Odkryliśmy, że każda opcja wyświetlania miała zalety i wady:

•  Dokumenty Google czytnik działał dobrze jako osadzony, ale kiedy kliknęliśmy go, aby przejść na pełny ekran, znaleźliśmy się na stronie Dokumentów Google, która przeprosiła, że ​​nasz limit szybkości został przekroczony. Ups. Być może byłoby to bardziej niezawodne, gdybyśmy podłączyli moduł do płatnego konta Google Apps, ale nie zadaliśmy sobie trudu, aby się tego dowiedzieć.
•  pdf.js opcja działała cudownie... w Firefoksie i Chrome. Ale kiedy odpaliliśmy Internet Explorera, pudełko okazało się puste. Najwyraźniej jest to problem z samym pdf.js, a nie z Czytnik PDF moduł. Przypuszczamy, że można się tego spodziewać, biorąc pod uwagę, że pdf.js jest rozwijany przez Mozillę, a Internet Explorer jest… sam w sobie. Mimo wszystko to rozczarowujące, że nie pomyśleliśmy, aby potwierdzić, że pdf.js działa niezawodnie we wszystkich przeglądarkach.
•  osadzać opcja była najbardziej niezawodna. To faktycznie uruchomiło Adobe Reader w polu na stronie internetowej. Firefox nadal wolał uruchamiać pdf.js, ale uważamy, że było to ustawienie przeglądarki. Tak długo, jak odwiedzający miał Firefoksa lub przeglądarkę plików PDF, taką jak Adobe Reader, plik PDF byłby wyświetlany.

Tak więc ostatecznie naszym rozwiązaniem jest użycie Czytnik PDF z Osadzać opcja wyświetlania. Ta opcja pozwoli Ci dołączyć plik PDF do węzła Drupal i niezawodnie wyświetlić go na stronie Drupal.

Niestety czasami „niezawodność” nie wystarcza.