| Предыдущая версия справа и слеваПредыдущая версияСледующая версия | Предыдущая версия |
| wiki:devel:templates [2025/02/09 16:14] – [Структура каталогов] vladpolskiy | wiki:devel:templates [2025/02/10 18:50] (текущий) – vladpolskiy |
|---|
| * ''<код языка>/settings.php'' --- локализованные строки, используемые на странице настроек «Докувики» | * ''<код языка>/settings.php'' --- локализованные строки, используемые на странице настроек «Докувики» |
| * ''style.ini'' --- см. [[wiki:devel:style.ini]] | * ''style.ini'' --- см. [[wiki:devel:style.ini]] |
| | * ''favicon.ico'' -- (можно перезаписать, загрузив другой в корневое или вики-пространство имен при использовании [[xref>tpl_favicon()|tpl_favicon()]] is used) |
| | * ''template.info.txt'' **-- Требуется** текстовый файл с [[wiki:devel:template info|информацией о шаблоне]]. |
| |
| | Обработка параметров конфигурации аналогична [[wiki:devel:common_plugin_functions|плагинам ]]. Используйте ''%%tpl_getConf(<setting>)%%'' для получения пользовательских настроек шаблона. Сохраненные локальные настройки хранятся в глобальном ''conf/local.php''. |
| |
| ===== Функции ===== | =====Объяснение внутренних механизмов===== |
| | ==== Функции ==== |
| |
| Список доступных функций вы можете найти здесь: [[xref>inc/template.php|API documentation]]. Самые важные приведены ниже. | Список доступных функций вы можете найти здесь: [[xref>inc/template.php|API documentation]]. Самые важные приведены ниже. |
| |
| |
| ==== tpl_content() ==== | * **''[[xref>tpl_content()]]''** |
| Эта функция выводит тело страницы, другими словами, всё содержимое страницы, включая [[..:toc|содержание]] (TOC). Вы можете отключить вывод содержания вызовом функции с параметром ''false'': | Эта функция выводит тело страницы, другими словами, всё содержимое страницы, включая [[..:toc|содержание]] (TOC). Вы можете отключить вывод содержания вызовом функции с параметром ''false'': |
| |
| |
| |
| ==== tpl_toc() ==== | * **''[[xref>tpl_toc()]]''** |
| По умолчанию, функция ''[[#tpl_content()]]'' сама позаботится о выводе [[..:TOC|содержания]], приводя его в актуальное состояние. Если ваш шаблон использует боковую колонку или более сложную компоновку, у вас может появится желание разместить содержание независимо от содержимого страницы. Это можно сделать функцией ''tpl_toc()''. При её использовании важно запретить автоматическое размещение содержания вызовом функции ''tpl_content()'' с аргументом ''false''. | По умолчанию, функция ''[[#tpl_content()]]'' сама позаботится о выводе [[..:TOC|содержания]], приводя его в актуальное состояние. Если ваш шаблон использует боковую колонку или более сложную компоновку, у вас может появится желание разместить содержание независимо от содержимого страницы. Это можно сделать функцией ''tpl_toc()''. При её использовании важно запретить автоматическое размещение содержания вызовом функции ''tpl_content()'' с аргументом ''false''. |
| |
| |
| |
| ==== tpl_getConf() ==== | * **''[[xref>tpl_getConf()|tpl_getConf('key')]]''** \\ Функция используется для доступа к [[..:devel:configuration|конфигурационным параметрам]] из шаблона. |
| |
| Функция используется для доступа к [[..:devel:configuration|конфигурационным параметрам]] из шаблона. | * **''[[xref>tpl_getLang()|tpl_getLang('key')]]''** \\ Эта функция используется для доступа к локализованным строкам шаблона. Подробности см. в документации по разработке [[wiki:devel:localization]] development documentation. |
| |
| | * Кроме того, доступно множество других полезных функций шаблона. Пожалуйста, посмотрите в [[xref>inc/template.php|документации API]]. |
| |
| ===== Глобальные переменные и константы ===== | ===== Глобальные переменные и константы ===== |
