Individuazione dei file di template con il debug
Per scoprire quale template genera il markup per un determinato elemento, puoi utilizzare l’opzione integrata di debug di Twig. Questo parametro mostrerà i commenti HTML insieme all’output renderizzato, includendo gli hook di tema utilizzati, i nomi di file di template suggeriti e il file Twig esatto che viene usato per visualizzare una specifica sezione del tuo markup.
Abilita il debug di Twig in sites/default/services.yml, impostando debug: true nella sezione twig.config (ricorda di disabilitarlo in ambiente di produzione). Se utilizzi Drupal 8 in modalità multisito, devi modificare il file services.yml nella cartella sites/[current_site] per il sito specifico che stai sviluppando. Se services.yml non esiste ancora, copia il file default.services.yml dalla cartella sites/default e rinominalo in services.yml. Per istruzioni dettagliate sul debug Twig, consulta «Debug dei template Twig compilati».
Dopo aver svuotato la cache, controlla il sorgente della pagina; vedrai un codice simile al seguente:
<!-- THEME DEBUG --> <!-- THEME HOOK: 'node' --> <!-- FILE NAME SUGGESTIONS: * node--view--frontpage--page-1.html.twig * node--view--frontpage.html.twig * node--1--teaser.html.twig * node--1.html.twig * node--article--teaser.html.twig * node--article.html.twig * node--teaser.html.twig x node.html.twig --> <!-- BEGIN OUTPUT from 'core/themes/classy/templates/content/node.html.twig' --> <article data-history-node-id="1" data-quickedit-entity-id="node/1" role="article" class="contextual-region node node--type-article node--promoted node--view-mode-teaser" about="/node/1" typeof="schema:Article" data-quickedit-entity-instance-id="0"> .... </article> <!-- END OUTPUT from 'core/themes/classy/templates/content/node.html.twig' -->
Alcuni aspetti da notare in questo output di debug:
- I suggerimenti di nomi di file sono elencati dall’opzione più specifica a quella meno specifica.
- Il file attualmente utilizzato è contrassegnato con una «x» accanto al nome.
- Accanto a BEGIN OUTPUT ed END OUTPUT troverai il percorso completo del template renderizzato.