logo

Dodatni tipovi blokova (EBT) - Novo iskustvo rada sa Layout Builder-om❗

Dodatni tipovi blokova (EBT) – stilizovani, prilagodljivi tipovi blokova: slajdšouvi, kartice sa tabovima, kartice, akordeoni i mnogi drugi. Ugrađena podešavanja za pozadinu, DOM Box, javascript dodatke. Iskusite budućnost kreiranja rasporeda već danas.

Demo EBT moduli Preuzmite EBT module

❗Dodatni tipovi pasusa (EPT) – Novo iskustvo rada sa pasusima

Dodatni tipovi pasusa (EPT) – analogni skup modula zasnovan na pasusima.

Demo EPT moduli Preuzmite EPT module

Scroll
  1. Почетна
  2. Drupal Dokumentacija
  3. Tematizacija Drupal 8
  4. Twig u Drupalu 8

Konvencije imenovanja Twig šablona

19/06/2025, by Ivan

Menu

Drupal učitava šablone na osnovu određenih konvencija imenovanja. To vam omogućava da prepišete šablone dodavanjem istih u vašu temu i dodeljivanjem određenih imena.

Nakon dodavanja šablona, morate osvežiti keš da bi Drupal otkrio vaš novi šablon.

Možete debugovati Twig šablone da biste saznali koji se šabloni koriste za generisanje markupa za bilo koji element. Više o Twig debugu ovde.

Na ovoj stranici su navedene konvencije koje se koriste za osnovnu HTML strukturu, stranicu, regione, blokove, nodove, polja i druge osnovne komponente. (Dobro je znati da možete praviti sopstvene predloge imena šablona korišćenjem hook_theme_suggestions_HOOK_alter funkcije.)

HTML (<head> šablon)

HTML šablon daje markup za osnovnu strukturu HTML stranice, uključujući <head>, <title> i <body> tagove.

Osnovni šablon: html.html.twig (osnovna lokacija: core/modules/system/templates/html.html.twig)

Primeri kako možete prepisati osnovni šablon:

  1. html--[internalviewpath].html.twig
  2. html--node--[nodeid].html.twig
  3. html.html.twig

Vidi API dokumentaciju html.html.twig.

Page šablon

Šablon: page--[front|internal/path].html.twig
Osnovni šablon: page.html.twig (osnovna lokacija: core/modules/system/templates/page.html.twig)

Predlozi su brojni. Početna stranica ima prioritet. Ostalo zavisi od internog puta trenutne stranice. Početna stranica se može podesiti u Administration > Configuration > System > Site information (http://example.com/admin/config/system/site-information). Šablon za početnu stranicu je page--front.html.twig.
Nemojte mešati interni put sa aliasima koji se ne uzimaju u obzir.

Lista predloženih šablonskih fajlova je poređana po specifičnosti na osnovu internog puta. Za svaki element trenutnog puta se pravi jedan predlog, mada numerički elementi se ne prenose u sledeće predloge. Na primer, "http://www.example.com/node/1/edit" daje sledeće predloge:

  1. page--node--edit.html.twig
  2. page--node--1.html.twig
  3. page--node.html.twig
  4. page.html.twig

Vidi API dokumentaciju page.html.twig. Takođe vidi šablon stranice održavanja.

Regioni

Šablon: region--[region].html.twig
Osnovni šablon: region.html.twig (osnovna lokacija: core/modules/system/templates/region.html.twig)

Šablon regiona se koristi kada region stranice ima sadržaj iz sistema blokova ili funkcija kao što su hook_page_top() ili hook_page_bottom(). Moguća imena regiona se definišu u temi u fajlu .info.yml.

Vidi API dokumentaciju region.html.twig.

Blokovi

Šablon: block--[module]--[delta].html.twig
Osnovni šablon: block.html.twig (osnovna lokacija: core/modules/block/templates/block.html.twig)

  1. block--[module]--[delta].html.twig
  2. block--[module].html.twig
  3. block.html.twig

"module" je ime modula, a "delta" je interni identifikator dodeljen bloku od strane modula.

Na primer, "block--block--1.html.twig" će biti korišćen za prvi korisnički blok dodat preko administratorskog interfejsa, jer ga je kreirao blok modul sa identifikatorom 1. Blok specifični regioni nisu dostupni u Drupal 8.

Ako imate blok kreiran korisničkim modulom nazvanim "custom" sa deltom "my-block", predlog za temu će biti "block--custom--my-block.html.twig".

Primer sa Views blokom: ako imate blok kreiran u View-u sa imenom "front_news" i prikazom "block_1", predlog teme biće: block--views-block--front-news-block-1.html.twig (napomena: donje crte u identifikatorima i imenima treba zameniti crtama).

Zapamtite da su imena modula osetljiva na velika i mala slova. Na primer, ako vam je modul "MyModule", najčešći predlog teme biće "block--MyModule.html.twig".

Vidi API dokumentaciju block.html.twig.

Čvorovi (Nodes)

Šablon: node--[content-type|nodeid]--[viewmode].html.twig
Osnovni šablon: node.html.twig (osnovna lokacija: core/modules/node/templates/node.html.twig)

Predlozi za hook teme su na osnovu sledećih faktora, poređani od najkonkretnijeg ka najmanje konkretnom. Drupal koristi najkonkretniji šablon koji pronađe:

  1. node--[nodeid]--[viewmode].html.twig
  2. node--[nodeid].html.twig
  3. node--[content-type]--[viewmode].html.twig
  4. node--[content-type].html.twig
  5. node--[viewmode].html.twig
  6. node.html.twig

Napomena: donje crte (_) u imenu tipa sadržaja se zamenjuju crtama (-).

Vidi API dokumentaciju node.html.twig.

Taxonomy termini

Šablon: taxonomy-term--[vocabulary-machine-name|tid].html.twig
Osnovni šablon: taxonomy-term.html.twig (osnovna lokacija: core/modules/taxonomy/templates/taxonomy-term.html.twig)

Predlozi su bazirani na sledećim faktorima, poređani od najkonkretnijeg ka najmanje konkretnom. Drupal koristi najkonkretniji šablon koji pronađe:

  1. taxonomy-term--[tid].html.twig
  2. taxonomy-term--[vocabulary-machine-name].html.twig
  3. taxonomy-term.html.twig

Napomena: donje crte u imenu mašine vokabulara se zamenjuju crtama.

Vidi API dokumentaciju taxonomy-term.html.twig.

Polja (Fields)

Šablon: field--[[type|name]|[entity-type]--[field-name|content-type]].html.twig
Osnovni šablon: field.html.twig (osnovna lokacija: core/modules/system/templates/field.html.twig)

Predlozi su bazirani na sledećim faktorima, poređani od najkonkretnijeg ka najmanje konkretnom. Drupal koristi najkonkretniji šablon koji pronađe:

  1. field--node--[field-name]--[content-type].html.twig
  2. field--node--[field-name].html.twig
  3. field--node--[content-type].html.twig
  4. field--[field-name].html.twig
  5. field--[field-type].html.twig
  6. field.html.twig

Napomena: donje crte (_) u imenu mašine polja zamenjuju se crtama (-). Takođe, ne zaboravite da uključite „field-“ u imena korisničkih polja, npr. field--field-phone.html.twig.

Vidi API dokumentaciju field.html.twig.

Komentari

Šablon: comment--[comment-field-name]--[node-type].html.twig
Osnovni šablon: comment.html.twig (osnovna lokacija: core/modules/comment/templates/comment.html.twig)

Dodata je podrška za kreiranje fajlova comment--[comment-field-name]--[node-type].html.twig da bi se komentari određenog tipa nodova prikazivali drugačije od ostalih komentara na sajtu. Na primer, komentar na nod tipa članka biće comment--field-comments--article.html.twig.

Vidi API dokumentaciju comment.html.twig.

Omot za komentare

Šablon: field--node--[comment-field-name]--[content-type].html.twig
Osnovni šablon: field--comment.html.twig

Forumi

Šablon: forums--[[container|topic]--forumID].html.twig
Osnovni šablon: forums.html.twig (osnovna lokacija: core/modules/forum/templates/forums.html.twig)

Predlozi za hook teme su bazirani na sledećim faktorima, poređani od najkonkretnijeg ka najmanje konkretnom. Drupal koristi najkonkretniji šablon koji pronađe:

Za forum kontejnere:

  1. forums--containers--[forumid].html.twig
  2. forums--[forumid].html.twig
  3. forums--containers.html.twig
  4. forums.html.twig

Za forume tema:

  1. forums--topics--[forumid].html.twig
  2. forums--[forumid].html.twig
  3. forums--topics.html.twig
  4. forums.html.twig

Vidi API dokumentaciju forums.html.twig.

Stranica održavanja

Šablon: maintenance-page--[offline].html.twig
Osnovni šablon: maintenance-page.html.twig (osnovna lokacija: core/modules/system/templates/maintenance-page.html.twig)

Ovo se koristi kada baza podataka nije dostupna. Korisno je prikazati korisnički prijateljsku stranicu bez grešaka. Maintenance page tema mora biti pravilno konfigurisana.

Vidi API dokumentaciju maintenance-page.html.twig.

Napomena: fajl maintenance-page--offline.html.twig trenutno se ne prikazuje kada je baza podataka nedostupna. Praćeni problem: #2720109: maintenance-page--offline.html.twig se ne učitava kada je sistem u offline režimu.

Rezultat pretrage

Šablon: search-result--[search-type].html.twig
Osnovni šablon: search-result.html.twig (osnovna lokacija: core/modules/search/templates/search-result.html.twig)

search-result.html.twig je podrazumevani omotač za pojedinačne rezultate pretrage. Različiti predlozi se prave u zavisnosti od tipa pretrage. Na primer, "example.com/search/node/Search+Term" koristi "search-result--node.html.twig". Za "example.com/search/user/bob" koristi se "search-result--user.html.twig". Moduli mogu proširiti tipove pretrage dodavanjem dodatnih predloga.

Vidi API dokumentaciju search-result.html.twig.

Views

Svi Views šabloni mogu se prepisati sa različitim imenima na osnovu imena view-a, identifikatora prikaza view-a, tipa prikaza ili njihove kombinacije.

Za svaki View koristiće se najmanje dva šablona. Prvi se koristi za sve Views: views-view.html.twig.

Drugi šablon određuje stil izabran za View. Obratite pažnju da određeni aspekti View-a mogu promeniti stil; na primer, argumenti koji daju pregled mogu promeniti stil u jedan od posebnih stilova pregleda.

Podrazumevani stil za sve Views je views-view-unformatted.html.twig.

Mnogi stilovi zatim prikazuju svaki red u stilu reda; podrazumevani stil reda je views-view-fields.html.twig.

Šabloni:

  • views-view--[viewid]--[view-display-id].html.twig
  • views-view--[viewid]--[view-display-type].html.twig
  • views-view--[view-display-type].html.twig
  • views-view--[viewid].html.twig
  • views-view.html.twig

Osnovni šablon: views-view.html.twig (osnovna lokacija: core/themes/stable/templates/views/views-view.html.twig)

Na primer, ako želimo prepisati šablon "views-view.html.twig" za naš View, dozvoljena su sledeća imena:

  • views-view--[viewid]--[view-display-id].html.twig
  • views-view--[viewid]--page.html.twig
  • views-view--block.html.twig
  • views-view--[viewid].html.twig
  • views-view.html.twig

Šabloni bazirani na views-view-field.html.twig imaju sufiks sa ID polja View-a (kao u zamenskim šablonima) za prikaz pojedinačnog polja u View-u:

  • views-view-field--[viewid]--[view-display-id]--[fieldid].html.twig
  • views-view-field--[viewid]--page--[fieldid].html.twig
  • views-view-field--block--[fieldid].html.twig
  • views-view-field--[fieldid].html.twig
  • views-view-field.html.twig

Primer svih šablona koji će biti isprobani u sledećem slučaju:

View sa imenom foobar. Stil: neformatiran. Stil reda: polja. Prikaz: stranica.

  • views-view--foobar--page.html.twig
  • views-view--page.html.twig
  • views-view--foobar.html.twig
  • views-view.html.twig
  • views-view-unformatted--foobar--page.html.twig
  • views-view-unformatted--page.html.twig
  • views-view-unformatted--foobar.html.twig
  • views-view-unformatted.html.twig
  • views-view-fields--foobar--page.html.twig
  • views-view-fields--page.html.twig
  • views-view-fields--foobar.html.twig
  • views-view-fields.html.twig
Source URL:
Twig Template naming conventions
Source authors:
batigolix laughnan eojthebrave Cottser pachabhaiya kiwad NonProfit tebb rteijeiro matthias_bauw spuky akalata drupalove ashish_nirmohi thamas HongPong kiwimind tvn riddhi.addweb rahulkumar.it th_tushar rvanderh1 stanvoets leymannx ezoulou ñull hocu suman.abc arnoldbird dschoni jonnyeom

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.