Template path hints в Magento 2 - це підказки, які допоможуть вам визначити клас .php блоку або .phtml шаблон, який відповідає певній області сторінки у вашому магазині Magento 2. Іншими словами, template path hints додають позначення шляху до кожного шаблону, щоб допомогти вам легше знаходити .phtml-файли та ,відповідно, швидше їх редагувати. Ви можете знайти код у структурі файлів Magento як на вітрині, так і адмін панелі.

Отже, давайте з’ясуємо методи, за допомогою яких можна ввімкнути template path hints в Magento 2.

Magento 2 Template Path Hilts

Увімкніть template path hints з адмін панелі 

Для того, щоб увімкнути template path hints в Magento 2, виконайте такі дії:

1. Переконайтеся, що ваша Magento 2 перебуває у режимі за замовчуванням або в режимі розробника.

2. Підіть в Admin Panel > Stores > Settings > Configuration > Advanced > Developer > Debug.

Magento 2 Template Path Hints

3. Перевірте та налаштуйте Developer Client Restrictions.

Magento 2 Template Path Hints Client Restrictions

У цьому розділі задайте одну або декілька IP-адрес, для яких ви хочете, щоб були доступні Template Path Hints. Ви можете ввімкнути template path hints (наступний крок), але все одно ви не побачите їх, якщо в полі Allowed IPs введено якийсь інший IP.

Це робиться на випадок, якщо ви хочете щось пошукати, не заважаючи іншим розробникам чи користувачам. Оскільки якщо ви залишите цей розділ порожнім template path hints будуть видимі для всіх, хто зараз перебуває на веб-сайті.

4. Увімкніть Template Path Hints.

Виберіть чи хочете ви, щоб вони були ввімкнені для вітрини магазину або ж в адмін панелі. Виберіть Так у полі Add Block Names to Hints, якщо ви хочете, щоб template path hints відображали ім'я класу PHP блоку разом з шляхом до файлу PHTML шаблону.

Magento 2 Template Path Hints Debug

5. Після того як закінчите не забудьте натиснути кнопку Зберегти Налаштування.

Magento 2 Template Path Hints Save Config

6. Перш ніж використовувати Template Path Hints, ми рекомендуємо переконатися, що Magento block cache, page cache відключені.

Тепер ви готові перезавантажити сторінку, щоб побачити, які блоки на сторінці посилаються на які  PHP/PHTML файли.

Існує ще один спосіб, яким ви можете ввімкнути template path hints для вашого магазину Magento 2.

Увімкніть template path hints використовуючи Command Line Interface

Примітка: на відміну від попереднього методу, використовуючи CLI ви можете вмикати або вимикати template path hints лише для вітрини магазину Magento 2.

Щоб увімкнути template path hints в Magento 2, виконайте таку команду:

php bin/magento dev:template-hints:enable

Щоб вимкнути template path hints в Magento 2, використайте наступну команду:

php bin/magento dev:template-hints:disable