Dodavanje regiona u temu

Dodavanje regiona u temu zahteva:

• Dodavanje metapodataka regiona u fajl THEMENAME.info.yml.
• Izmenu fajla page.html.twig i prikazivanje novih regiona.

Napomena. Ako definišete bilo koji region u svojoj temi, čak i samo jedan, svi podrazumevani regioni više neće važiti i vi preuzimate odgovornost da definišete sve oblasti koje želite da koristite.

Bilo koji blokovi koji su bili u regionima koji više ne postoje (jer ih niste definisali) sada će biti onemogućeni – posebno ako izmenite THEMENAME.info.yml i očistite keš pomoću drush cr, dobićete poruku poput ove za svaki:

Blok themename_breadcrumbs je dodeljen nevažećem regionu breadcrumb i onemogućen je.

Ako odete na /admin/structure/block, svi onemogućeni blokovi će biti navedeni u gornjoj oblasti sa indikatorom (onemogućeno). Možete ih ili prevući ili koristiti padajući meni "Region" da im dodelite novi region ili uklonite blokove koji vam više nisu potrebni.

Obavezno sačuvajte regione page_top i page_bottom. To su "skriveni" regioni koji se koriste za markup na samom vrhu i dnu stranice, poput analitike ili administratorske trake. Nije ih potrebno navoditi u THEMENAME.info.yml, samo ih ne uklanjajte iz šablona html.html.twig. Moduli mogu zavisiti od njihovog prisustva.

Dodavanje regiona u vaš info fajl

Počnite tako što ćete deklarisati bilo koje nove regione u fajlu THEMENAME.info.yml. Regioni se definišu kao deca ključa regions na sledeći način:

regions:
  header: 'Header'
  content: 'Content'
  footer: 'Footer'

Ključevi regiona moraju biti alfanumerički i mogu sadržavati donju crtu (_). Ključevi moraju počinjati slovom. Ključ je mašinsko ime (koje koristite u kodu), a vrednost je čitljiv naziv prikazan u administratorskom interfejsu.

Dodavanje regiona u vaše šablone

Da bi regioni prikazivali sadržaj koji im je dodeljen, morate se pobrinuti da vaši novi regioni budu dodati i u vaš fajl page.html.twig. Regioni se predstavljaju kao Twig promenljive, čije ime odgovara ključu definisanom u THEMENAME.info.yml uz prefiks page.

Primer:

header: 'Header' 

...će postati:

{{ page.header }} 

Oni se ponašaju kao i svaka druga Twig promenljiva i mogu biti obavijeni bilo kojom markup strukturom prikladnom za vaš slučaj upotrebe.

(Podrazumevani sintaksni prikaz skrivenih regiona je drugačiji, vidi dole.)

Podrazumevani regioni

Vidite dokumentaciju za page.html.twig za listu podrazumevanih regiona.

• page.header
• page.primary_menu
• page.secondary_menu
• page.highlighted
• page.help (dinamički pomoćni tekst, uglavnom za administratorske stranice)
• page.content (glavni sadržaj trenutne stranice)
• page.sidebar_first
• page.sidebar_second
• page.footer
• page.breadcrumb

Ako vaša tema ne definiše regione, Drupal će prihvatiti ovaj podrazumevani set vrednosti.

Ove oblasti odgovaraju onome što očekuje podrazumevani fajl core/modules/system/templates/page.html.twig, kao i dva skrivena regiona page_top i page_bottom – nije potrebno da ih navodite u THEMENAME.info.yml ako preklapate podrazumevane vrednosti, ali Twig promenljive {{ page_top }} i {{ page_bottom }} moraju biti sačuvane u šablonu html.html.twig.