Справочник шаблонов Cotonti: имена, назначение и примеры вызова пользовательской функции

Справочник шаблонов Cotonti: имена, назначение и примеры вызова пользовательской функции

Введение

В Cotonti каждый файл шаблона имеет уникальное имя, которое используется для его идентификации и загрузки движком. Знание правильных имён шаблонов критически важно для разработчиков и верстальщиков, поскольку позволяет:

• Быстро находить нужный файл для редактирования;
• Правильно использовать функцию cot_tpl_url() для получения пути к шаблону;
• Создавать новые шаблоны, следуя стандартам именования Cotonti;
• Эффективно отлаживать вёрстку, понимая, какой шаблон отвечает за конкретную страницу или блок.

В этом справочнике собраны все основные имена шаблонов, их назначение и примеры вызова функции cot_tpl_url() для различных типов расширений. Материал разделён по категориям для удобства поиска:

• Модули (module) — основные разделы сайта (страницы, форум, пользователи и т.д.);
• Плагины (plug) — дополнительные функциональные блоки;
• Ядро (core) — системные шаблоны, используемые на всех страницах;
• Админ-панель — шаблоны для управления сайтом.

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

Оглавление

• Общий синтаксис
• Шаблоны модулей
  • Page (страницы)
  • Forums (форум)
  • Users (пользователи)
  • PM (личные сообщения)
  • PFS (файловый менеджер)
  • Polls (опросы)
  • RSS
  • Index
• Шаблоны плагинов
  • Recent Items
  • Comments
  • Tags
  • Sitemap
  • Ratings
  • Contact
  • Hits
  • Banlist
• Системные шаблоны (ядро)
• Шаблоны админ-панели
  • Ядро админки
  • Админ-шаблоны модулей
  • Админ-шаблоны плагинов
• Сводная таблица шаблонов
• Примечания
• Заключение

Общий синтаксис

{PHP|cot_tpl_url('имя_шаблона', 'тип', admin)}

• 'имя_шаблона' — строковое имя файла без расширения .tpl (части разделяются точкой). Например, 'page.list'.
• 'тип' — тип расширения: 'module' (по умолчанию), 'plug', 'core'.
• admin — логический флаг: true для админ-шаблонов (ищет в папке админ-темы), иначе можно не указывать или передать false/null.

Важно: в шаблонах Cotonti нельзя передавать массивы – только строки. Если имя формируется динамически, передавайте его через переменную шаблона из PHP-кода:

$tpl_url = cot_tpl_url($dynamic_name, 'module');
$t->assign('DYNAMIC_TPL_URL', $tpl_url);

В шаблоне:

{DYNAMIC_TPL_URL}

Шаблоны модулей

Page (страницы)

• page.tpl — отображает одну страницу сайта: заголовок, текст, автора, дату и комментарии.
  {PHP|cot_tpl_url('page')}
• page.list.tpl — выводит список страниц внутри выбранной категории с пагинацией.
  {PHP|cot_tpl_url('page.list')}
• page.add.tpl — показывает форму добавления новой страницы пользователем.
  {PHP|cot_tpl_url('page.add')}
• page.edit.tpl — показывает форму редактирования существующей страницы.
  {PHP|cot_tpl_url('page.edit')}

Forums (форум)

• forums.sections.tpl — выводит список всех разделов форума с количеством тем и сообщений.
  {PHP|cot_tpl_url('forums.sections')}
• forums.topics.tpl — отображает список тем в выбранном разделе форума.
  {PHP|cot_tpl_url('forums.topics')}
• forums.posts.tpl — показывает сообщения внутри конкретной темы форума.
  {PHP|cot_tpl_url('forums.posts')}
• forums.newtopic.tpl — отображает форму создания новой темы в разделе форума.
  {PHP|cot_tpl_url('forums.newtopic')}
• forums.editpost.tpl — показывает форму редактирования отдельного сообщения форума.
  {PHP|cot_tpl_url('forums.editpost')}

Users (пользователи)

• users.details.tpl — выводит подробную информацию о пользователе: профиль, статистику, контакты.
  {PHP|cot_tpl_url('users.details')}
• users.edit.tpl — отображает форму редактирования данных профиля пользователя.
  {PHP|cot_tpl_url('users.edit')}
• users.register.tpl — показывает форму регистрации нового аккаунта.
  {PHP|cot_tpl_url('users.register')}
• users.profile.tpl — отображает публичный профиль пользователя для просмотра другими.
  {PHP|cot_tpl_url('users.profile')}
• users.passrecover.tpl — выводит форму восстановления забытого пароля.
  {PHP|cot_tpl_url('users.passrecover')}

PM (личные сообщения)

• pm.list.tpl — показывает список входящих и исходящих личных сообщений пользователя.
  {PHP|cot_tpl_url('pm.list')}
• pm.message.tpl — отображает содержимое одного личного сообщения.
  {PHP|cot_tpl_url('pm.message')}
• pm.send.tpl — выводит форму отправки нового личного сообщения.
  {PHP|cot_tpl_url('pm.send')}

PFS (файловый менеджер)

• pfs.tpl — основной интерфейс файлового менеджера: список файлов и папок, загрузка.
  {PHP|cot_tpl_url('pfs')}
• pfs.view.tpl — отображает содержимое конкретного файла или папки в файловом менеджере.
  {PHP|cot_tpl_url('pfs.view')}

Polls (опросы)

• polls.tpl — выводит опрос с вариантами ответов и результатами голосования.
  {PHP|cot_tpl_url('polls')}

RSS

• rss.tpl — формирует RSS-ленту последних материалов сайта.
  {PHP|cot_tpl_url('rss')}

Index

• index.tpl — главная страница сайта, обычно выводит последние материалы и виджеты.
  {PHP|cot_tpl_url('index')}

Шаблоны плагинов

Для плагинов обязательно указывайте тип 'plug'.

Recent Items

• recentitems.tpl — выводит список недавно добавленных или обновлённых материалов сайта.
  {PHP|cot_tpl_url('recentitems', 'plug')}

Comments

• comments.tpl — отображает все комментарии к конкретному материалу с формой добавления.
  {PHP|cot_tpl_url('comments', 'plug')}
• comments.edit.tpl — показывает форму редактирования отдельного комментария.
  {PHP|cot_tpl_url('comments.edit', 'plug')}

Tags

• tags.tpl — выводит облако тегов или список материалов, связанных с выбранным тегом.
  {PHP|cot_tpl_url('tags', 'plug')}

Sitemap

• sitemap.tpl — отображает карту сайта со ссылками на все разделы и материалы.
  {PHP|cot_tpl_url('sitemap', 'plug')}
• sitemap.index.tpl — показывает индекс карты сайта для разбивки на несколько страниц.
  {PHP|cot_tpl_url('sitemap.index', 'plug')}

Ratings

• ratings.tpl — выводит рейтинг материалов и элементы управления для голосования.
  {PHP|cot_tpl_url('ratings', 'plug')}

Contact

• contact.tpl — отображает контактную форму для отправки сообщений администрации.
  {PHP|cot_tpl_url('contact', 'plug')}

Hits

• hits.admin.tpl — админ-панель статистики посещений: графики, счётчики, отчёты.
  {PHP|cot_tpl_url('hits.admin', 'plug', true)}

Banlist

• banlist.admin.tpl — админ-панель управления заблокированными пользователями и IP-адресами.
  {PHP|cot_tpl_url('banlist.admin', 'plug', true)}

Системные шаблоны (ядро core)

• header.tpl — общая шапка сайта: логотип, меню, мета-теги, подключается на всех страницах.
  {PHP|cot_tpl_url('header', 'core')}
• footer.tpl — общий подвал сайта: копирайт, дополнительные ссылки, скрипты, подключается на всех страницах.
  {PHP|cot_tpl_url('footer', 'core')}
• message.tpl — выводит системные сообщения, ошибки и уведомления пользователю.
  {PHP|cot_tpl_url('message', 'core')}

Шаблоны админ-панели

Ядро админки

• admin.home.tpl — главная страница административной панели с обзором системы.
  {PHP|cot_tpl_url('admin.home', 'core', true)}
• admin.main.tpl — основной каркас админ-панели: общая разметка, меню, сайдбар.
  {PHP|cot_tpl_url('admin.main', 'core', true)}
• admin.config.tpl — страница настройки основных параметров сайта.
  {PHP|cot_tpl_url('admin.config', 'core', true)}
• admin.extensions.tpl — управление установленными модулями и плагинами: включение, отключение, настройка.
  {PHP|cot_tpl_url('admin.extensions', 'core', true)}
• admin.users.tpl — управление пользователями: редактирование, блокировка, удаление аккаунтов.
  {PHP|cot_tpl_url('admin.users', 'core', true)}
• admin.structure.tpl — управление структурой сайта: категории, разделы, их порядок и параметры.
  {PHP|cot_tpl_url('admin.structure', 'core', true)}
• admin.extrafields.tpl — настройка дополнительных полей для различных сущностей.
  {PHP|cot_tpl_url('admin.extrafields', 'core', true)}
• admin.cache.tpl — управление кэшем сайта: очистка, настройка времени хранения.
  {PHP|cot_tpl_url('admin.cache', 'core', true)}
• admin.cache.disk.tpl — подробности о кэше на диске: просмотр и очистка отдельных файлов кэша.
  {PHP|cot_tpl_url('admin.cache.disk', 'core', true)}
• admin.log.tpl — просмотр журнала событий системы: действия пользователей, ошибки.
  {PHP|cot_tpl_url('admin.log', 'core', true)}
• admin.rights.tpl — настройка прав доступа для групп пользователей.
  {PHP|cot_tpl_url('admin.rights', 'core', true)}
• admin.rightsbyitem.tpl — детальная настройка прав доступа для конкретного элемента сайта.
  {PHP|cot_tpl_url('admin.rightsbyitem', 'core', true)}
• admin.other.tpl — прочие административные настройки, не вошедшие в другие разделы.
  {PHP|cot_tpl_url('admin.other', 'core', true)}
• admin.phpinfo.tpl — вывод информации о PHP-конфигурации сервера.
  {PHP|cot_tpl_url('admin.phpinfo', 'core', true)}
• admin.infos.tpl — отображение сводной информации о системе и окружении Cotonti.
  {PHP|cot_tpl_url('admin.infos', 'core', true)}

Админ-шаблоны модулей

• page.admin.tpl — админ-панель управления страницами: массовые операции, категории.
  {PHP|cot_tpl_url('page.admin', 'module', true)}
• forums.admin.tpl — админ-панель управления форумом: разделы, темы, модерация.
  {PHP|cot_tpl_url('forums.admin', 'module', true)}
• polls.admin.tpl — админ-панель управления опросами: создание и редактирование.
  {PHP|cot_tpl_url('polls.admin', 'module', true)}
• pfs.admin.tpl — админ-панель файлового менеджера: настройки, ограничения.
  {PHP|cot_tpl_url('pfs.admin', 'module', true)}

Админ-шаблоны плагинов

• recentitems.admin.tpl — админ-панель плагина Recent Items: настройка вывода последних материалов.
  {PHP|cot_tpl_url('recentitems.admin', 'plug', true)}
• comments.admin.tpl — админ-панель плагина Comments: модерация комментариев.
  {PHP|cot_tpl_url('comments.admin', 'plug', true)}
• tags.tools.tpl — инструменты плагина Tags: массовое управление тегами.
  {PHP|cot_tpl_url('tags.tools', 'plug', true)}

Сводная таблица шаблонов

Примечания

1. Если тип не указан, подразумевается 'module'.
2. Для плагинов всегда указывайте 'plug'.
3. Для админ-шаблонов добавляйте третий параметр true.

4. Третий параметр функции cot_tpl_url($base, $type, $admin) — это $admin.

   • true — искать в админ-теме (папка themes/admin/... или указанная в $cfg['admintheme']).
   • false или null (по умолчанию) — поиск в обычной теме пользователя, а если имя содержит admin, Cotonti может автоматически выбрать админ-тему.

   Пример: {PHP|cot_tpl_url('page.admin', 'module', true)} — найди шаблон page.admin.tpl в админской части темы. Без true Cotonti может искать его в обычной теме, что может дать неверный путь.

5. В шаблоне нельзя передавать массив – используйте точечную нотацию.

6. Если имя шаблона формируется динамически, передавайте его в шаблон через $t->assign() из PHP-кода:

   $tpl_url = cot_tpl_url($dynamic_name, 'module');
   $t->assign('DYNAMIC_TPL_URL', $tpl_url);

   В шаблоне: {DYNAMIC_TPL_URL}

Это далеко не полный набор примеров для всех категорий и типов шаблонов, но этого достаточно, чтобы разобраться.

Заключение

Данный справочник охватывает основные имена шаблонов Cotonti, сгруппированные по категориям. Используйте его для:

• Быстрого поиска нужного шаблона при редактировании внешнего вида сайта;
• Правильного вызова функции cot_tpl_url() в коде;
• Понимания структуры шаблонов системы и их назначения.

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

Помните, что имена шаблонов могут отличаться в зависимости от версии Cotonti и используемой темы оформления. В случае сомнений проверяйте фактические имена файлов в папке /themes/ваша_тема/.