Articles
Հիմունքներ
Drupal 8-ում մաքուր URL-ները ակտիվացված են լռելյայն և չեն կարող անջատվել։ Սակայն mod_rewrite մոդուլը պետք է ակտիվացված լինի ձեր վեբ սերվերի վրա։
Ստուգեք ձեր դիտարկչի հասցեի գիծը։ Ձեր կայքի URL-ները չպետք է պարունակեն ?q= հատվածը։
Օրինակ՝ ճիշտ «մաքուր URL»՝
http://www.example.com/node/83
Օրինակ՝ «մաքուր URL», որը չի աշխատում
http://www.example.com/?q=node/83
Կան լրացուցիչ հրահանգներ մաքուր URL-ների կարգավորման համար տարբեր համակարգերի, ինչպիսիք են Apache, Wamp, XAMPP և IIS։
Այս ձեռնարկը պարունակում է դասընթացներ և այլ անհրաժեշտ տեղեկատվություն Drupal 8-ի համար մոդուլներ ստեղծելու համար։
Այլ աղբյուրներ՝
Drupal 8-ը օգտագործում է PHP-ի մի շարք առաջադեմ ֆունկցիաներ և բարդ երրորդ կողմի գրադարաններ՝ երրորդ կողմի մշակողներին տրամադրելու ամենասահուն API-ն բոլոր հասանելի CMS-երից։ Թեև փորձառու Drupal 7 մշակողները կարող են նկատել որոշ նշանակալի փոփոխություններ, հիմնական կառուցվածքի մեծ մասը կմնա ծանոթ։
Եթե որևէ նյութ, որը ներկայացվում է D8 մոդուլի մշակողի քայլ առ քայլ ուղեցույցում, ձեզ նոր է, ապա ստորև ներկայացված նյութը կարող է օգնել։ Այնուամենայնիվ, D8 մոդուլի նկարագրության հասնելու համար ամենապարզ գիտելիքները բավարար են։
Հաջորդ ենթաբաժիններում մենք կստեղծենք Drupal կայքի տարբեր մասերի օրինակներ, ինչպիսիք են օգտատերերի էջը, բլոկը, էնտիթին, դաշտը և այլն։ Բոլոր օրինակները սկսվում են մոդուլի թղթապանակից և .info.yml ֆայլից։ Միայն այս երկու բաղադրիչներով մոդուլը կցուցադրվի Drupal 8-ի ընդարձակումների ադմինիստրացիոն էջում կամ կարող է անմիջապես ակտիվացվել Drush-ի միջոցով։
Այս ենթաբաժինը կուղեկցի ձեզ ընթացքի միջոցով՝ ստեղծելու, անվանելու և ճիշտ տեղադրելու .info.yml ֆայլը, որը կլինի յուրաքանչյուր նոր ստեղծվող մոդուլի ելակետային կետը։
Նախքան սկսելը
Եթե ցանկանում եք, որ PHP-ն օգնի հայտնաբերել ձեր սխալները փորձարկման կայքում, փորձեք այստեղ նկարագրված կարգավորումները՝ Բոլոր սխալների ցուցադրումը զարգացումում.
Դարձրեք ձեր մոդուլի անունը
Մոդուլի ստեղծման առաջին քայլը ընտրել նրա «կարճ անունը» կամ մեքենայական անունը է։ Այս մեքենայական անունը կօգտագործվի ձեր մոդուլի մի շարք ֆայլերում և ֆունկցիաներում, և Drupal-ի միջուկը ծրագրային կերպով օգտագործում է այն՝ ձեր մոդուլը նշելու համար։
Հիմնական թեմա․ նախագծի մեթատվյալներ
.info.yml ֆայլը (հայտնի նաև որպես «info yaml ֆայլ») Drupal 8 մոդուլի, թեմայի կամ տեղադրման պրոֆիլի կարևոր բաղադրիչ է՝ նախագծի մասին մեթատվյալները պահպանելու համար։
Այս .info.yml ֆայլերը անհրաժեշտ են՝
Օգտագործողական մոդուլներ մշակելիս կան մի քանի դեպքեր, երբ ծրագրավորողը պետք է ավելացնի composer.json ֆայլ իր մոդուլի մեջ։ Դրանցից որոշ դեպքեր կախված են նրանից, արդյոք կաստոմ մոդուլը նախատեսված է drupal.org համայնքին որպես նախագիծ փոխանցելու համար։
Եթե մոդուլի մշակողը ցանկանում է օգտագործել packagist.org-ում տեղադրված PHP գրադարան, ապա նա պետք է ավելացնի composer.json ֆայլ իր նախագծում։
Հաջորդ բաժնում մենք կքննարկենք պարզ մոդուլի ստեղծումը։ Կա հին ավանդույթ, երբ առաջին ծրագիրը, որը գրում եք ցանկացած նոր համակարգում, ցուցադրում է«Hello World!» էկրանին։
Չնայած Drupal-ը մեկն է ամենահամարձակ և առաջադեմ բաց կոդով նախագծերից, այն նաև խորը արմատավորված է գիտության և տեխնիկայի հին ավանդույթներում։
HelloController դասի content() ֆունկցիան կվերադարձնի մակերեսային տեքստ, երբ երթուղավորման համակարգը կանչի այդ էջը։
Ձեր մոդուլի թղթապանակում պետք է լինի ստանդարտ PSR-4 թղթապանակների կառուցվածքը՝ /src/Controller, և այդ թղթապանակի ներսում պետք է ունենաք կոնտրոլերի ֆայլ՝ HelloController.php։
Այդպիսով, ձեր կոնտրոլերի ֆայլը պետք է այս տեսքը ունենա՝ /src/Controller/HelloController.php
Դուք ունեք հետևյալ կոդը HelloController.php ֆայլում.