Список тегов и блоков в шаблонах Cotonti

Список доступных тегов и блоков в шаблоне на странице модуля или плагина. Документация, что происходит и как это применять:

Общая цель статьи:

Когда мы разрабатываем или настраиваем шаблоны (TPL-файлы) в Cotonti, в том числе в сборках типа «Фриланс-биржа», важно понимать:

• Какие теги и блоки доступны в шаблоне на той или иной странице.
• Какие значения они имеют, чтобы их корректно отобразить или использовать в логике верстки.

Эта статья показывает 2 способа, как «в реальном времени» получить информацию о тегах и блоках, не копаясь в коде модулей/плагинов.

 Способ №1: TPL debug mode

Что это:

Специальный отладочный режим шаблонизатора Cotonti (CoTemplate), который автоматически показывает, какие блоки и теги передаются в шаблон и какие у них значения.

Как включить:

1. Открыть файл конфигурации:

   /datas/config.php
   

2. Найти:

   $cfg['debug_mode'] = FALSE;
   

3. Заменить на:

   $cfg['debug_mode'] = TRUE;

Как использовать:

Теперь к URL страницы нужно добавить параметр:

tpl_debug=1

Примеры:

• http://example.com/page.php?al=test&tpl_debug=1
• http://example.com/projects/list/?tpl_debug=1

Что получим:

• Полный список всех TPL-блоков и тегов, используемых на странице.
• Для каждого тега — его значение.
• Для циклов (например, списков) — отображается только первый элемент.
• Для строк — выводятся первые 60 символов, чтобы не перегружать экран.

Дополнительная информация:

• Вложенные блоки визуально отделяются отступами.
• Это удобно для сложных шаблонов с глубокой вложенностью, например: блок в блоке, в цикле.

Способ №2: Функция dump() в TPL

Что это:

Позволяет в шаблоне прямо вывести значения переменной, блока, PHP-массива и т.д.

Как использовать:

Вставьте тег с пайпом |dump в нужный шаблон:

{MY_TAG|dump}
{PHP.usr.profile|dump}  // Дамп профиля пользователя
{PHP|dump}              // Дамп всех PHP переменных
{PHP.out|dump}          // Дамп переменных для вывода

После вставки просто обновите страницу — получитевизуальный дамп значений переменных на экране.

Преимущества:

• Работает без включения debug_mode.
• Можно использовать точечно — вывести только то, что нужно.
• Помогает при отладке собственных шаблонов, плагинов и логики вывода.

Заключение:

Совет:

Можно использовать оба метода вместе — debug_mode для общего обзора, а dump() для деталей.