PocketTOC

Назначение

Длинные гайды и wiki-страницы без оглавления теряют читателя: человек не видит структуру и не прыгает к нужному разделу. Сторонние TOC-плагины тянут лишний вес и чужой стиль.

Состав

PocketTOC 1.0.0 вешается на the_content, собирает h2–h4, проставляет якоря и вставляет навигацию «Содержание» перед первым заголовком. В настройках: включение, посты или страницы, минимум заголовков, стартовый уровень, отступ прокрутки, цвет акцента, свёрнутое состояние по умолчанию. Скрипт следит за активным пунктом при скролле.

Эксплуатация

Плагин остаётся отдельным продуктом для площадок на WordPress. На pocketmine.ru логика перенесена в тему PocketMine (pm-toc.js и разметка в карточке записи): блок «Содержание» с нумерацией и кнопкой «Свернуть». Отдельный плагин с этой площадки снят, поведение сохранено.

PocketTOC строит оглавление записи WordPress: разбирает заголовки h2–h4, проставляет якоря и вставляет блок «Содержание» перед первым заголовком. При прокрутке текущий раздел подсвечивается, блок можно свернуть.

Зачем это нужно

Длинный гайд или wiki-страница без оглавления теряет читателя: человек не видит структуру материала и не понимает, есть ли в нём нужный раздел. Он уходит, не дочитав, — а для страницы это означает и низкое время на сайте, и потерянный шанс на целевое действие. Сторонние TOC-плагины решают задачу, но тянут лишний вес и приносят чужой стиль, который приходится перебивать своими правилами.

Как работает

Плагин вешается на фильтр the_content, собирает заголовки h2–h4 и вставляет навигацию перед первым из них. Идентификаторы секций стабильны: ссылка из содержания всегда совпадает с якорем в тексте, поэтому оглавление не ломается при повторном сохранении записи.

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

Настройки

Страница «Параметры → PocketTOC»: включение блока, вывод в записях или на страницах, минимальное число заголовков. Отдельный плагин остаётся продуктом для площадок студии на WordPress.

Где применён

На PocketMine.ru та же логика перенесена в тему: разметка в карточке записи и скрипт pm-toc.js. Блок выглядит так же — подпись «Навигация», заголовок «Содержание», нумерованный список и кнопка свернуть, — но не требует отдельного плагина и работает быстрее.

Результат

Версия 1.0.0. Оглавление уровней h2–h4, подсветка текущего раздела при прокрутке, сворачивание. Стек: WordPress, PHP 8+, JavaScript.

Другие продукты студии — PocketAdmin и PocketDonate.