AMP LuckyWP Table of Contents - Плагин WordPress

Руководство по настройке AMP LuckyWP Table of Contents для AMP-страниц WordPress

AMP LuckyWP Table of Contents нужен не для того, чтобы заново создавать оглавление в WordPress, а для более узкой задачи: перенести уже настроенную таблицу содержания LuckyWP Table of Contents в AMP-версию страницы, которую формирует AMP for WP. В этом руководстве разберём, как подготовить сайт, где настраивается основной плагин LuckyWP, что должен сделать AMP-аддон после активации и как проверить, что результат не ломает AMP-валидацию.

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

Главная идея проста: AMP-аддон наследует существующую настройку LuckyWP Table of Contents, поэтому качество AMP-результата зависит не только от самого аддона, но и от того, насколько аккуратно собрана обычная версия оглавления. Если на основной странице заголовки хаотичные, shortcode не выполняется или тема выводит контент нестандартно, AMP-страница тоже может показать проблему.

Какую задачу решает этот AMP-аддон

Обычный LuckyWP Table of Contents создаёт оглавление по заголовкам записи, страницы или произвольного типа записи. Его можно вставлять автоматически, через блок, shortcode или виджет. Но AMP-страница создаётся другим слоем: AMP for WP упрощает разметку, меняет часть HTML, контролирует стили, может отключать скрипты и собирает отдельный мобильный вариант материала. Из-за этого не каждый интерактивный или стилизованный блок из обычной страницы безопасно появляется в AMP.

AMP LuckyWP Table of Contents закрывает именно этот разрыв. По официальной странице AMP for WP, расширение автоматически добавляет функциональность LuckyWP Table of Contents в AMP и использует существующую настройку оглавления. На практике это значит, что редактор не должен вручную собирать вторую таблицу содержания для AMP, если базовая связка работает корректно.

Плагин полезен там, где AMP-версия остаётся важной частью сайта: новостные проекты, журналы, справочники, блоги с длинными инструкциями, медицинские или юридические материалы, учебные статьи, документация по продуктам. В таких материалах оглавление не является декоративным блоком. Оно помогает читателю быстро перейти к нужному разделу, а владельцу сайта - сохранить одинаковую навигацию в обычной и AMP-версии.

Есть и важное ограничение: аддон не заменяет настройку самого LuckyWP Table of Contents. Он не исправит плохую иерархию заголовков, не создаст смысловую структуру за автора и не гарантирует, что любые кастомные стили темы будут безопасны для AMP. Его стоит воспринимать как совместимый слой между уже работающим оглавлением и AMP-выводом.

Кому подходит связка LuckyWP, AMP for WP и AMP LuckyWP Table of Contents

Лучший сценарий для этого продукта - сайт, где уже есть длинные структурированные материалы и AMP for WP используется осознанно, а не просто установлен “на всякий случай”. Если читатели часто открывают статьи с мобильных устройств, а страницы состоят из 6-20 крупных разделов, оглавление в AMP помогает не терять навигацию после перехода в ускоренную версию.

Связка особенно удобна для нескольких ролей:

• Редактора, который хочет управлять оглавлением через знакомые настройки LuckyWP и не поддерживать отдельную AMP-разметку.
• Вебмастера, который уже настроил AMP for WP и хочет сохранить одинаковую структуру ссылок на обычной и AMP-странице.
• SEO-специалиста, которому важно, чтобы в длинных статьях были понятные якоря и читатель мог быстро перейти к нужному блоку.
• Владельца базы знаний, где статьи постоянно обновляются, а ручная поддержка оглавлений быстро становится ошибкоопасной.

Плагин может быть лишним, если сайт не использует AMP for WP, если AMP отключён для записей и страниц, если материалы короткие и не имеют нормальной структуры H2/H3, либо если оглавление уже создаёт другая система, встроенная в тему, конструктор или SEO-плагин. В таких случаях дополнительный слой совместимости только усложнит диагностику.

Отдельно стоит оценить проекты на конструкторах, учебных плагинах и сложных шаблонах. В поддержке WordPress.org встречаются ситуации, где оглавление корректно работает в обычном контенте, но не видит заголовки внутри нестандартной структуры уроков или шаблонов. Это не означает, что продукт “плохой”, но показывает границу: любой TOC-плагин зависит от того, где фактически находится контент и как тема выводит заголовки.

Что проверить до установки, чтобы не искать проблему вслепую

Перед установкой AMP LuckyWP Table of Contents нужно убедиться, что сайт готов к такой связке. Это экономит время: если базовая версия оглавления не работает, AMP-аддон почти наверняка не даст стабильного результата.

Три обязательных компонента

По странице совместимости AMP for WP для LuckyWP нужны три элемента: AMP for WP, LuckyWP Table of Contents и сам AMP-аддон. Проверка должна идти именно в таком порядке. Сначала убедитесь, что AMP for WP формирует AMP-страницы. Затем проверьте, что LuckyWP выводит оглавление на обычной версии материала. Только после этого добавляйте AMP LuckyWP Table of Contents.

Структура заголовков в статье

LuckyWP строит оглавление по HTML-заголовкам. Поэтому в материале должны быть настоящие H2, H3 и, при необходимости, более глубокие уровни. Нельзя имитировать заголовки жирным текстом, большим размером шрифта или блоками конструктора без корректной HTML-разметки. Если заголовок визуально выглядит как раздел, но в коде не является heading-тегом, оглавление его не увидит.

Для AMP это ещё важнее. Ускоренная версия часто убирает лишнюю оболочку, меняет вложенность блоков и строже относится к разметке. Чем чище исходная статья, тем проще получить одинаковые якоря на обычной и AMP-странице.

Наличие достаточного числа разделов

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

Тема, кеш и оптимизация

Если на сайте включён кеш страниц, минификация HTML, отложенная загрузка скриптов или агрессивная оптимизация CSS, проверку нужно выполнять после очистки кеша. Для AMP-страниц это особенно заметно: вы можете изменить настройку в админ-панели, но браузер или кеширующий плагин ещё показывает старую AMP-версию.

Мини-проверка перед установкой: откройте обычную запись с длинной структурой, убедитесь, что LuckyWP показывает оглавление и переходы по якорям работают. Затем откройте AMP-версию этой же записи без AMP-аддона и зафиксируйте, чего там не хватает. После установки вы будете сравнивать не абстрактный результат, а конкретное состояние до и после.

Установка и первичное включение без лишних действий

Установка состоит из двух разных операций. LuckyWP Table of Contents обычно ставится из каталога WordPress через Plugins - Add New. AMP LuckyWP Table of Contents как расширение AMP for WP устанавливается из ZIP-архива через загрузку плагина, если он получен из официального аккаунта или набора расширений AMP for WP. В руководстве не нужны действия с покупкой или лицензией, но важно понимать технический порядок.

Сначала проверьте основной LuckyWP

1. Откройте Plugins - Add New в админ-панели WordPress.
2. Найдите LuckyWP Table of Contents, установите и активируйте плагин.
3. Откройте Settings - Table of Contents.
4. Создайте или выберите тестовую запись с несколькими H2/H3.
5. Вставьте блок Table of Contents, shortcode [lwptoc] или включите авто-вставку.
6. Откройте предпросмотр обычной страницы и убедитесь, что оглавление реально выводится.

Этот этап нельзя пропускать. Если shortcode выводится как обычный текст или блок не видит заголовки, проблема находится не в AMP-аддоне. Сначала нужно разобраться с основной версией, иначе диагностика превратится в угадывание.

Затем включите AMP-совместимость

1. Проверьте, что AMP for WP активен и формирует AMP-страницы для нужных типов записей.
2. Откройте Plugins - Add New - Upload Plugin.
3. Загрузите ZIP-архив AMP LuckyWP Table of Contents и нажмите Install Now.
4. Активируйте расширение через Activate Plugin.
5. Очистите кеш сайта, кеш AMP for WP и кеш CDN, если он используется.
6. Откройте AMP-версию тестовой записи и сравните её с обычной версией.

Официальная страница расширения описывает его как plug and play: отдельных сложных настроек у аддона быть не должно. Поэтому после активации основной рабочий фокус остаётся в настройках LuckyWP и AMP for WP, а не в поиске отдельной панели для AMP LuckyWP Table of Contents.

Настройка LuckyWP, от которой зависит AMP-результат

Так как AMP-аддон использует существующую настройку LuckyWP, именно глобальные параметры основного плагина определяют, где появится оглавление, какие уровни заголовков попадут в список, как будут выглядеть якоря и насколько предсказуемым будет поведение на AMP-страницах.

Общие параметры: когда показывать оглавление

В общих настройках проверьте минимальное число заголовков, заголовок блока, уровни heading-тегов и поведение кнопки показать/скрыть. Для обычного блога часто достаточно показывать оглавление только в статьях, где есть несколько крупных разделов. Если включить показ при слишком малом числе заголовков, блок начнёт появляться в коротких заметках и будет выглядеть лишним. Если поставить порог слишком высоко, пользователи не увидят оглавление в материалах средней длины.

Для AMP лучше начинать с умеренных значений: H2 и H3 обычно дают хороший баланс. H4-H6 стоит включать только для документации и технических инструкций, где вложенность действительно помогает. Чем глубже дерево, тем больше риск получить длинный мелкий список, который на мобильной AMP-странице будет занимать слишком много места.

Авто-вставка: где блок должен появиться

LuckyWP поддерживает авто-вставку в несколько позиций: перед первым заголовком, после первого заголовка, после первого блока, вверху или внизу контента. Для AMP-страниц чаще всего удобны два варианта: перед первым H2 или после вводного блока. Так читатель успевает понять тему статьи, а затем получает навигацию.

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

Обработка заголовков и исключения

Раздел обработки заголовков нужен, когда в оглавление попадает лишнее: блоки “Читайте также”, рекламные подписи, технические заголовки виджетов, вопросы формы или повторяющиеся элементы конструктора. LuckyWP позволяет пропускать заголовки по уровню или тексту. Это особенно полезно для AMP, где боковые блоки и дополнительные элементы темы могут быть переупорядочены.

Настраивайте исключения осторожно. Сначала откройте исходный HTML или хотя бы визуально проверьте, какие заголовки попали в список. Затем исключайте только конкретные уровни или фразы. Не стоит сразу выключать все H3, если проблема в одном служебном заголовке. Так вы сохраните полезную вложенность в больших инструкциях.

Хеши, плавная прокрутка и языковые сайты

LuckyWP умеет формировать красивые якоря в URL. Для сайтов не на английском языке официальный каталог рекомендует проверить расширение PHP Intl. Практический смысл такой: если якорь строится по русскому заголовку, транслитерация и нормализация символов должны работать предсказуемо. Иначе в ссылках могут появиться странные фрагменты, дубли или символы, которые сложнее отлаживать.

Плавную прокрутку в AMP проверяйте отдельно. На обычной странице она может работать через скрипт или стиль темы, а AMP-версия живёт по другим правилам. Если после клика по пункту оглавления страница уходит не туда, сначала отключите плавную прокрутку в LuckyWP, очистите кеш и сравните поведение. Для AMP важнее точный переход к разделу, чем красивый анимационный эффект.

Как AMP LuckyWP Table of Contents переносит оглавление в AMP-версию

В обычной версии страницы LuckyWP анализирует заголовки, создаёт список ссылок и добавляет якоря к соответствующим разделам. AMP for WP затем формирует отдельный AMP-вывод. AMP LuckyWP Table of Contents подключается как совместимый слой: он должен взять уже существующую логику LuckyWP и сделать её пригодной для AMP-страницы.

Это важно понимать при диагностике. Если вы меняете цветовую схему, уровни заголовков или авто-вставку в LuckyWP, а AMP-страница не меняется, причина может быть в кеше AMP, в старой версии страницы, в отключённом типе записи или в том, что AMP for WP не применяет AMP к этой записи. Если на обычной странице всё правильно, а в AMP блок отсутствует, тогда уже проверяйте сам аддон совместимости.

Что должно совпасть с обычной версией

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

Что может отличаться

Некоторые элементы обычного TOC могут выглядеть иначе: анимация раскрытия, плавная прокрутка, мелкие CSS-эффекты, отступы, шрифты, поведение в боковой колонке. Это не всегда ошибка. Ошибка начинается там, где список не появляется, shortcode выводится как текст, якоря ведут не к тем разделам или AMP-валидатор показывает нарушение разметки.

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

Практический пример: оглавление для длинной инструкции в AMP

Разберём рабочий сценарий для сайта с обучающими статьями. Задача: у нас есть длинная инструкция с разделами H2 и H3, LuckyWP должен показать оглавление в обычной версии, а AMP LuckyWP Table of Contents - перенести этот блок в AMP без ручного дублирования.

Цель

Получить оглавление, которое появляется после вводного абзаца, содержит H2 и H3, не включает служебные блоки, а клики по пунктам ведут к правильным разделам в AMP-версии.

Подготовка

• В статье есть не менее нескольких настоящих H2/H3.
• LuckyWP Table of Contents активен и выводит оглавление на обычной странице.
• AMP for WP включён для типа записи, где опубликована инструкция.
• AMP LuckyWP Table of Contents установлен и активирован.
• Кеш сайта и AMP-страниц можно очистить после изменения настроек.

Шаги настройки

1. Откройте Settings - Table of Contents.
2. В общих настройках выберите показ оглавления только при достаточном числе заголовков.
3. Оставьте в глубине H2 и H3, если статья не является технической документацией с более глубокими уровнями.
4. Включите авто-вставку для записей и выберите позицию перед первым заголовком или после первого блока.
5. Откройте раздел обработки заголовков и исключите служебные фразы, если они попадают в список.
6. Сохраните изменения через Save Changes.
7. Очистите кеш и откройте обычную страницу в режиме инкогнито.
8. Откройте AMP-версию той же записи и проверьте тот же набор разделов.

Проверка результата

Проверяйте не только наличие блока. Пройдите по нескольким пунктам оглавления в середине и в конце статьи. Убедитесь, что после клика вы попадаете к правильному заголовку, URL получает ожидаемый фрагмент после #, а верхняя часть раздела не прячется под фиксированной шапкой. Затем откройте AMP-валидатор или консоль разработчика с параметром проверки AMP и убедитесь, что добавленное оглавление не создаёт ошибок.

Нюанс, который часто мешает

Если оглавление не появляется в AMP, но видно на обычной странице, сначала проверьте, включён ли AMP именно для этого типа записи и не исключена ли конкретная запись в настройках AMP for WP. Если shortcode виден как текст, проверьте, обрабатывается ли он внутри текущего шаблона и не вставлен ли блок вне области контента, где WordPress не выполняет shortcodes стандартным образом.

Практичные идеи применения на разных типах контентных сайтов

AMP LuckyWP Table of Contents особенно полезен не как отдельная “фича”, а как часть редакционного процесса. Если у команды есть правило: каждая длинная статья имеет понятную структуру и проверенную AMP-версию, оглавление становится навигационным стандартом.

База знаний или документация

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

Блог с большими руководствами

Для обучающего блога лучше не включать слишком глубокую вложенность. H2 и H3 обычно достаточно, чтобы сохранить читаемость на мобильной AMP-версии. Если в статье много FAQ, таблиц и блоков “советы”, исключите служебные заголовки из оглавления, чтобы список оставался навигацией по содержанию, а не копией всех технических блоков страницы.

Обзорные и сравнительные статьи

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

Редакционный процесс перед публикацией

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

Проверка AMP-валидности и качества навигации

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

Быстрая проверка через браузер

1. Откройте AMP-версию статьи.
2. Добавьте к URL параметр #development=1.
3. Откройте инструменты разработчика и вкладку Console.
4. Посмотрите, есть ли ошибки AMP-валидации.
5. Кликните по пунктам оглавления и убедитесь, что переходы не создают новых ошибок.

Если консоль показывает ошибку, не спешите обвинять именно AMP LuckyWP Table of Contents. На AMP-странице одновременно работают тема, AMP for WP, основной LuckyWP, кеш, рекламные блоки, формы, вставки видео и другие расширения. Ваша задача - сузить участок: временно отключить спорную настройку, очистить кеш, сравнить страницу без кастомного CSS и проверить, исчезает ли ошибка.

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

После валидации откройте страницу на узком экране или в режиме мобильного просмотра. Оглавление должно быть читаемым, не перекрывать начало статьи, не требовать горизонтальной прокрутки и не занимать непропорционально большой первый экран. Если список слишком длинный, уменьшите глубину заголовков или исключите служебные разделы. Если ссылки ведут слишком высоко под фиксированную шапку, проверьте offset для прокрутки в LuckyWP и поведение шапки в AMP for WP.

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

Редакционный чек-лист перед запуском на всём сайте

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

Выберите контрольные материалы

Возьмите 5-7 разных страниц, а не одну идеальную инструкцию. В набор стоит включить длинную статью с H2/H3, короткую запись без оглавления, материал с таблицами, страницу с блоками конструктора, запись с рекламными или похожими блоками и статью, где есть кириллические заголовки. Такой набор быстрее показывает, насколько стабильно LuckyWP и AMP LuckyWP Table of Contents работают в реальных условиях сайта.

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

Согласуйте правила заголовков с редакторами

TOC-плагин не понимает смысл текста так, как редактор. Он видит только уровни заголовков и настройки исключений. Поэтому команде нужен простой стандарт: один H2 для каждого крупного раздела, H3 для подразделов, без пропуска уровней ради внешнего вида, без служебных заголовков внутри контента, если они не должны попадать в оглавление. Это особенно важно для AMP, где длинная вложенная структура быстрее становится тяжёлой для мобильного чтения.

Хорошее правило для руководств: если пункт оглавления не помогает выбрать нужную часть статьи, его лучше не включать. Для этого можно переписать заголовок, изменить уровень или добавить текст в исключения LuckyWP. Но не стоит скрывать половину разделов только потому, что оглавление стало длинным. Часто правильнее улучшить структуру статьи.

Проверяйте якоря после крупных правок

Когда редактор меняет заголовки после публикации, якоря могут измениться. Это влияет на ссылки из оглавления, внутренние ссылки из других статей и сохранённые пользователями адреса с фрагментом после #. На обычной странице это неприятно, а в AMP-версии сложнее заметить, потому что она может обновиться позже из-за кеша.

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

Оценивайте мобильную плотность, а не только наличие блока

На desktop-странице длинное оглавление может выглядеть нормально, но на AMP-экране оно превращается в большой список перед текстом. Если посетитель видит только навигацию и не видит начало ответа, это ухудшает опыт. Решение не всегда в отключении оглавления: иногда достаточно уменьшить глубину до H2/H3, исключить служебные заголовки или выбрать позицию после вводного блока.

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

Если сайт публикует материалы сериями, проверяйте не только новые статьи, но и старые evergreen-руководства. Именно в них чаще накоплены устаревшие заголовки, ручные якоря, вставки конструктора и экспериментальные блоки, которые могли работать в обычной версии, но плохо переноситься в AMP.

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

Аккуратная адаптация внешнего вида без риска для AMP

У LuckyWP есть настройки внешнего вида: ширина, выравнивание, размеры шрифтов, цветовые схемы, возможность переопределять цвета и дополнительный CSS-класс. Обычно этого достаточно. Код стоит добавлять только тогда, когда штатных настроек не хватает и вы понимаете, где будет применяться правка.

Самый безопасный подход - задать в LuckyWP дополнительный CSS-класс для конкретного варианта оглавления, например toc-compact, а затем стилизовать только этот класс в дочерней теме или через безопасный механизм добавления CSS. Для AMP-версии любые стили должны проходить через механизм, который AMP for WP корректно добавляет в AMP CSS. Нельзя вставлять произвольные скрипты ради оформления оглавления.

Ниже пример маленькой правки для более компактного списка. Она основана на штатной идее дополнительного CSS-класса и на публичных классах разметки LuckyWP, которые встречаются в обсуждениях поддержки. Перед применением проверьте HTML на своём сайте: если тема или версия плагина выводит другие классы, адаптируйте селекторы или не используйте snippet.

.toc-compact {
  max-width: 760px;
  margin: 24px 0;
}

.toc-compact .lwptoc_itemWrap {
  line-height: 1.55;
}

.toc-compact .lwptoc_item {
  margin-bottom: 6px;
}

Где применять: добавьте toc-compact в поле дополнительных CSS-классов LuckyWP, затем поместите CSS в дочернюю тему, штатный редактор дополнительного CSS или AMP-safe CSS-панель, если вы уже используете её в AMP for WP. После сохранения откройте обычную и AMP-страницу, проверьте читаемость, затем прогоните AMP-валидацию.

Откат простой: удалите класс из настроек LuckyWP или удалите CSS-блок. Не меняйте файлы самого плагина и не правьте ядро WordPress. Если после CSS-правки AMP-валидатор показывает ошибку или стили не применяются, вернитесь к настройкам внешнего вида LuckyWP и упрощённому оформлению.

Диагностика: почему оглавление не видно или ведёт не туда

Проблемы с AMP-оглавлением почти всегда нужно разбирать по слоям. Сначала обычная версия LuckyWP, затем AMP for WP, потом аддон совместимости, затем кеш и тема. Такой порядок быстрее, чем включать и выключать всё подряд.

Оглавление есть в обычной версии, но отсутствует в AMP

Симптом: на обычной странице LuckyWP работает, но AMP-страница открывается без блока оглавления.

Возможные причины: AMP не включён для этого типа записи, конкретная запись исключена, AMP-аддон не активирован, кеш показывает старую версию, либо шаблон AMP выводит контент без участка, где LuckyWP вставляет оглавление.

Что проверить

• Открывается ли AMP-версия этой записи вообще.
• Активны ли AMP for WP, LuckyWP Table of Contents и AMP LuckyWP Table of Contents.
• Включена ли авто-вставка для нужного типа записи.
• Очищен ли кеш сайта, AMP for WP и CDN.

Исправление начинайте с простого: очистите кеш, временно вставьте shortcode [lwptoc] в тело записи, проверьте AMP-страницу. Если shortcode в теле работает, а авто-вставка нет, проблема в позиции авто-вставки или шаблоне. Если shortcode не работает и в обычной версии, возвращайтесь к настройке LuckyWP.

Shortcode отображается как текст

Симптом: вместо таблицы содержания пользователь видит [lwptoc]. В поддержке LuckyWP встречались похожие случаи, особенно когда блок или shortcode расположен вне основного контента, например в области шаблона или боковой панели.

Причина обычно не в AMP-аддоне, а в том, что WordPress не обработал shortcode в конкретной области вывода. Проверьте, вставлен ли shortcode в тело записи, в штатный блок shortcode или в шаблон, который действительно применяет обработку shortcodes.

Исправление: для теста перенесите [lwptoc] внутрь обычного контента записи. Если там всё работает, не используйте этот способ вывода в проблемной области шаблона без дополнительной разработки. Для AMP лучше выбирать авто-вставку LuckyWP или блок внутри основного контента.

Оглавление показывает лишние или неправильные разделы

Симптом: в список попали заголовки виджетов, блоков темы, похожих материалов или технических вставок.

Причина в том, что LuckyWP анализирует найденные heading-теги. Если тема или конструктор добавляет H2/H3 в область контента, плагин может считать их частью статьи. Исправление: настройте пропуск заголовков по тексту или уровню, а для спорных блоков измените их разметку в шаблоне, если это безопасно и находится под вашим контролем.

Якорь ведёт не к тому месту

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

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

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

Симптом: вы меняете глубину, цвет или авто-вставку, но AMP-страница выглядит по-старому.

Чаще всего виноват кеш. Очистите кеш WordPress, кеш AMP for WP, кеш оптимизатора, браузерный кеш и CDN. Затем откройте страницу в приватном окне. Если обычная страница изменилась, а AMP нет, проверьте, не использует ли AMP for WP отдельный шаблон или старую сборку CSS.

AMP-валидатор показывает ошибку после оформления

Симптом: оглавление видно, но валидатор сообщает об ошибке разметки или CSS.

Сначала отключите недавние визуальные правки, особенно кастомный CSS и дополнительные скрипты темы. Затем проверьте страницу с базовым оформлением LuckyWP. Если ошибка исчезла, возвращайте стили маленькими порциями. Если ошибка остаётся, проверьте другие AMP-блоки страницы: реклама, формы, видео и вставки часто создают ошибки, которые визуально кажутся связанными с оглавлением.

Когда стоит использовать AMP LuckyWP Table of Contents

Этот продукт будет удачным выбором, если на сайте уже работают LuckyWP Table of Contents и AMP for WP, а задача состоит в том, чтобы сохранить оглавление в AMP-версии без ручного дублирования. Он особенно полезен для длинных материалов, где навигация по H2/H3 напрямую влияет на удобство чтения.

Не стоит ставить аддон вслепую на сайт без AMP-стратегии. Если AMP-страницы не используются, отключены для записей или не проверяются после публикации, расширение не даст заметной пользы. Также не стоит ожидать, что оно исправит проблемную структуру статьи или сложный шаблон, где TOC-плагин в принципе не видит нужный контент.

Перед внедрением подготовьте одну тестовую длинную запись, настройте LuckyWP, включите AMP-аддон, проверьте обычную и AMP-версию, затем прогоните страницу через AMP-валидатор. Если всё совпадает, можно переходить к рабочим материалам и скачать ZIP-архив для установки на сайте.

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