Изучаем слои

Продолжаем осваивать SMF. И сегодня рассмотрим понятие слои.

Слои (layers) — функции, содержащие некоторую часть шаблона. Чтобы увидеть текущие слои, зайдите на форум и добавьте к адресу параметр debug. Например: http://mysite.local/index.php?debug (авторизуйтесь под администратором). Текущие слои выделятся рамочкой. Верхний слой (html_above) содержит шапку шаблона. Подвал содержится в слое html_below. В слоях body_above и body_below содержится тело страницы. Загляните в index.template.php и поищите функции с окончанием _above, _below — это и есть стандартные слои шаблона.

Рассмотрим, как добавить блок в верхнюю или нижнюю часть сайта. Файлы движка и база данных останутся без изменений.

Как это сделать?

Для начала создадим шаблон (Your.template.php) и поместим в папку /Themes/default. Содержание файла:

function template_layer_name_above()
{
    // тут ваш код
}

function template_layer_name_below()
{
    // и тут ваш код
}

layer_name в названиях функций можно заменить на что-то свое.

Теперь, если требуется разместить блок в верхней части шаблона, html-контент добавляется в функцию template_layer_name_above, а для добавления в нижнюю часть — в функцию template_layer_name_below. Никто не запрещает использовать обе функции даже с одинаковым содержимым.

Внимание: в файле обязательны обе функции template_layer_name_above и template_layer_name__below, даже если они пустые! Иначе получим ошибку.

Затем, чтобы подключить наш шаблон к общему выводу, добавим в нужный файл соответствующий вызов:

loadTemplate('Your'); // подключение файла Your.template.php

$context['template_layers'][] = 'layer_name'; // вызов функций template_layer_name_above и template_layer_name_below из подключенного шаблона

После этого созданные слои отобразятся вместе со встроенными слоями текущего шаблона SMF.

Слои это не сетка, вы не можете разместить два слоя в ряд, они всегда идут друг за другом.

Результат

Взаимодействие с другими слоями

Если мы хотим вставить наш слой после какого-то другого, можно воспользоваться этим кодом:


$search = 'имя другого слоя';
$replace = 'имя нашего слоя';

if (empty($key = array_search($search, $context['template_layers']))) {
    $context['template_layers'][] = $replace;
    return;
}

$context['template_layers'] = array_merge(
    array_slice($context['template_layers'], 0, $key, true),
    [$replace],
    array_slice($context['template_layers'], $key, null, true)
);