Примерно изследване в областта на избора на модули
Наскоро клиент ме помоли да добавите нова функция към сайта на Drupal на компанията: показване на PDF файлове в браузъра. Докато разглеждах опциите на drupal.org, разбрах, че това е перфектен шанс да документирам моя действителен процес на вземане на решения, тъй като избрах нов модул . Винаги казвам да избирам модулите разумно , но сега можете да видите как мисля, че това работи в реалния живот.
Определете какво искате
Първата стъпка е да определите какво искате. В моя случай исках:
- Способността да разглеждате PDF файлове в уеб браузър, подобен на този пример. Клиентът ще качи PDF файлове на фирмения бюлетин и посетителите ще могат лесно да ги четат.
- Сайтът е Drupal 7 , така че модулът ще трябва да съответства на тази основна версия . (Drupal 7 вече е за известно време, така че ако разработчикът на модули все още не е излязъл с Drupal 7 версия, вероятно няма.)
- Въпреки че клиентът не уточни това, аз също исках да не се разчита на услуга на трета страна. За видеоклипове, аз съм щастлив да публикувате съдържанието в YouTube или Vimeo и след това да го вградите на сайт на Drupal, но за PDF файлове, аз не мисля, че възможната допълнителна експозиция ще надделее над потенциалните неприятности, счупвания и разходи. Въпреки това бях отворена за трета страна, ако това беше единствената възможност.
- Въпреки желанието си да избегна услугата на трети страни, знаех, че изборът ми вероятно ще изисква трета странична библиотека с Javascript. Въпреки че това би добавило допълнителна стъпка към бъдещи подобрения, по принцип се чувствам по-добре да пускам собствено копие на библиотека, вместо да разчитам на услуга на трети страни.
- Исках да поддържа модула възможно най-лек и специфичен. Не исках да се занимавам с някакъв радикално нов начин на обработка или организиране на медийни файлове. Исках нещо повече като Colorbox, което увеличава изображенията за по-добро гледане, но остава напълно независима от начина, по който решавате да управлявате файловете с изображения. Имах учудване, че тази библиотека ще бъде pdf.js, но бях отворена към други възможности.
- Както обикновено, исках да следвам общите насоки за избора на модул на Drupal. По принцип изберете модул, който вече е бил използван от няколко хиляди души (ако е възможно) за известно време, с минимални зависимости, който изглежда се поддържа от активен предприемач, който планира да продължи да подкрепя проекта в бъдеще и не " т изисква лицензионна такса.
Търсене в Drupal.org
С оглед на тези цели, следващата стъпка беше просто търсене на Drupal.org. Време е да влезете в топлото ядро на модула Доброта.
& # 34; Сравнение & # 34; Страница за PDF модули
Първата ми спирка беше (или трябваше да е) тази страница: Сравнение на PDF модулите за преглед. Drupal.org има отлична традиция в страниците за документация, които очертават плюсовете и минусите на различните модули в едно и също пространство. Има централен списък със страници за сравнение, но те също се поръсват по целия сайт.
Страницата за сравнение PDF включваше четири PDF модула за преглед. Ще ги покрия тук, както и няколко други, които намерих от търсене. Ще започна с кандидатите, които реших да пропусна.
Сега нека разгледаме подробностите за това, защо тези модули са работили (или най-вече не са) за този проект.
Файлов преглед
File Viewer използва Internet Archive BookReader, който ме заинтригува, защото съм интернет боксьор. Всеки път, когато отивам там, чувствам се дръзко от страх и се сривам в планините на книги, които мога да изтръгна от етера.
Това казано, демонстрационният сайт изглеждаше малко грозен за мен. Можех да живея с него, но се съмнявах, че клиентът ми ще изглежда, когато pdf.js изглежда много по-стилно.
Също така, на втория поглед на страницата на проекта, видях голямото смело съобщение в горната част: Този модул бе преместен официално в PDF модул . Достатъчно честно. С по-малко от 400 инсталирания, сливането с по-популярния PDF модул (което ще покрием в един миг), изглежда като добър ход. Никога не изтегляйте модул, който е обединен / преместен / изоставен.
Форматор на файловете на Google Viewer
Форматорът на файловете на Google Viewer е онова, което звучи: начин да използвате Google Документи, за да вградите показването на файлове във вашата уеб страница. Макар да ми харесаше гъвкавостта на Google Документи, една от моите цели бе да остана независима от всяка трета страна.
Също така този модул имаше по-малко от 100 инсталирания.
Документ за преглед на документи на
Въпреки че "AJAX" е общ Javascript термин, Ajax Document Viewer се оказа, че разчита на конкретна услуга на трети страни. Само около 100 инсталирания. Преместване на...
Scald PDF
Scald PDF имаше само 40 инсталации, но трябваше да погледна, тъй като беше ясно част от по-голям проект, наречен (да) Scald. Както обясняваше страницата на проекта Scald: " Scald е иновативна идея как да се справяме с Media Atoms в Drupal".
Тази присъда повдигна два огромни червени знамена: "новаторски" и думата "Медия", съчетана с "Atom". "Атом" очевидно е повторена дума за "нещо", което я прави червено знаме само по себе си. Drupal има склонност към тези думи с празни кутии: възел , обект , функция ... Колкото по-общата е думата, толкова по-широко могат да се променят промените.
Докато скролирах, подозренията ми бяха потвърдени. Четох развълнувани твърдения за това как Скард ще основно преоткрие как се справих с медиите на моя сайт.
Сега истината е, че манипулацията на Drupal Media може да използва известно преоткриване. Scald не е единственият амбициозен проект в това пространство. Въпреки това, с по-малко от 1000 инсталирания досега, не исках да вляза в приземния етаж.
Разбира се, до този момент следващата година, Салдлд може да бъде следващите изгледи . Това щеше да се появи. Но може да е и abandonware, с (малка) следа от счупени обекти, оставени да плачат.
Засега исках да се придържам към много по-малко амбициозно и опасно решение. Просто показване на PDF файлове, моля. Това е всичко, което исках.
Shadowbox
Shadowbox ме изненада: твърди, че е едно решение за показване на всички видове медии - от PDF файлове до изображения до видео. Това не беше толкова мащабно, колкото Скалд, тъй като се фокусира единствено върху излагането на медиите, без да въвежда цели нови понятия като "Медия атомите". Но вече харесвам Colorbox, както споменах. Не исках да преосмислям това решение.
Обаче направих бележка (с вътрешна стена), че с над 16 000 инсталирания, Shadowbox може да бъде по-мощна алтернатива в едно и също пространство. Трябваше да погледна.
Модулът Shadowbox Drupal е основно мост към Javascript библиотека, Shadowbox.js, така че проверих сайта на библиотеката. Там открих две причини да продължа:
- Библиотеката изисква лицензионна такса за търговска употреба. Таксата беше достатъчно разумна, но се опитвам да избегна софтуер с отворен код, който не е безплатен .
- Внимателното търсене на често задавани въпроси разкри, че противно на описанието на модула на Drupal, PDF файловете не се поддържат 100% от библиотеката Shadowbox. Ами сега. Добро нещо, което проверих.
Двамата претенденти: & # 34; PDF & # 34; и PDF четец & # 34;
След като отстраних останалата част, сега стигнах до двамата очевидни претенденти: PDF и PDF Reader
Тези два проекта имат ключови прилики:
- И двете имат почти 3000 инсталирания, много повече от алтернативите (освен Shadowbox).
- И двете използват същата външна Javascript библиотека, pdf.js.
Ами разликите?
PDF Reader има и опцията за интегриране в Google Документи. В този конкретен случай мислех, че моят клиент може да хареса това, така че ми хареса да имам възможността.
Междувременно PDF бе отбелязан като Търсене на съ-поддържащи. Това може да е знак, че разработчикът скоро ще се откаже от проекта, но от друга страна, най-скорошната ангажираност беше преди седмица, така че поне разработчикът все още беше активен.
От друга страна, PDF Reader бе означен като "Активно поддържан", но последният ангажимент беше преди година.
Без ясен победител реших да ги изпробвам и двете.
Тестване на претендентите
Тествах двата модула на копие на моя сайт на живо. (Независимо колко солиден и безвреден се появява модулът, никога не го изпробвайте първо на живо сайт. Може да счупите целия си сайт.)
Бях пристрастен към PDF Reader , защото изглежда имаше повече опции (като Google Документи), отколкото PDF . Затова реших първо да опитам PDF , за да го измъкна от пътя.
Неуспешно PDF: Необходима ли е компилация?
Въпреки това, когато инсталирах PDF и прочетох README.txt, открих проблем, който бях виждал, но не обърнах внимание на страницата на проекта. По някаква причина изглежда, че този модул изисква да компилирате pdf.js ръчно. Въпреки че на страницата на проекта е предложено, че това не е задължително, README.txt предложи това.
Тъй като PDF Reader би използвал същата библиотека, без да изисква тази стъпка, реших да го пробвам най-напред. Ако не се получи, винаги можех да се върна към PDF и да се опитам да компилирам ръчно pdf.js.
PDF четец: Успех! Нещо като.
Така че най-сетне опитах PDF Reader . Този модул предоставя ново приспособление за показване на поле на файл. Добавяте файлово поле към желания Ви тип съдържание и зададете типа приспособление към PDF четеца. След това създавате възел от този тип и качвате своя PDF файл. PDF файлът е вграден в "кутия" на страницата.
Можете да изпробвате различни опции за показване, като редактирате отново типа съдържание и промените настройките на дисплея за полето.
Открих, че всяка опция за показване имаше плюсове и минуси:
- Четецът на Google Документи работи добре като вграждане, но когато кликнах върху него, за да отида на цял екран, завърших на страница в Google Документи, която се извини, че лимитът ми за лихвен процент е надхвърлен. Ами сега. Може би това би било по-надеждно, ако закачах модула към платена Google Apps сметка, но не си направих труда да го разбера, тъй като бях сигурен, че моят клиент няма да хареса дисплея.
- Опцията pdf.js работи чудесно ... в Firefox и Chrome. Но когато изстрелях Internet Explorer, кутията изглеждаше празна. Очевидно това е проблем с самия pdf.js, а не с PDF Reader модула. Предполагам, че трябваше да очаквам това, като се има предвид, че pdf.js е разработен от Mozilla и Internet Explorer е ... сам. Все пак бях разочарован, че не мислех да потвърдя, че pdf.js работеше надеждно във всички браузъри на първо място.
- Опцията за вграждане беше най-надеждната. Това всъщност вървеше Adobe Reader в кутия на уеб страницата. Моят Firefox все още предпочита да работи с pdf.js, но мисля, че това е настройка на браузъра. Така или иначе, стига посетителят да има Firefox или PDF преглед като Adobe Reader, PDF файлът ще се покаже.
Така, в крайна сметка, моето решение беше да използвам PDF Reader с опцията за показване на вградения файл . Тази опция ще ми позволи да прикача PDF файл към Drupal възел и надеждно да го покажа на уеб страница на Drupal.
За съжаление, понякога "надежден" не е достатъчен. След всичко това търсене, трябваше да помисля за трета страна, в края на краищата.