Mare, milă! Astăzi voi împărtăși informații despre cum dezvoltatorii conectă chiar și bibliotecile terțelor părți la Drupal 7. Faptul este că comunitatea Drupal nu salută includerea bibliotecilor și claselor terților într-un modul separat. Vom rezolva această problemă prin API-ul bibliotecilor.
Pentru a începe, trebuie să instalați modulul API pentru Biblioteci. care este un ambalaj flexibil pentru lucrul cu biblioteci externe și oferă un set de cârlige și funcții de ajutor. Beneficiile utilizării API-urilor pentru biblioteci:
- O bibliotecă separată poate fi utilizată de mai multe module;
- controlul versiunilor bibliotecilor conectate;
- interacțiunea cu CSS. Fișiere JS și PHP;
- Sistem unificat de interacțiune cu bibliotecile, ușor de înțeles de toți dezvoltatorii.
API-urile pentru biblioteci necesită includerea și crearea obișnuită a dosarului bibliotecilor în site-uri. Acum, folosind biblioteca jScrollPane ca exemplu, voi încerca să arăt cum să utilizeze caracteristicile modulului. API-ul Libraries oferă un nou hook_libraries_info cârlig. care este obligatorie atunci când descrie o nouă bibliotecă:
De fapt, am dat un exemplu de descriere minimă necesară a bibliotecilor $ array ['jscrollpane'] pentru conexiune. Hook hook_libraries_info are setări mai flexibile, care, dacă doriți, puteți citi în documentația oficială. Acum, conform descrierii bibliotecii jScrollPane. trebuie să puneți fișierele jquery.jscrollpane.min.js și jquery.jscrollpane.css la rădăcina directorului sites / library / jscrollpane.
Conectarea și utilizarea bibliotecilor
Acum că fișierele de bibliotecă sunt în locul potrivit și cârligul este implementat, puteți utiliza în siguranță biblioteca:
Pentru o interacțiune mai flexibilă, puteți face acest lucru:
Dacă trebuie doar să vă asigurați că biblioteca este disponibilă:
Monitorizarea statutului și a versiunii bibliotecilor
Ca bonus la această postare, vă voi spune cum să afișați informații despre bibliotecă pe pagina Drupal admin / reports / status status. Pentru a face acest lucru, trebuie să adăugați hook_requirements la fișierul .install.
Fiind un bun exemplu de integrare cu API-ul pentru Biblioteci, vă recomand să examinați modulul Colorbox - de fapt, el a servit și ca sursă de cunoaștere pentru mine.
În general, acum știi cum să se ocupe de bibliotecile terțelor părți din Drupal - cum să le conectezi și unde să le stochezi. Sper că, datorită acestui post, codul dvs. va deveni chiar mai curat!