Buga

tpl Функции

функции для шаблонов

 tpl Функции - семейство функций предназначенных для использование в шаблонах. Внутри каждой функции вызывается хук соответствующий названию, в функции tplHeader - хук tplHeader. Каждая функция имеет необязательный аргумент - исходный текст. Вы должны использовать эти функции в своих дизайн темах в шаблонах, для того, чтобы обеспечить подключение других модулей. кодФайл : /core/gateway.php

Рассмотрим более подробно исходный код tplTitle():

// заголовок
function tplTitle( $text = '' )
{
    doHook('tplTitle', $text);
    return $text;
}

Очень короткий текст, то есть фактически, функция нужна нам только для того, чтобы вызвать хук tplTitle. В шаблоне функция используется для создания заголовка html страницы теg title:

<head>
<meta name="viewport" content="width=device-width,initial-scale=1" />
<title>Buga <?=tplTitle()?></title> 
<?=tplHeader()?> 
</head>

Более правильный вариант все таки будет с передачей основного заголовка в саму функции:

<head>
    <meta name="viewport" content="width=device-width,initial-scale=1" />
     <title><?=tplTitle('Buga ')?></title>
    <?=tplHeader()?>
</head>

Пример использования в сторонних модулях - подключаем jQuery модуль и мне нужно добавить в заголовок header сайта подключение скрипта:

addHook('tplHeader', function( &$header ){ 
     $path = BU_MODULES_URL.'myPath/jquery.js'; 
     $header .= "\n<script src='$path'></script>\n";
} );

Пример с использование анонимной функции.

Список функций/хуков:

  • tplHeader - текст в заголовке страницы header, это для подключения стилей, шрифтов , скриптов
  • tplTitle - текст в заголовке страницы header, это для подключения стилей, шрифтов , скриптов.
  • tplSiteTitle - заголовок сайта то, что будет отображается в шапке html документа
  • tplSiteDescription - короткое описание под заголовком что будет отображается в шапке html документа
  • tplContentTitle - текст заголовка содержимого, контента , заголовок статью, поста
  • tplContent - основной текст поста, страницы, контента ...
  • tplUnderFooter - после footer, место для подключения скриптов в конце страницы ...

Обязательно для использования в вашем шаблоне только tplHeader, иначе ни один модуль не сможет подключить скрипты или css стили. Остальные использовать желательно но не обязательно. Этот список не окончательный, я думаю скоро он будет еще сильно расширен, но позже. Возможно вынесу эти функции в отдельный файл.