Основные теги в шаблоне forums.sections.tpl - Справочник

основные теги с префиксом FORUMS_SECTIONS_ROW_, их источники и практическое применение.

Основные теги от функции cot_generate_sectiontags()

Эта функция вызывается для каждой категории/раздела и возвращает ассоциированный массив данных о разделе. Ключи массива объединяются с переданным префиксом (в нашем случае 'FORUMS_SECTIONS_ROW_'). Полный список формируемых переменных:

Дополнительные теги, назначаемые вручную

Эти переменные добавляются отдельно в циклах PHP и не входят в результат cot_generate_sectiontags():

• {FORUMS_SECTIONS_ROW_FOLD}
0 или 1. Определяет, свёрнут ли блок подфорумов по умолчанию. Зависит от настройки defstate категории и параметра c в URL. Используется в условии <!-- IF {FORUMS_SECTIONS_ROW_FOLD} --> style="display:none;"<!-- ENDIF -->.
• {FORUMS_SECTIONS_ROW_SUBITEMS}
0 или 1. Показывает, есть ли у текущей категории подфорумы (вложенные разделы). Именно этот тег мы использовали для решения проблемы с пустыми разделами.
• {FORUMS_SECTIONS_ROW_ODDEVEN}
  Строка 'odd' или 'even'. Используется для стилизации чётных/нечётных строк.
• {FORUMS_SECTIONS_ROW_NUM}
  Порядковый номер раздела внутри родительской категории (начинается с 1).
• {FORUMS_SECTIONS_ROW_ACTIVITY} и {FORUMS_SECTIONS_ROW_ACTIVITYVALUE} (уже упомянуты выше) фактически перезаписываются в цикле, чтобы учесть агрегированную активность родительской категории.

Примеры практического использования

1. Условное отображение кнопки «Свернуть/развернуть»

<!-- IF {FORUMS_SECTIONS_ROW_SUBITEMS} -->
 <button onclick="return toggleblock('blk_{FORUMS_SECTIONS_ROW_CAT}')">
 <i class="fa-solid fa-chevron-down"></i>
 </button>
<!-- ENDIF -->

2. Вывод индикатора активности без встроенного HTML

Вместо готового {FORUMS_SECTIONS_ROW_ACTIVITY} можно построить свой индикатор, используя числовое значение:

<div class="activity-bar">
 <!-- FOR {I} IN {FORUMS_SECTIONS_ROW_ACTIVITYVALUE} -->
 <span class="active-dot"></span>
 <!-- ENDFOR -->
</div>

3. Стилизация чётных/нечётных строк

<div class="forum-row {FORUMS_SECTIONS_ROW_ODDEVEN}">
 ...
</div>

4. Проверка наличия иконки

<!-- IF {FORUMS_SECTIONS_ROW_ICON} -->
 <img src="{FORUMS_SECTIONS_ROW_ICON}" alt="{FORUMS_SECTIONS_ROW_TITLE}">
<!-- ELSE -->
 <img src="{PHP.R.app-logo}" alt="{FORUMS_SECTIONS_ROW_TITLE}">
<!-- ENDIF -->

Связь с решённой проблемой

В изначальном шаблоне ссылка на раздел всегда содержала onclick="return toggleblock(...)", что блокировало переход для пустых категорий. Добавив условие <!-- IF {FORUMS_SECTIONS_ROW_SUBITEMS} -->, мы смогли отображать простую ссылку для разделов без подфорумов и интерактивную — для категорий с вложенными форумами.

Эти теги дают полный контроль над отображением списка разделов и позволяют гибко настраивать внешний вид форумов в теме Index36.

Общая структура циклов

В PHP-файле три уровня вложенности:

1. $fstlvl – категории верхнего уровня (родительские разделы). Обрабатываются в цикле foreach ($fstlvl as $x) → блок CAT.
2. $nxtlvl[$x] – подразделы (секции) внутри категории $x. Обрабатываются в цикле foreach ($nxtlvl[$x] as $y) → блок SECTION.
3. $nxtlvl[$y] – подподразделы (подсекции) внутри секции $y (если включено отображение). Обрабатываются в цикле foreach ($nxtlvl[$y] as $z) → блок SUBSECTION.

На каждом уровне шаблон получает набор переменных с префиксом FORUMS_SECTIONS_ROW_.

1. Переменные, формируемые функцией cot_generate_sectiontags($code, $prefix, $stat)

Эта функция возвращает массив, ключи которого объединяются с переданным префиксом. В нашем случае префикс – 'FORUMS_SECTIONS_ROW_'. Функция берёт данные из структуры разделов Cotonti и из таблицы cot_forum_stats (переменная $stat).

2. Переменные, назначаемые вручную в PHP-циклах

Эти переменные не берутся из cot_generate_sectiontags(), а добавляются отдельными $t->assign().

3. Подробно о FORUMS_SECTIONS_ROW_NUM и FORUMS_SECTIONS_ROW_ODDEVEN

Как формируется NUM

В коде три счётчика:

• $xx – для категорий верхнего уровня (CAT).
• $yy – для секций (SECTION) внутри каждой категории.
• $zz – для подсекций (SUBSECTION) внутри каждой секции.

Пример:

$xx = 0;
foreach ($fstlvl as $x) {
    $xx++;
    // ...
    if (isset($nxtlvl[$x]) && is_array($nxtlvl[$x])) {
        $yy = 0;
        foreach ($nxtlvl[$x] as $y) {
            $yy++;
            // ...
            $t->assign('FORUMS_SECTIONS_ROW_NUM', $yy);
        }
    }
    $t->assign('FORUMS_SECTIONS_ROW_NUM', $xx);
}

Таким образом, {FORUMS_SECTIONS_ROW_NUM}:

• В блоке CAT – это номер категории среди всех категорий верхнего уровня.
• В блоке SECTION – номер секции внутри её родительской категории.
• В блоке SUBSECTION – номер подсекции внутри её родительской секции.

Примеры использования NUM

1. Создание якоря с уникальным идентификатором

<div id="cat-{FORUMS_SECTIONS_ROW_NUM}" class="forum-category">
 ...
</div>

2. Вывод порядкового номера для нумерованного списка

<span class="forum-index">{FORUMS_SECTIONS_ROW_NUM}.</span> {FORUMS_SECTIONS_ROW_TITLE}

3. Условная стилизация первого элемента

<!-- IF {FORUMS_SECTIONS_ROW_NUM} == 1 -->
 <div class="first-item">Первый раздел</div>
<!-- ELSE -->
 <div class="other-item">Остальные</div>
<!-- ENDIF -->

4. Группировка элементов по три в ряд (с использованием математики в Cotonti невозможно, но можно через CSS-классы)
Можно назначить класс в зависимости от номера:

<!-- IF {FORUMS_SECTIONS_ROW_NUM} % 3 == 0 --> class="last-in-row"<!-- ENDIF -->

(В Cotonti нет оператора %, поэтому для сложной логики лучше использовать ODDEVEN или внешний JavaScript.)

ODDEVEN и его связь с NUM

Функция cot_build_oddeven($num) возвращает 'odd', если число нечётное, и 'even', если чётное. Это удобно для зебры:

<div class="forum-section {FORUMS_SECTIONS_ROW_ODDEVEN}">
 ...
</div>

В CSS можно задать:

css

.forum-section.odd { background-color: #f9f9f9; }
.forum-section.even { background-color: #ffffff; }

4. Особенности переменных активности

Как считается ACTIVITYVALUE

В PHP-коде для каждого раздела (секции) вычисляется $secact_num:

• Берётся количество постов за последние 7 дней ($cot_sections_act[$y]).
• Нормируется относительно максимального значения ($secact_max) и масштабируется в диапазон 0–5.
• Если постов мало, но они есть, $secact_num может быть 1.

Затем в шаблон передаются:

• {FORUMS_SECTIONS_ROW_ACTIVITY} – готовая HTML‑строка (например, <span class="activity activity-3"></span>), сгенерированная функцией cot_rc('forums_icon_section_activity', ...).
• {FORUMS_SECTIONS_ROW_ACTIVITYVALUE} – число от 0 до 5.

Применение ACTIVITYVALUE:
Можно создать свой индикатор, не полагаясь на стандартный HTML:

<div class="custom-activity">
 <!-- FOR {I} IN {FORUMS_SECTIONS_ROW_ACTIVITYVALUE} -->
 <i class="fa-solid fa-fire"></i>
 <!-- ENDFOR -->
</div>

(В Cotonti цикл FOR работает с числовым значением.)

5. Резюме по всем доступным тегам

пример готового шаблона