Шаблоны Cotonti и фриланс-биржи. Список доступных тегов и блоков в шаблоне на странице модуля или плагина. Документация.
При разработке шаблонов и скинов для Cotonti или сборки сайта «Фриланс-биржа» часто возникает необходимость получить список доступных тэгов и блоков в tpl-файлах на той или иной странице, которую разрабатываем или верстаем.
Для получения списка тегов можно использовать «дэбагерский» (отладочный) режим шаблонизатора CoTemplate для просмотра какие теги и блоки используются на конкретной странице или для вывода содержимого переменной.
И так, получить список тегов в TPL шаблонах Cotonti и сборки сайта «Фриланс-биржа» можно двумя способами:
Способ №1.
«TPL debug mode» — это режим позволяет получить и вывести список блоков и тегов нужного шаблона.
Используя «TPL debug mode» для текущей страницы, мы получим в текстовом виде список блоков шаблона.tpl и определенные для него теги, а также их значения.
1. Включаем режим отладки (debug_mode). Для этого откройте файл конфигурации системы в папке сайта по адресу:
папкасайта/datas/config.php
ищем строку
$cfg['debug_mode'] = FALSE;
переводим ключ в состояние включенного (активного) — debug_mode должен быть установлен в TRUE, а именно вот так:
$cfg['debug_mode'] = TRUE;
Сохраняем изменения в файле конфигурации сайта config.php и теперь можно увидеть дамп шаблона нужной страницы, в конце адреса добавив параметр tpl_debug=1
Вот например:
http://example.com/page.php?al=test&tpl_debug=1
http://example.com/path/to/page/?tpl_debug=1
Обратите внимание на несколько ньюансов по режиму отладки TPL-шаблонах:
Вложенные блоки отображаются с отступом, пропорционально глубине уровня вложенности;
Для блоков внутри цикла (обычно они имеют окончание _ROW в своем имени) отображается только первый;
Для строк значений тегов выводятся только первые 60 знаков.
Способ №2.
«TPL dump function»
Для просмотра значений нужно вызвать специальную функцию dump() для обработки тегаca, через знак вертикальной черты «|», называемой «pipe» (или как его еще называют символ конвейера):
{MY_TAG|dump}
или
{PHP.usr.profile|dump}
или
{PHP|dump}
Для этого в адресной строке страницы ничего не добавляем.
В нужный шаблон, например header.tpl или любой, который нам нужен добавляем код {PHP.out|dump}
Сохраняемся и обновляем страницу.