Studju ta 'Każ fl-Art tal-Għażla tal-Modulu
Riċentement, klijent staqsa li żid karatteristika ġdida fis-sit ta 'Drupal tal-kumpanija: wera fajls PDF fil-browser. Kif għażilt l-għażliet fuq drupal.org, indunajt li din kienet opportunità perfetta biex tiddokumenta l-proċess attwali tiegħi ta 'teħid ta' deċiżjonijiet billi għażilt modulu ġdid. Jien dejjem qal li jagħżlu moduli bil-għaqal , imma issa tista 'tara kif naħseb li dan jaħdem fil-ħajja reali.
Iddefinixxi dak li Trid
L-ewwel pass huwa li tiddefinixxi dak li trid. Fil-każ tiegħi, ridt:
- L-abbiltà li tara fajls PDF f'websajt, simili għal dan l-eżempju. Il-klijent għandu jniżżel PDFs tan-newsletter tal-kumpanija, u l-viżitaturi jkunu jistgħu jaqrawhom faċilment.
- Is-sit huwa Drupal 7 , għalhekk il-modulu jeħtieġ li jqabbel dik il -verżjoni ewlenija . (Drupal 7 ilu għal żmien twil issa, hekk jekk żviluppatur tal-modulu għadu ma ħareġx verżjoni Drupal 7 għadhom, x'aktarx mhux ser ikunu.)
- Għalkemm il-klijent ma speċifikax dan, jien ridt ukoll li tevita li sserraħ fuq servizz ta 'parti terza. Għal videos, jien kuntent li nwassal il-kontenut lil YouTube jew lil Vimeo u mbagħad daħħalha fuq sit ta 'Drupal, imma għal PDFs, ma kontx naħseb li l-espożizzjoni żejda possibbli kienet tkun akbar mill-battikata potenzjali, ksur u spejjeż. Madankollu, kont miftuħ għal servizz ta 'parti terza jekk din kienet l-unika għażla.
- Minkejja x-xewqa tiegħi li jiġi evitat servizz ta 'parti terza, kont naf li l-għażla tiegħi x'aktarx teħtieġ librerija Javascript ta' parti terza. Għalkemm dan iżid pass ieħor fuq titjib fil-ġejjieni, ġeneralment inħossni aħjar dwar it-tmexxija tal-kopja tiegħi ta 'librerija minflok ma toqgħod fuq servizz ta' parti terza.
- Jien ridt li żżomm il-modulu bħala ħfief u speċifiku kemm jista 'jkun. Ma rridx nidħol f'xi mod radikalment ġdid ta 'maniġġjar jew ta' organizzazzjoni ta 'fajls tal-midja. Xtaqt xi ħaġa aktar bħal Colorbox, li tkabbar immaġni għal wiri aħjar, iżda tibqa 'kompletament indipendenti minn kif tagħżel li timmaniġġja l-fajls ta' l-immaġini. Kelli niddejjaq li din il-librerija tkun pdf.js, imma kont miftuħ għal possibilitajiet oħra.
- Bħas-soltu, jien ridt li ssegwi l-linji gwida ġenerali għall-għażla ta 'modulu Drupal. Bażikament, jagħżlu modulu li diġà kien qed jintuża minn ftit eluf ta 'persuni (jekk possibbli) għal awhile, b'minimu ta' dipendenzi, li jidher li jinżamm minn żviluppatur attiv li jippjana li jżomm is-sostenn tal-proġett fil-futur u ma ' T jeħtieġu dritt ta 'liċenzjar.
Fittex fuq Drupal.org
B'dawn l-għanijiet f'moħħha, il-pass li jmiss kien tfittxija sempliċi fuq Drupal.org. Ħin biex tiżdied fil-Pit Ball of Module Goodness.
& # 34; Tqabbil & # 34; Paġna għal Moduli PDF
L-ewwel waqfa tiegħi kienet (jew suppost kienet), din il-paġna: a Tqabbil ta 'moduli tat-telespettaturi PDF. Drupal.org għandu tradizzjoni eċċellenti ta 'paġni ta' dokumentazzjoni li jiddeskrivu l-vantaġġi u l-iżvantaġġi ta 'diversi moduli fl-istess spazju. Hemm lista ċentrali ta 'paġni ta' tqabbil, iżda huma wkoll imxerrda madwar is-sit.
Il-paġna ta 'paragun PDF inkludiet erba' moduli tat-telespettaturi PDF. I ser ikopruhom hawn, kif ukoll ftit oħrajn li sibt mit-tiftix. Ser nibda bil-kandidati li ddeċidejt li skip.
Issa ejja nidħol fl-ispeċifiċitajiet ta 'għaliex dawn il-moduli għamlu (jew fil-biċċa l-kbira tagħhom ma kinux) xogħol għal dan il-proġett.
Viewer tal-Fajl
File Viewer juża l-Internet Archive BookReader, li intrigued lili għaliex jien junkie Archive Internet. Kull darba li mmur hemm, inħoss li jkollok mumenti ta 'biża' u jisbqu fil-muntanji ta 'kotba nista' nqumu mill-etere.
That being said, is-sit ta 'dimostrazzjoni deher ftit ikrah lili. Jista 'ngħix miegħu, iżda ddubitat li l-klijent tiegħi, meta pdf.js jidher tant aktar stylish.
Ukoll, fuq it-tieni ħarsa lejn il-paġna tal-proġett, rajt it-tħabbira grassa kbira fil-quċċata: Dan il-modulu ġie trasferit għall-modulu PDF formalment . Ġust biżżejjed. B'inqas minn 400 installazzjoni, li tingħaqad mal-modulu PDF aktar popolari (li aħna ser ikopri f'mument), jidher li hu pass tajjeb. Qatt m'għandek tniżżel modulu li ngħaqad / tmexxi / abbandunat.
Format tal-Fajl tal-Google Viewer
Google Viewer File Formatter huwa dak li ħsejjes bħal: mod kif tuża Google Docs biex tinkludi stampi ta 'fajls fil-paġna web tiegħek. Għalkemm ħobb il-versatilità ta 'Google Docs, wieħed mill-għanijiet tiegħi kien li jibqa' indipendenti minn kwalunkwe servizz ta 'parti terza.
Ukoll, dan il-modulu kellu inqas minn 100 installazzjoni.
Ajax Document Viewer
Għalkemm "AJAX" huwa terminu Javascript ġenerali, l-Ajax Document Viewer irriżulta li jiddependi fuq servizz speċifiku ta 'parti terza. Madwar 100 installazzjoni biss. Nimxu fuq ...
Scald PDF
Scald PDF kellu biss 40 installazzjoni, iżda kelli nħares, peress li kien ċarament parti minn proġett akbar imsejjaħ (iva) Scald. Hekk kif spjegat il-paġna ta 'proġett Scald: " Scald hija soluzzjoni innovattiva dwar kif timmaniġġa l -Atomi tal-Midja f'Drupal ."
Dik is-sentenza qajmet żewġ bnadar ħomor enormi: "tieħu innovattiv" u l-kelma "Midja" mqabbla ma '"Atom". "Atom" kien ovvjament kelma repurposed għal "ħaġa", li għamlitha banner aħmar waħdu. Drupal għandu tendenza għal dawn it-tip ta 'kelma vojta ta' kliem: node , entità , karatteristika ... L-aktar ġenerali tal-kelma, aktar ma jkun hemm bdil fil-bidliet.
Kif skrollajt, is-suspetti tiegħi ġew ikkonfermati. Naqra t-talbiet eċċitati ta 'kif Scald bażikament se jivvinta mill-ġdid kif ittrattat il-Midja fuq is-sit tiegħi.
Issa, il-verità hija li l-immaniġġjar tal-Midja ta 'Drupal jista' juża xi ftit li xejn. Scald mhuwiex l-uniku proġett ambizzjuż f'dan l-ispazju. Madankollu, b'inqas minn 1000 installazzjoni s'issa, ma riedx nilqa 'fil-pjan terran.
Żgur, minn din id-darba s-sena d-dieħla, Scald jista 'jkun il- Views li jmiss. Dak ikun blat. Iżda jista 'jkun ukoll l-abbandun, bi traċċa (żgħira) ta' siti miksura li jitħallew jisirqu.
Għal issa, jien ridt nibqa 'b'soluzzjoni inqas ambizzjuża u perikoluża. Biss murija PDFs, jekk jogħġbok. Dak kollu li kont qed nitlob.
Shadowbox
Shadowbox sorpriż lili: iddikjara li hija soluzzjoni waħda biex turi kull xorta ta 'midja, minn PDFs għal stampi għal vidjow. Dan ma kienx daqshekk qawwi daqs Scald, peress li jiffoka biss fuq il- wirja tal- midja mingħajr ma jintroduċi kunċetti ġodda kollha bħal "Atomi tal-Midja". Imma jien diġà ngħid lil Colorbox, kif semmejt. Ma rridx li jkolli naħsbu mill-ġdid dik id-deċiżjoni.
Madankollu, għamilt nota (bil-groan ta 'ġewwa) li b'aktar minn 16,000 installazzjoni, Shadowbox tista' tkun alternattiva aktar qawwija fl-istess spazju. Kelli nħares.
Il-modulu Shadowbox Drupal huwa bażikament pont għal librerija Javascript, Shadowbox.js, hekk għedt il-websajt tal-librerija. Hawnhekk, sibt żewġ raġunijiet biex timxi fuq:
- Il-librerija teħtieġ tariffa tal-liċenzja għal użu kummerċjali. It-tariffa kienet raġonevoli biżżejjed, iżda nipprova tevita softwer open source li mhuwiex ħieles .
- Tfittxija bir-reqqa tal-FAQ wriet li, kuntrarjament għad-deskrizzjoni fuq il-paġna tal-modulu Drupal, PDFs mhumiex 100% appoġġjati mill-librerija Shadowbox. Oops. Ħaġa tajba I ċċekkjat.
Iż-Żewġ Kontendenti: & # 34; PDF & # 34; u & # 34; PDF Reader & # 34;
Wara li elimina l-bqija, issa wasalt għand iż-żewġ kontendenti ovvji: PDF u PDF Reader
Dawn iż-żewġ proġetti kellhom similaritajiet ewlenin:
- It-tnejn kellhom kważi 3,000 installazzjonijiet, ferm iktar mill-alternattivi (minbarra Shadowbox).
- Kemm użaw l-istess librerija esterna Javascript, pdf.js.
Xi ngħidu dwar id-differenzi?
PDF Reader kellu wkoll l-għażla għall-integrazzjoni tal-Google Docs. F'dan il-każ partikolari, ħsibt li l-klijent tiegħi jista 'jkun hekk, hekk ħabblu li kellna l-għażla.
Sadanittant, PDF kien immarkat bħala "Seeking co-maintainer (s)". Dan jista 'jkun sinjal li l-iżviluppatur dalwaqt jabbanduna l-proġett, iżda min-naħa l-oħra, l-impenn l-aktar reċenti kien ġimgħa ilu, għallinqas l-iżviluppatur kien għadu attiv.
Min-naħa l-oħra, PDF Reader kienet immarkata bħala Żamma Attiva, iżda l-aktar impenn reċenti kien sena ilu.
Mingħajr rebbieħ ċar, iddeċidejt li ttestjahom it-tnejn.
Ittestjar tal-Kontendenti
Jiena għamilt test fuq iż-żewġ moduli fuq kopja tas-sit ħaj tiegħi. (Ma jimpurtax kemm jidher modulu solidu u innoċidu, qatt ma tipprova l-ewwel fuq sit ħaj. Tista 'tkisser is-sit kollu tiegħek.)
I kien preġudikat lejn PDF Reader , minħabba li deher li kellu aktar għażliet (bħal Google Docs) minn PDF . Allura ddeċidejt li tipprova l - ewwel ta 'l- PDF , biex twassalha mill-mod.
PDF Fail: Tinħtieġ il-Kumpilazzjoni?
Madankollu, meta stallajt PDF u aqra README.txt, skoprejt problema li rajt imma injorat fuq il-paġna tal-proġett. Għal xi raġuni, dan il-modulu jidher li jeħtieġ li inti tiġbor pdf.js manwalment. Għalkemm il-paġna tal-proġett issuġġeriet li dan mhux neċessarjament kien meħtieġ, README.txt issuġġerixxa li kien.
Peress li PDF Reader juża l-istess librerija eżatta mingħajr ma jeħtieġ dan il-pass, iddeċidejt li nipprova l-ewwelnett wara kollox. Jekk ma taħdimx, dejjem nista 'nirreferi għall- PDF u nipprova nikkompila manwalment pdf.js.
PDF Reader: Suċċess! Speċita.
Allura, fl-aħħar, ippruvajt PDF Reader . Dan il-modulu jipprovdi widget ġdid għall-wiri ta 'qasam File. Inti żid qasam tal-fajl mat- tip ta 'kontenut mixtieq tiegħek u stabbilixxijt it-tip ta' widget għal PDF Reader. Imbagħad, toħloq node ta 'dan it-tip u ttella' l-PDF tiegħek. Il-PDF jidher inkorporat f '"kaxxa" fuq il-paġna.
Tista 'tipprova l-għażliet differenti tal-wirja billi torganizza t-tip ta' kontenut mill-ġdid u tbiddel il-settings tal-wirja għall-qasam.
Sibt li kull għażla tal-wirja kellha punti favur u kontra:
- Il-qarrej tal- Google Docs ħadem tajjeb bħala embed, iżda meta għedt biex tmur fuq skrin sħiħ, inħejja fuq paġna ta 'Google Docs li skużża li dak il-limitu tar-rata kien inqabeż. Oops. Forsi dan ikun iktar affidabbli jekk niġi l-modulu għal kont ta 'ħlas Google Apps, iżda ma kontx naf li nsib, peress li kont żgur li l-klijent tiegħi ma kienx jixtieq li juri.
- L-għażla ta ' pdf.js ħadmet tajjeb ... fuq Firefox u Chrome. Imma meta felli l-Internet Explorer, il-kaxxa deher vojta. Apparentement, din hija problema bi pdf.js innifisha, mhux il - modulu tal- PDF Reader . Nissopponi li kellna nistennew dan, minħabba li pdf.js hija żviluppata minn Mozilla u l-Internet Explorer hija ... innifisha. Xorta waħda, kont diżappuntat li ma ħasssiex nikkonferma li pdf.js ħadmu b'mod affidabbli madwar il-browsers kollha fl-ewwel post.
- L - għażla ta ' inkorporazzjoni kienet l-iktar affidabbli. Dan fil-fatt dam l-Adobe Reader f'kaxxa fuq il-paġna web. My Firefox għadu preferut li jmexxi pdf.js, imma naħseb li dan kien iffissar tal-brawżer. Jew il-mod, sakemm viżitatur kellu jew Firefox jew telespettatur PDF bħal Adobe Reader, il-PDF kien juri.
Għalhekk, fl-aħħar, is-soluzzjoni tiegħi kienet li tuża l- PDF Reader bl-għażla tal-wiri Embed . Din l-għażla tippermetti lili li tehmeż PDF ma 'node ta' Drupal, u wiri b'mod affidabbli fuq paġna web ta 'Drupal.
Sfortunatament, kultant "affidabbli" mhix biżżejjed. Wara kollox dan it-tiftix, kelli nikkunsidra servizz ta 'parti terza wara kollox.