Нахождение файлов шаблона с отладкой
Чтобы узнать, какой шаблон генерирует разметку для определенного элемента, вы можете использовать встроенную опцию debug Twig. Этот параметр будет отображать HTML-комментарии вместе с отображаемым выводом, который включает используемые крючки темы, предлагаемые имена файлов шаблонов, а также обозначает точный файл Twig, используемый для визуализации определенного раздела вашей разметки.
Включите отладку Twig в sites/default/services.yml, установив debug:true в разделе twig.config (отключите его в производственной среде). Если вы используете Drupal 8 для мультисайтов, вам следует отредактировать файл services.yml в каталоге sites/currenttsite для конкретного сайта, который вы создаете. Если services.yml еще не существует; скопируйте файл default.services.yml из каталога sites/default и переименуйте его в services.yml. Подробные инструкции по отладке Twig см. в разделе «Отладка скомпилированных шаблонов Twig».
После очистки кеш, проверьте источник страницы; Вы увидите код, подобный приведенному ниже:
<!-- 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' -->
Несколько вещей, на которые следует обратить внимание в этом отладочном выводе:
- Предложения с именами файлов приведены в порядке от наиболее конкретного к наименее конкретному.
- Текущее использование имени файла имеет символ «х» рядом с ним.
- Наряду с BEGIN OUTPUT и END OUTPUT вы найдете полный путь к отображаемому шаблону.
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.