Kajian Kes dalam Seni Pemilihan Modul
Baru-baru ini, pelanggan meminta saya untuk menambah ciri baru ke laman Drupal syarikat: memaparkan fail PDF dalam penyemak imbas. Semasa saya melihat pilihan di drupal.org, saya menyedari bahawa ini adalah peluang yang sempurna untuk mendokumenkan proses membuat keputusan saya ketika saya memilih modul baru. Saya selalu mengatakan untuk memilih modul secara bijak , tetapi sekarang anda dapat melihat bagaimana saya fikir ini berfungsi dalam kehidupan sebenar.
Tentukan Apa yang Anda Mahu
Langkah pertama ialah menentukan apa yang anda mahukan. Dalam kes saya, saya mahu:
- Keupayaan untuk melihat fail PDF dalam pelayar web, serupa dengan contoh ini. Pelanggan akan memuat naik PDF surat berita syarikat, dan pelawat dapat membaca dengan mudah.
- Laman web ini adalah Drupal 7 , jadi modul itu perlu dipadankan dengan versi utama . (Drupal 7 telah keluar untuk sementara waktu sekarang, jadi jika pemaju modul tidak keluar dengan versi Drupal 7 lagi, mereka mungkin tidak akan.)
- Walaupun pelanggan tidak menyatakan ini, saya juga ingin mengelakkan daripada bergantung kepada perkhidmatan pihak ketiga. Untuk video, saya dengan senang hati menyiarkan kandungan itu ke YouTube atau Vimeo dan kemudian membenamkannya di laman Drupal, tetapi untuk PDF, saya tidak fikir kemungkinan pendedahan tambahan akan melebihi potensi kerumitan, kerosakan, dan perbelanjaan. Walau bagaimanapun, saya terbuka kepada perkhidmatan pihak ketiga sekiranya ia satu-satunya pilihan.
- Walaupun ingin menghindari perkhidmatan pihak ketiga, saya tahu pilihan saya mungkin memerlukan pustaka Javascript pihak ketiga. Walaupun ini akan menambahkan langkah tambahan pada peningkatan masa depan, saya biasanya merasa lebih baik untuk menjalankan salinan perpustakaan saya sendiri dan bukannya bergantung kepada perkhidmatan pihak ketiga.
- Saya mahu mengekalkan modul sebagai ringan dan khusus yang mungkin. Saya tidak mahu terlibat dengan cara pengendalian atau mengatur fail media yang baru. Saya mahu sesuatu yang lebih seperti Colorbox, yang membesarkan imej untuk tontonan yang lebih baik, tetapi tetap sepenuhnya bebas daripada cara anda memilih untuk menguruskan fail imej. Saya mempunyai firasat bahawa perpustakaan ini akan menjadi pdf.js, tetapi saya terbuka kepada kemungkinan lain.
- Seperti biasa, saya mahu mengikut garis panduan umum untuk memilih modul Drupal. Pada asasnya, memilih modul yang telah digunakan oleh beberapa ribu orang (jika boleh) untuk sementara waktu, dengan sedikit kebergantungan, yang sepertinya dikekalkan oleh pemaju aktif yang merancang untuk terus menyokong projek itu pada masa depan dan tidak ' Tidak memerlukan yuran pelesenan.
Cari Drupal.org
Dengan matlamat ini, langkah seterusnya adalah carian mudah di Drupal.org. Masa untuk melompat ke dalam Lubang Bola Modul Kebaikan.
& # 34; Perbandingan & # 34; Halaman untuk Modul PDF
Perhentian pertama saya adalah (atau sepatutnya), halaman ini: Perbandingan modul pemapar PDF. Drupal.org mempunyai tradisi laman dokumentasi yang menggariskan kebaikan dan keburukan pelbagai modul dalam ruang yang sama. Terdapat senarai pusat halaman perbandingan, tetapi mereka juga ditaburkan di seluruh laman web ini.
Halaman perbandingan PDF termasuk empat modul penonton PDF. Saya akan melindungi mereka di sini, dan juga pasangan lain yang saya dapati dari mencari. Saya akan mulakan dengan calon yang saya memutuskan untuk melangkau.
Sekarang mari kita bincangkan spesifik mengapa modul ini (atau kebanyakannya tidak) berfungsi untuk projek ini.
Pemapar Fail
Pemapar Fail menggunakan Arkib Internet BookReader, yang menarik minat saya kerana saya seorang peminat Internet Archive. Setiap kali saya pergi ke sana, saya rasa geli takut dan membanjir di gunung-gunung buku yang saya dapat memetik dari eter.
Bahawa dikatakan, laman demonstrasi kelihatan sedikit hodoh kepada saya. Saya mungkin hidup dengannya, tetapi saya meragui pelanggan saya apabila pdf.js kelihatan lebih bergaya.
Juga, pada pandangan kedua di halaman projek, saya melihat pengumuman berani besar di bahagian atas: Modul ini telah dipindahkan ke modul PDF secara rasmi . Cukup adil. Dengan kurang daripada 400 pemasangan, penggabungan dengan modul PDF yang lebih popular (yang akan kami tutup dalam sekejap), kelihatan seperti langkah yang baik. Jangan muat turun modul yang telah digabungkan / dipindahkan / terbengkalai.
Format Penerima Google Viewer
Format Pemapar Google Viewer adalah seperti apa: cara untuk menggunakan Google Docs untuk membenamkan paparan fail di halaman web anda. Walaupun saya suka fleksibiliti Google Docs, salah satu matlamat saya adalah untuk tetap bebas daripada sebarang perkhidmatan pihak ketiga.
Juga, modul ini mempunyai kurang daripada 100 pemasangan.
Penonton Dokumen Ajax
Walaupun "AJAX" adalah istilah umum Javascript, Penampil Dokumen Ajax ternyata bergantung pada perkhidmatan pihak ketiga tertentu. Hanya kira-kira 100 pemasangan. Bergerak ...
Scald PDF
Scald PDF hanya mempunyai 40 pemasangan, tetapi saya perlu melihat, kerana ia jelas merupakan sebahagian daripada projek yang lebih besar yang dipanggil (ya) Scald. Seperti yang dijelaskan dalam halaman projek Scald: " Scald adalah mengambil inovatif tentang cara mengendalikan Atom Media di Drupal."
Kalimah itu menimbulkan dua bendera merah besar: "mengambil inovatif" dan perkataan "Media" dipasangkan dengan "Atom". "Atom" jelas merupakan perkataan yang dipungkiri untuk "benda", yang menjadikannya bendera merah semuanya dengan sendirinya. Drupal mempunyai kecenderungan untuk kata-kata kotak kosong: nod , entiti , ciri ... Yang lebih umum perkataan, semakin banyak perubahan yang terjadi.
Ketika saya turun ke bawah, syak wasangka saya telah disahkan. Saya membaca tuntutan gembira tentang bagaimana Scald pada dasarnya akan mencipta semula bagaimana saya mengendalikan Media di laman web saya.
Sekarang, hakikatnya pengendalian Media Drupal boleh menggunakan beberapa pengaturcaraan semula. Scald bukan satu-satunya projek bercita-cita tinggi dalam ruang ini. Bagaimanapun, dengan kurang daripada 1000 pemasangan setakat ini, saya tidak mahu masuk ke tingkat bawah.
Pasti, pada masa ini tahun depan, Scald mungkin Pandangan seterusnya. Itu akan menjadi batu. Tetapi ia juga mungkin ditinggalkan, dengan jejak (kecil) tapak yang rosak ditinggalkan untuk menangis.
Buat masa ini, saya mahu melekat dengan penyelesaian yang kurang bercita-cita tinggi dan berbahaya. Hanya paparkan PDF, sila. Itulah yang saya minta.
Shadowbox
Shadowbox mengejutkan saya: ia mendakwa sebagai penyelesaian tunggal untuk memaparkan semua jenis media, dari PDF ke imej ke video. Ini tidak menyapu sebagai Scald, kerana ia hanya memberi tumpuan kepada memaparkan media tanpa memperkenalkan konsep baru seperti "Atom Media". Tetapi saya sudah seperti Colorbox, seperti yang saya nyatakan. Saya tidak mahu memikirkan semula keputusan itu.
Walau bagaimanapun, saya perhatikan (dengan mengerang dalam) dengan lebih daripada 16,000 pemasangan, Shadowbox boleh menjadi alternatif yang lebih berkuasa di ruang yang sama. Saya terpaksa melihat.
Modul Shadowbox Drupal pada dasarnya adalah jambatan ke perpustakaan Javascript, Shadowbox.js, jadi saya menyemak laman web perpustakaan. Di sana, saya dapati dua sebab untuk bergerak:
- Perpustakaan memerlukan yuran lesen untuk kegunaan komersil. Yurannya cukup masuk akal, tetapi saya cuba mengelakkan perisian sumber terbuka yang tidak bebas .
- Mencari teliti dari FAQ mendedahkan, bertentangan dengan perihalan pada halaman modul Drupal, PDF tidak 100% disokong oleh perpustakaan Shadowbox. Oops. Perkara baik saya diperiksa.
The Two Contenders: & # 34; PDF & # 34; dan & # 34; PDF Reader & # 34;
Setelah menghapuskan selebihnya, saya kini datang ke dua pesaing yang jelas: PDF dan PDF Reader
Kedua-dua projek mempunyai persamaan utama:
- Kedua-duanya mempunyai hampir 3,000 pemasangan, jauh lebih banyak daripada alternatif (kecuali Shadowbox).
- Kedua-duanya menggunakan perpustakaan Javascript luaran yang sama, pdf.js.
Bagaimana dengan perbezaan?
PDF Reader juga mempunyai pilihan untuk integrasi Google Docs. Dalam kes ini, saya fikir pelanggan saya mungkin seperti itu, jadi saya suka mempunyai pilihan.
Sementara itu, PDF ditandakan sebagai Mencari penyenggara bersama. Itu boleh menjadi tanda bahawa pemaju akan meninggalkan projek itu, tetapi sebaliknya, komitmen terbaru adalah seminggu yang lalu, jadi sekurang-kurangnya pemaju masih aktif.
Sebaliknya, PDF Reader ditandakan sebagai dikekalkan secara aktif, tetapi komitmen terbaru adalah setahun yang lalu.
Tanpa pemenang yang jelas, saya memutuskan untuk menguji kedua-duanya.
Menguji Peserta
Saya menguji kedua-dua modul pada salinan tapak langsung saya. (Tidak kira betapa padat dan tidak bersesuaian modul muncul, jangan mencuba terlebih dahulu di tapak langsung. Anda boleh memecahkan keseluruhan laman web anda.)
Saya berat sebelah ke arah PDF Reader , kerana ia kelihatan mempunyai lebih banyak pilihan (seperti Dokumen Google) daripada PDF . Jadi, saya memutuskan untuk mencuba PDF terlebih dahulu, untuk mengelakkannya.
Fail PDF: Penyusunan Diperlukan?
Walau bagaimanapun, apabila saya memasang PDF dan membaca README.txt, saya dapati masalah yang saya lihat tetapi tidak diabaikan pada halaman projek. Untuk sebab tertentu, modul ini seolah-olah menghendaki anda menyusun pdf.js secara manual. Walaupun halaman projek mencadangkan bahawa ini tidak semestinya diperlukan, README.txt mencadangkan ia.
Oleh kerana PDF Reader akan menggunakan perpustakaan yang sama tanpa memerlukan langkah ini, saya memutuskan untuk mencuba terlebih dahulu. Sekiranya tidak berfungsi, saya boleh kembali ke PDF dan cuba menyusun pdf.js secara manual.
Pembaca PDF: Kejayaan! Lebih kurang.
Jadi, pada akhirnya, saya cuba PDF Reader . Modul ini menyediakan widget baru untuk memaparkan medan Fail. Anda menambah medan fail ke jenis kandungan yang anda inginkan dan tetapkan jenis widget ke PDF Reader. Kemudian, anda membuat nod jenis ini dan memuat naik PDF anda. PDF muncul dibenamkan dalam "kotak" pada halaman.
Anda boleh mencuba pilihan paparan yang berbeza dengan mengedit semula jenis kandungan dan mengubah tetapan paparan untuk medan.
Saya mendapati bahawa setiap pilihan paparan mempunyai kebaikan dan keburukan:
- Pembaca Dokumen Google berfungsi dengan baik sebagai embedding, tapi apabila saya mengkliknya untuk pergi skrin penuh, saya meloloskan pada halaman Google Docs yang memohon maaf bahawa had laju saya telah melebihi. Oops. Mungkin ini lebih dipercayai jika saya menyambungkan modul ini kepada akaun Google Apps yang membayar, tetapi saya tidak peduli untuk mengetahui, kerana saya yakin pelanggan saya tidak suka paparan.
- Opsyen pdf.js bekerja hebat ... di Firefox dan Chrome. Tetapi apabila saya memecat Internet Explorer, kotak itu kosong. Rupa-rupanya, ini adalah masalah dengan pdf.js itu sendiri, bukan modul PDF Reader . Saya rasa saya sepatutnya menjangkakan ini, memandangkan pdf.js yang dibangunkan oleh Mozilla dan Internet Explorer ... itu sendiri. Namun, saya kecewa kerana saya tidak menyangka bahawa pdf.js bekerja dengan pasti di semua pelayar di tempat pertama.
- Pilihan menanam adalah yang paling boleh dipercayai. Ini sebenarnya berlari Adobe Reader dalam kotak di laman web. Firefox saya masih lebih suka menjalankan pdf.js, tetapi saya fikir ini adalah tetapan penyemak imbas. Sama ada, selagi pelawat mempunyai Firefox atau penampil PDF seperti Adobe Reader, PDF akan dipaparkan.
Jadi, pada akhirnya, penyelesaian saya adalah menggunakan PDF Reader dengan pilihan paparan Benamkan . Pilihan ini akan membolehkan saya melampirkan PDF ke nod Drupal, dan dengan pasti memaparkannya di laman web Drupal.
Malangnya, kadangkala "dipercayai" tidak mencukupi. Selepas semua pencarian ini, saya perlu mempertimbangkan perkhidmatan pihak ketiga selepas semua.