Pravila imenovanja i smeštaja vašeg Drupal 8 modula

Pre nego što počnete

Ako želite da PHP pomogne u otkrivanju grešaka na test sajtu, isprobajte podešavanja opisana ovde: Prikaz svih grešaka tokom razvoja.

Imenujte svoj modul

Prvi korak u pravljenju modula je da izaberete „kratko ime“ ili mašinsko ime. Ovo mašinsko ime će se koristiti u više fajlova i funkcija vašeg modula, a Drupal jezgro ga koristi programski da označi vaš modul.

Postoji nekoliko važnih pravila kojih treba da se pridržavate prilikom izbora mašinskog imena:

• Mora početi slovom.
• Mora sadržati samo mala slova i donje crte.
• Nikako ne sme sadržati razmake.
• Mora biti jedinstveno. Vaš modul ne sme imati isto kratko ime kao bilo koji drugi modul, tema ili instalacioni profil koji koristite na sajtu.
• Ne sme sadržati rezervisane termine: src, lib, vendor, assets, css, files, images, js, misc, templates, includes, fixtures, Drupal

Za ovaj primer izabraćemo „hello_world“ kao mašinsko ime.

Važna napomena: nemojte koristiti velika slova u mašinskom imenu vašeg modula, jer Drupal neće prepoznati vaše implementacije hook-ova. Pogledajte Razumevanje hook sistema za Drupal module.

Napravite folder za vaš modul

S obzirom da smo izabrali mašinsko ime „hello_world“, pokrenite modul tako što ćete kreirati folder u vašoj Drupal instalaciji na putanji: /modules/custom/hello_world ili /sites/all/modules/hello_world. Možete izostaviti /custom/podfolder i staviti modul u /modules/hello_world folder, ali često je dobro imati posebno mesto za vaše sopstvene module, kako ih ne biste tražili među ostalima koje ste preuzeli sa Drupal.org.

Napomena da nije neophodno da ime foldera vašeg modula bude isto kao mašinsko ime. Možete, na primer, koristiti ime foldera HelloWorld. Ali morate se uvek pridržavati mašinskog imena kada ga koristite u kodu i imenima fajlova modula.

Prethodne verzije Drupala zahtevale su da se korisnički moduli nalaze u /sites/all/modules, dok su osnovni moduli bili u /modules. Međutim, u Drupalu 8 /modules je sada slobodan za vaše korisničke i dodatne module. Svi osnovni moduli i biblioteke su sada u /core direktorijumu. U Drupalu 8 i dalje možete koristiti najbolje prakse iz Drupal 7/6 i smestiti svoje korisničke i Drupal.org dodatne (preuzete) module u /sites/all/modules, ali isto tako možete ih staviti i direktno u /modules, što ima isti efekat.

Naš primer modula još ne radi, prvo ćemo mu trebati .info.yml fajl. Saznajte više o tome kako obavestiti Drupal 8 o vašem modulu pomoću .info.yml fajla. Kasnije ćemo aktivirati modul u ovom vodiču.

Standardi kodiranja

Preporučujemo vam da se pridržavate Drupal standarda kodiranja prilikom pisanja sopstvenih korisničkih modula. Ovo je obavezno za sve predloge za izmene Drupal jezgra, a takođe preporuka za kod koji se postavlja na drupal.org.

Pogledajte i

• Prikaz svih grešaka tokom razvoja
• Standardi kodiranja