Модульді іріктеу өнері бойынша мысал
Жақында клиент компанияның 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 Интернет мұрағаты BookReader пайдаланады, ол мені қызықтырды, себебі мен Интернеттегі мұрағаттың есірткі екендігіме байланысты. Мен әр жерге барған сайын, эфирден жұлып алатын кітаптардың тауларында қорқыныш пен қорқынышты сезінемін.
Айтуға болады, демонстрациялық сайт маған аздап ұнамады. Мен онымен өмір сүре аламын, бірақ мен pdf.js әлдеқайда стильді көрінсе, клиентім күмәнданатын.
Сондай-ақ, жоба бетіне екінші рет қараған кезде, мен жоғарыдан батыл хабарландыруды көрдім: Бұл модуль форматтағы PDF модуліне көшірілді . Әбден жеткілікті. 400-ден кем қондырғылармен, танымал PDF-модулімен біріктіріледі (бір сәтте біз оны жабатын боламыз) жақсы қадам сияқты көрінеді. Біріктірілген / жылжытылған / тасталған модульді ешқашан жүктемеңіз.
Google Viewer файл пішімдеушісі
Google Viewer файл пішімдеушісі мына сияқты көрінеді: Google Docs файлын веб-беттегі файлдарды бейнелеу үшін пайдалану тәсілі. Google құжаттарының әмбебаптығы маған ұнады, бірақ менің мақсаттарымның бірі кез келген үшінші тарап қызметтеріне тәуелсіз болу болды.
Сондай-ақ, бұл модульде 100-ден аз орнату бар.
Ajax құжатты қарау құралы
«AJAX» жалпы Javascript термині болса да, Ajax Document Viewer белгілі бір үшінші тарап қызметтеріне сүйенді. Тек шамамен 100 орнату. Жылжытуда ...
Scald PDF
«Scald PDF» -те 40-ға жуық қондырғы бар еді, бірақ мен оны қарауға тура келді. Scald жобасының беті түсіндіргендей, « Scald - бұл Drupal-дағы Медиа Атомды қалай өңдеуге болатыны туралы жаңалық.»
Бұл сөйлем екі үлкен қызыл жалаушаны көтерді: «инновациялық қадам» және «Медиа» сөзі «атоммен» жұпталған. «Атом» сөзі «нәрсе» деген сөздің айқын көрінісі еді, ол оны қызыл жалаумен жасады. Drupal сөздің бұл түріне арналған түйме сөзі бар: түйін , нысан , функция ... Сөздің неғұрлым жалпы болса, өзгерістерді неғұрлым кеңейте алады.
Содан кейін, менің күдіктерім расталған. Мен Скальдтың сайтымыздағы БАҚ-мен қалай жұмыс істегенімді қайтадан ойлап табатыны туралы толқытылған мәлімдемелерді оқыдым.
Енді, шындық, Drupal-дің медиа-регламенті кейбір жаңартуларды қолдануы мүмкін. Scald - осы кеңістіктегі жалғыз амбициялық жоба емес. Дегенмен, әзірше 1000-нан аз қондырғысы бар, мен бірінші қабатқа кіргім келмеді.
Әрине, осы жолы келесі жылы Scald келесі Көрулер болуы мүмкін. Бұл рок. Бірақ ол сондай-ақ тастанды болуы мүмкін, сынған сайттар (жылжытып) қалдыру үшін кішкентай.
Қазір мен әлдеқайда аз амбициоздық және қауіпті шешіммен ұстанғым келді. Тек PDF-ті көрсетіңіз. Мұның бәрін сұрадым.
Shadowbox
Shadowbox мені таң қалдырды: PDF түріндегі бейнелерден бейнеге дейінгі барлық түрдегі медианы көрсетудің жалғыз шешімінің бірі. Бұл Скальд секілді емес, өйткені ол «Media Atoms» сияқты жаңа ұғымдарды енгізбестен, бұқаралық ақпарат құралдарын көрсетуге ғана назар аударатын еді. Бірақ, маған айтқанымдай Colorbox дегенді ұнатамын. Мен бұл шешімді қайта ойластырғым келмеді.
Дегенмен, мен 16 000- нан астам орнатылымдармен бірге Shadowbox бір кеңістікте күшті балама бола алатындығын (ішкі ыстықпен) атап өтті. Мен қарастыру керек болды .
Shadowbox Drupal модулі негізінен Javascript кітапханасына арналған Shadowbox.js кітапханасына көпір болып табылады, сондықтан мен кітапхананың веб-торабын тексердім. Онда жүрудің екі себебін таптым:
- Кітапхана коммерциялық пайдалану үшін лицензияны талап етеді. Сыйақы ақылға қонымды болды, бірақ мен ашық бастапқы коды жоқ бағдарламалық жасақтамадан аулақ болуға тырысамын .
- Жиі қойылатын сұрақтарды мұқият іздестіру Drupal модулінің бетіндегі сипаттамаға қарама-қайшы екенін көрсетті, бұл PDF-ті Shadowbox кітапханасы 100% қолдайды. Көрінбейтін. Мен тексерген жақсы нәрсе.
Екі қатысушы: & # 34; PDF & # 34; & # 34; PDF Reader & # 34;
Қалғандарды алып тастағаннан кейін, мен екі айқын үміткерге келдім: PDF және PDF Reader
Бұл екі жобаның негізгі ұқсастықтары болды:
- Олардың екеуінде 3000-ға жуық қондырғы бар еді, олар альтернативалардан көп болды (Shadowbox-тен басқа).
- Екі бірдей сыртқы Javascript кітапханасы, pdf.js.
Ал айырмашылықтар туралы не деуге болады?
PDF Reader- те Google Docs біріктіруге мүмкіндік бар. Бұл жағдайда клиенттің ұнауы мүмкін деп ойладым, сондықтан маған опционды ұнатады.
Сонымен қатар, PDF пішімінде бірлесіп жұмыс істейтін (іздеушілер) іздестіру ретінде белгіленді. Бұл әзірлеуші жақында жобадан бас тартатындығын, ал екінші жағынан, ең соңғы тапсырма бір апта бұрын болғандығын белгісі болуы мүмкін, сондықтан кем дегенде әзірлеуші әлі белсенді болған.
Екінші жағынан, PDF Reader белсенді түрде сақталып қойылды, бірақ ең соңғы міндеттеме бір жыл бұрын болды.
Белсенді жеңімпаз болмай тұрып, екеуін де сынап көруді шештім.
Қатысушыларды тестілеу
Мен екі модульді де менің тірі сайтымның көшірмесіне сынап көрдім. (Модульдің қаншалықты қатты және зиянсыз екендігіне қарамастан, оны ешқашан тірі сайтта көрмеңіз).
Мен PDF Reader- ке қарсы болдым, өйткені PDF- ге қарағанда көбірек опциялар (Google Docs сияқты) бар сияқты. Сондықтан алдымен PDF- ні көруді жөн көрдім.
PDF Fail: Компиляция қажет пе?
Дегенмен PDF мен README.txt оқығанда, мен көрдім, бірақ жоба бетінде еленбейтін мәселені таптым. Бұл модуль қандай да бір себептермен pdf.js қолмен жасалатындығын талап етеді. Жобаның беті бұл міндетті түрде талап етілмейтінін айтса да, README.txt бұл ұсынысты ұсынды.
PDF Reader сол қадамды қажет етпей, сол кітапхананы пайдаланатындықтан, мен оны бірінші кезекте сынап көруді шештім. Егер ол жұмыс істемесе, мен әрдайым PDF-ке оралуға және pdf.js-ты қолмен құрастыруға тырысқан болар едім.
PDF Reader: табысты! Сұрыптау.
Мәселен, көп ұзамай, мен PDF Reader көріңіз. Бұл модуль Файл өрісін көрсету үшін жаңа виджетті ұсынады. Файл өрісін қалаған мазмұн түріне қосасыз және виджет түрін PDF оқу құралына орнатасыз. Содан кейін сіз осы түрдің түйінін жасайсыз және PDF файлыңызды жүктеп аласыз. PDF беттегі «қорапқа» салынған болады.
Мазмұн түрін қайта өңдеу және өріс үшін дисплей параметрлерін өзгерту арқылы әртүрлі көрсету параметрлерін көріңіз.
Мен әр көрнекі нұсқада артықшылықтар мен кемшіліктер бар екенін білдім:
- Google Docs оқырманы ендірме ретінде жақсы жұмыс істеді, бірақ оны толық экранға өту үшін басқан кезде, Google Docs бетінде менің тарифтік шегімнің асып кеткенін кешірді. Көрінбейтін. Модульді Google Apps есептік жазбасына төлегенде, бұл сенімдірек болар еді, бірақ мен білмеймін, себебі клиенттің дисплейге ұнайтындығына сенімдімін.
- Pdf.js опциясы керемет ... Firefox және Chrome-да жұмыс істеді. Бірақ Internet Explorer-ді шығарғанымда, қорап бос болды. Әлбетте, бұл PDF Reader модуліне емес, pdf.js-дің өзі. Менің ойымша, бұл pdf.js Mozilla компаниясы әзірлеген және Internet Explorer-дің өзі - бұл ... деп ойлаймын. Дегенмен, pdf.js бірінші кезекте барлық браузерлерде сенімді жұмыс істегенін растамады деп ойламадым.
- Ендіру параметрі ең сенімді болды. Бұл шынымен Adobe Reader веб-парағындағы қорапқа жүгірді. Менің Firefox әлі pdf.js файлын іске қосуды қалады, бірақ бұл браузер параметрі деп ойлаймын. Қалай болғанда да, келуші Firefox немесе Adobe Reader сияқты PDF қарау құралы болған кезде, PDF көрсетіледі.
Осылайша, менің шешімім PDF Reader- ді Embed display параметрімен пайдалану болды. Бұл опция PDF файлын Drupal түйініне тіркеуге және оны Drupal веб-бетінде сенімді түрде көрсетуге мүмкіндік береді.
Өкінішке орай, кейде «сенімді» жеткіліксіз. Осының бәрін іздеуден кейін мен үшінші тарапқа қызмет көрсетуді қарастырдым.