Drupal 8 մոդուլի անունների և տեղադրման կանոններ
Նախքան սկսելը
Եթե ցանկանում եք, որ PHP-ն օգնի հայտնաբերել ձեր սխալները փորձարկման կայքում, փորձեք այստեղ նկարագրված կարգավորումները՝ Բոլոր սխալների ցուցադրումը զարգացումում.
Դարձրեք ձեր մոդուլի անունը
Մոդուլի ստեղծման առաջին քայլը ընտրել նրա «կարճ անունը» կամ մեքենայական անունը է։ Այս մեքենայական անունը կօգտագործվի ձեր մոդուլի մի շարք ֆայլերում և ֆունկցիաներում, և Drupal-ի միջուկը ծրագրային կերպով օգտագործում է այն՝ ձեր մոդուլը նշելու համար։
Կան մի քանի կարևոր կանոններ, որոնք պետք է պահել մեքենայական անուն ընտրելիս՝
- Անունը պետք է սկսվի տառով։
- Պետք է պարունակի միայն փոքրատառեր և ստորակետեր (underscore):
- Անունը չպետք է պարունակի բացատներ։
- Անունը պետք է լինի եզակի։ Ձեր մոդուլի կարճ անունը չպետք է կրկնվի որևէ այլ մոդուլի, թեմայի կամ տեղադրման պրոֆիլի անունների հետ, որոնք դուք օգտագործում եք կայքում։
- Անունը չպետք է լինի որևէ արգելված տերմին՝
src,lib,vendor,assets,css,files,images,js,misc,templates,includes,fixtures,Drupal
Այս դեպքում մենք ընտրում ենք «hello_world» որպես մեքենայական անուն։
Важно. Մի օգտագործեք մեծատառեր ձեր մոդուլի մեքենայական անվան մեջ, քանի որ Drupal-ը չի ճանաչի ձեր հուքների իրականացումները։ Տեսեք Drupal մոդուլների հուքերի համակարգի ըմբռնումը։
Ստեղծեք թղթապանակ ձեր մոդուլի համար
Քանի որ մենք ընտրեցինք մեքենայական անուն «hello_world», մոդուլը գործարկելու համար ստեղծեք թղթապանակ ձեր Drupal-ի տեղադրման մեջ՝ հետևյալ ուղիներով՝ /modules/custom/hello_world կամ /sites/all/modules/hello_world: Դուք կարող եք բաց թողնել /custom/ ենթաթղթապանակը և ձեր մոդուլը տեղադրել ուղղակի /modules/hello_world թղթապանակում, բայց սովորաբար լավ է ունենալ առանձնացված տեղ ձեր սեփական մոդուլների համար, որպեսզի հեշտությամբ չխառնվեք Drupal.org-ից ներբեռնված մյուսների հետ։
Կատեգորիայի անունը պարտադիր չէ, որ լինի նույնը, ինչ ձեր մոդուլի մեքենայական անունը։ Կարող եք օգտագործել, օրինակ, HelloWorld թղթապանակի անուն։ Բայց պետք է հիշեք, որ ծրագրային կոդում և ֆայլերի անուններում օգտագործեք մեքենայական անունը։
Նախկին Drupal տարբերակներում պահանջվում էր, որ սեփական մոդուլները տեղադրվեն /sites/all/modules, քանի որ հիմնական մոդուլները գտնվում էին /modules: Սակայն Drupal 8-ում /modules-ն այժմ ազատ է ձեր սեփական և լրացուցիչ մոդուլների համար։ Բոլոր հիմնական մոդուլներն ու գրադարանների ֆայլերը տեղադրված են /core թղթապանակում։ Drupal 8-ում դուք դեռ կարող եք հետևել Drupal 7/6 լավագույն պրակտիկներին՝ ձեր սեփական և Drupal.org-ից ներբեռնված մոդուլները տեղադրելով /sites/all/modules, բայց կարող եք նաև ուղղակի տեղադրել դրանք /modules թղթապանակում՝ նույն արդյունքով։
Մեր օրինակը դեռ չի աշխատում, քանի որ մեզ պետք է .info.yml ֆայլ։ Սովորեք ավելին՝ Ինչպես տեղեկացնել Drupal 8-ին ձեր մոդուլի մասին .info.yml ֆայլով։ Մենք կակտիվացնենք մոդուլը ավելի ուշ ձեռնարկում։
Կոդավորման ստանդարտներ
Մենք խստորեն խորհուրդ ենք տալիս պահել Drupal-ի կոդավորման ստանդարտները, երբ գրում եք սեփական մոդուլներ։ Դա պահանջ է Drupal միջուկի կոդի փոփոխությունների առաջարկների համար, ինչպես նաև խորհուրդ է տրվում drupal.org-ում տեղադրված կոդի համար։
Տե՛ս նաև
Drupal’s online documentation is © 2000-2020 by the individual contributors and can be used in accordance with the Creative Commons License, Attribution-ShareAlike 2.0. PHP code is distributed under the GNU General Public License.