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

Путь в админке: Airygen SEO -> Настройки -> Оглавление.

Модуль поддерживает автоматическую вставку, ручное размещение, управление на уровне отдельной записи, стильные пресеты и область предпросмотра для проверки результата до публикации.

Настройки

Страница разделена на Настройки, Макет и Предпросмотр.

Вкладка Настройки

Используйте эту вкладку, чтобы управлять способами вывода, охватом, структурой, поведением и правилами якорей.

Ручной вывод

Включить ручной вывод TOC позволяет размещать TOC через функцию шаблона, шорткод или блок.
Функция шаблона полезна, когда TOC должен выводиться внутри шаблона темы.
Шорткод полезен, когда TOC должен быть внутри контента или блока шорткода.
Блок полезен, когда нужен визуальный вывод в блочном редакторе.

Функция шаблона:

<?php if ( function_exists( 'airygen_the_toc' ) ) { airygen_the_toc(); } ?>

Шорткод:

[airygen_toc]

Блок:

<!-- wp:airygen/toc /-->

Автоматическая вставка

Включить автоматическое встраивание TOC автоматически вставляет TOC в подходящие записи.
Позиция вставки поддерживает Перед контентом и После первого абзаца.

Заголовок секции

Заголовок управляет тем, будет ли у TOC видимый заголовок.
Поле текста заголовка меняет формулировку над списком.
Поле уровня заголовка меняет HTML-уровень заголовка для этого текста.

Область

Типы записей для включения определяет, какие типы контента могут показывать TOC.

Структура

Минимум заголовков скрывает TOC, пока в записи недостаточно заголовков.
Уровни заголовков позволяет включать в список TOC заголовки H2, H3 и H4.

Поведение

Плавная прокрутка анимирует переход, когда читатель нажимает ссылку в TOC.
Добавить нумерацию превращает список в нумерованный план.
Свернуть при загрузке открывает TOC в свернутом состоянии.

Якоря

Префикс якоря добавляет префикс к сгенерированным ID заголовков, чтобы избегать конфликтов.
Исключить заголовки пропускает заголовки, совпадающие с указанными через запятую фразами.

Вкладка Макет

Используйте эту вкладку, чтобы менять визуальный стиль TOC.

Темы

Снежный сланец дает нейтральный бело-серый стиль.
Медовая бумага дает теплый стиль в духе бумаги или пергамента.
Небесный бриз дает светло-голубой внешний вид.
Спокойная мята дает мягкий зеленый внешний вид.
Румяная роза дает более мягкий розовый внешний вид.
Лавандовый туман дает светло-фиолетовый внешний вид.

Стиль

Управление шапкой позволяет менять толщину границ контейнера заголовка, стиль границы, радиус, цвет, отступы, внешние отступы, фон, цвет заголовка, размер шрифта и стиль шрифта заголовка.
Управление основной частью позволяет менять толщину границ контейнера TOC, стиль границы, радиус, цвет границы, отступы, внешние отступы и фон.
Управление ссылками позволяет менять цвет ссылок TOC, размер шрифта и оформление в виде жирного, курсива или подчеркивания.
Управление списком позволяет менять внутренний отступ списка TOC.

Вкладка Предпросмотр

Используйте эту вкладку, чтобы проверять TOC в режимах Ноутбук, Планшет и Мобильный телефон.

Предпросмотр намеренно сделан простым.
Ваша тема все равно может влиять на итоговый вывод на фронтенде.
Экран также показывает примеры HTML и CSS.

Панель редактора

В блочном редакторе панель TOC позволяет управлять функцией для одной записи, не меняя глобальные значения по умолчанию.

Режим отображения оглавления поддерживает Авто, Вручную и Отключено.
Когда выбран режим Вручную, панель показывает кнопки Вставить оглавление для Блок и Шорткод.

Как использовать

Откройте Airygen SEO -> Настройки -> Оглавление.
На вкладке Настройки решите, хотите ли вы использовать Включить ручной вывод TOC, Включить автоматическое встраивание TOC или только один способ.
Если нужен ручной вывод, включите ручной режим и скопируйте Функция шаблона, Шорткод или Блок, который подходит вашему сценарию.
Если нужна автоматическая вставка, включите ее и выберите Позиция вставки — Перед контентом или После первого абзаца.
Включите заголовок TOC, если нужен видимый заголовок, затем задайте текст заголовка и его уровень.
В Область выберите типы записей, которые могут показывать TOC.
В Структура задайте Минимум заголовков и выберите уровни заголовков, которые нужно включать.
В Поведение решите, должны ли быть включены плавная прокрутка, нумерация и свернутый режим.
В Якоря задайте Префикс якоря и перечислите заголовки, которые нужно исключить.
Откройте Макет, выберите пресет темы и донастройте область заголовка, контейнер, ссылки и отступы списка.
При необходимости откройте конкретную запись в редакторе и используйте Режим отображения оглавления, чтобы переключить ее в Авто, Вручную или Отключено.
Сохраните настройки, просмотрите вкладку Предпросмотр, а затем откройте живую статью с достаточным количеством заголовков, чтобы подтвердить итоговый результат.

Проверьте эти пункты после сохранения:

TOC появляется только на тех записях, которые соответствуют требованию Минимум заголовков.
Нажатие на ссылку TOC переносит читателя в правильный раздел.
Значение Режим отображения оглавления на уровне записи соответствует выбранному вами способу для этой статьи.
Живая страница по-прежнему выглядит правильно после применения CSS темы.

Преимущества SEO

Хорошее оглавление делает длинный контент проще для просмотра и навигации. Это помогает читателям быстрее находить нужный раздел и придает длинным страницам более ясную структуру.

Сценарии использования

Длинные инструкции и tutorial-статьи

До: Руководство по настройке содержит много разделов, но читателям приходится прокручивать весь материал, чтобы найти нужный шаг.

После: Оглавление превращает эти заголовки в кликабельный план, поэтому читатель может сразу перейти к установке, примерам или устранению неполадок.

Страницы документации и базы знаний

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

После: TOC сразу делает структуру видимой и помогает читателю понять форму страницы до того, как он начнет читать ее подробно.

Часто задаваемые вопросы

Почему TOC не появляется на некоторых записях?

Проверьте значение Минимум заголовков, выбранные Уровни заголовков, разрешенные Типы записей и Режим отображения оглавления для конкретной записи.

Что лучше использовать: автоматическую вставку или ручное размещение?

Используйте автоматическую вставку, когда хотите добавить TOC на большое количество записей с минимальными усилиями. Используйте ручное размещение, когда нужен точный контроль над местом вывода.

Почему предпросмотр может отличаться от живой страницы?

Предпросмотр — это упрощенный ориентир. Ваша тема и реальный контент записи все равно влияют на итоговый результат на фронтенде, поэтому всегда проверяйте живую страницу.

Обзор