Этот плагин не тестировался с последними 3 основными выпусками WordPress. Скорее всего, он уже не поддерживается и может быть несовместим с текущими версиями WordPress.

LuckyWP Table of Contents

Описание

Создаёт SEO-дружественное содержание для ваших постов, страниц и произвольных типов постов. Полностью настраиваемый внешний вид.

Возможности

  • Автоматическая вставка содержания (настраиваются типы постов и позиция).
  • SEO-дружественен: код содержания готов к использованию Google для сниппетов на странице результатов.
  • Вставка через шорткод, Gutenberg-блок или виджет.
  • Кнопка на тулбаре классического редактора.
  • Gutenberg-блок в «Основных блоках».
  • Настройка минимального количества заголовков для отображения содержания.
  • Настройка глубины заголовков для содержания.
  • Пропуск заголовков по уровню или тексту.
  • Древовидный или линейный вид.
  • Нумерация элементов: десятичные или римские числа по порядку или вложенные.
  • Настраиваемый внешний вид: ширина, выравнивание, размер и толщина шрифта заголовка, размер шрифта элементов, цвета.
  • Цветовые схемы (тёмная, светлая, белая, прозрачная, наследуемая из темы) и возможность переопределения цветов.
  • Ссылка Показать/Скрыть (опционально)
  • Настраиваемые надписи.
  • Плавная прокрутка (опционально).
  • Настройка смещения сверху для плавной прокрутки.
  • Обернуть содержание в тег <!—noindex—> (опционально).
  • Красивые хэши в URL (например, example.com/faq/#how_do_this).
  • Поддержка RTL.
  • Доступно переопределение глобальных настроек в конкретном посте.
  • Хорошая совместимость с темами и плагинами WordPress.

Автодобавление

Для автоматической вставки содержания в посты, выберите опцию »
Автодобавление содержания» в настройках плагина (вкладка «Автодобавление»).

Поддерживаемые позиции:

  • перед первым заголовком;
  • после первого заголовка;
  • после первого блока (параграф или заголовок);
  • вверху содержимого поста;
  • внизу содержимого поста.

Также вы можете выбрать типы постов, в которые будет автоматически добавлено оглавление.

Ручная вставка

Для ручного добавления содержания в посты используйте один из путей:

  • кнопка «Содержание» на тулбаре в классическом редакторе;
  • gutenberg-блок «Содержание»;
  • шорткод [lwptoc].

Красивые хэши в URL

По умолчанию, хэш генерируется как текст заголовка (например, #How_Do_This). Вы можете изменить формат хэша в глобальных настройках, вкладка «Прочее».

Для сайтов НЕ на английском языке рекомендуется включить PHP-расширение Intl.

Совместимость

LuckyWP Table of Contents был успешно протестирован со следующими плагинами:

Хуки

Фильтры lwptoc_before, lwptoc_after

Используйте для добавления произвольного HTML-кода до/после содержания.

Пример:

add_filter('lwptoc_before', function ($before) {
    return '<p>Example text before TOC.</p>' . $before;
});

Фильтр lwptoc_shortcode_tag

Используйте этот фильтр для изменения имени тега шорткода [lwptoc].

Пример:

add_filter('lwptoc_shortcode_tag', function ($tag) {
    return 'toc';
});

Фильтр lwptoc_heading_id

Используется для изменения ID заголовка.

Пример:

add_filter('lwptoc_heading_id', function ($id, $label) {
    return $id;
}, 10, 2);

Скриншоты

  • Содержание
  • Поддержка Gutenberg
  • Поддержка классического редактора
  • Окно настройки
  • Примеры цветовых решений
  • Настройки виджета
  • Общие настройки
  • Настройки внешнего вида
  • Настройка автодобавления
  • Настройка обработки заголовков
  • Прочие настройки

Блоки

Этот плагин предоставляет 1 блок.

  • LuckyWP Table of Contents

Установка

Установка из панели управления WordPress

  1. Перейдите на страницу «Плагины > Добавить новый»
  2. Введите «LuckyWP Table of Contents» в поле для поиска
  3. Найдите плагин «LuckyWP Table of Contents» в результатах поиска и нажмите кнопку «Установить», запустится процесс установки плагина.
  4. Нажмите на кнопку «Активировать» после завершения установки.

Установка из архива

  1. Перейдите на страницу «Плагины > Добавить новый» в панели управления WordPress
  2. Нажмите на кнопку «Загрузить плагин», откроется форма для загрузки архива.
  3. Выберите архив с плагином и нажмите «Установить».
  4. Нажмите на кнопку «Активировать» после завершения установки.

Ручная установка

  1. Загрузите папку luckywp-table-of-contents в папку с плагинами, обычно это /wp-content/plugins/.
  2. Перейдите на страницу «Плагины > Добавить новый» в панели управления WordPress
  3. Найдите «LuckyWP Table of Contents» в списке плагинов и нажмите «Активировать».

После активации

В классическом редакторе появится кнопка «Содержание» (доступна на экране редактирования страницы/поста).

В редакторе Gutenberg появится блок «Содержание» (см. «Общие блоки»).

В меню панели управления WordPress в разделе «Настройки» появится пункт «Содержание».

Для сайтов НЕ на английском языке рекомендуется включить PHP-расширение Intl.

Отзывы

16.11.2023
So far, the best of the TOC plugins I've ever used. It offers important features that others fail to offer. We are lucky to be able to use this plugin.
Посмотреть все 802 отзыва

Участники и разработчики

«LuckyWP Table of Contents» — проект с открытым исходным кодом. В развитие плагина внесли свой вклад следующие участники:

Участники

«LuckyWP Table of Contents» переведён на 31 язык. Благодарим переводчиков за их работу.

Перевести «LuckyWP Table of Contents» на ваш язык.

Заинтересованы в разработке?

Посмотрите код, проверьте SVN репозиторий, или подпишитесь на журнал разработки по RSS.

Журнал изменений

2.1.4 — 2020-08-03

  • Небольшой рефакторинг кода.

2.1.3 — 2020-06-07

  • Добавлен хук-фильтр lwptoc_allow.

2.1.2 — 2020-05-08

  • Добавлен хук-фильтр lwptoc_title_tag.

2.1.1 — 2020-03-15

  • В ID заголовка дубликаты дефисов заменяются на один.
  • Исправлено: содержимое тегов <style> и <script> добавлялось в заголовок.

2.1 — 2020-03-12

  • Добавлена опция «Дополнительный(-ые) класс(ы) CSS».
  • Добавлена опция «OL/LI» к «Теги разметки списка».
  • Добавлена поддержка Oxygen Builder.
  • Удалён класс «lwptoc_item» из ссылок.
  • Мелкие правки для повышения производительности.

2.0.9 — 2020-03-07

  • Добавлены хуки-фильтры lwptoc_heading_html и lwptoc_heading_label.
  • Исправлено: в некоторых случаях не регистрировались JS/CSS файлы.
  • Мелкие исправления для совместимости с будущими версиями WordPress.

2.0.8 — 2020-02-23

  • Добавлен хук-фильтр lwptoc_active.
  • В настройках добавлена вкладка «Плагины LuckyWP».
  • Улучшения в работе опции «Пропуск заголовков по тексту».
  • Исправлено: в некоторых случаях шорткод обрабатывался некорректно.
  • Исправлено: в некоторых случаях автоматическая вставка работала некорректно.
  • Исправлено: заголовки в содержании не экранировались.
  • Мелкие исправления в окне настроек.

2.0.7 — 2020-01-31

  • Добавлена поддержка дочерних тем «Twenty Twenty».
  • Исправлено: некорректно работала плавная прокрутка, если на странице применялся CSS html {scroll-behavior: smooth;}.
  • Исправлено: в некоторых случаях некорректно работала автоматическая вставка после первого блока.

2.0.6 — 2020-01-29

  • Когда включена плавная прокрутка хэш изменяется после завершения анимации.
  • Исправлено: некорректная обработка условных комментариев в контенте.
  • Исправлено: JS не работал при асинхронной загрузке.

2.0.5 — 2020-01-26

  • Исправлено: некорректная обработка HTML-сущностей в ссылках.
  • Исправлено: некорректная обработка скриптов, стилей и CDATA в контенте.

2.0.4 — 2020-01-25

  • В отладочную информацию в инструменте «Здоровье сайта» добавлены «Версия intl» и «Версия ICU».
  • Когда используется формат «Как заголовок без транслитерации», из хэша удаляется символ двоеточия.
  • Исправлено: некорректная обработка HTML-сущностей.

2.0.3 — 2020-01-19

  • Добавлена поддержка темы «Twenty Twenty».
  • Небольшой рефакторинг кода.

2.0.2 — 2020-01-10

  • Исправлено: в некоторых случаях плагин некорректно работал с UTF-8.
  • Исправлено: при автоматической вставке оглавления с опцией «Перед/после первого заголовка» в постах без заголовков возникала ошибка.
  • Исправлено: если отключен переключатель «Показать/Скрыть», то возникала ошибка в JS.

2.0.1 — 2020-01-08

  • Исправлено: в некоторых случаях обработка заголовков происходила некорректно.

2.0 — 2020-01-07

  • Добавлена отладочная информация в инструменте «Здоровье сайта».
  • CSS и JS подключаются только когда выводится содержание.
  • На фронтенде удалена зависимость от jQuery.
  • Переработана автоматическая вставка оглавления с использованием PHP-расширения DOM (Document Object Model).
  • Переработана обработка заголовков с использованием PHP-расширения DOM (Document Object Model).
  • Небольшие улучшения в CSS.

1.9.11 — 2019-11-18

  • Добавлены хуки-фильтры lwptoc_force_wp_transliterate и lwptoc_transliterator.
  • Исправлено: в некоторых случаях для содержания использовался не текущий пост.

1.9.10 — 2019-11-10

  • Исправлено: в некоторых случаях хэш для заголовков без транслитерации генерировался некорректно.

1.9.9 — 2019-11-06

  • Мелкие правки для совместимости с WPML.

1.9.8 — 2019-10-23

  • Мелкие правки для совместимости с WordPress 5.3.

1.9.7 — 2019-10-17

  • Исправлено: в некоторых случаях виджет отображался некорректно.

1.9.6 — 2019-10-11

  • Улучшения для лучшей совместимости с темами и плагинами.

1.9.5 — 2019-10-09

  • Улучшения для лучшей совместимости с темами и плагинами.

1.9.4 — 2019-09-04

  • Улучшения для лучшей совместимости с темами и плагинами.

1.9.3 — 2019-08-25

  • Добавлена совместимость с WPML.

1.9.2 — 2019-08-11

  • Добавлена поддержка плагина Elementor.

1.9.1 — 2019-08-04

  • Добавлена поддержка плагина Toolset Views.

1.9 — 2019-08-04

  • Добавлена специальная цветовая схема «Наследовать из темы».
  • Добавлена опция «Теги разметки списка».
  • Добавлена поддержка Beaver Builder Themer Add-On.
  • Реализовано автоматическое удаление пустых заголовков из содержания.
  • Автоматическая вставка содержания «после первого блока» учитывает только параграфы и заголовки.
  • Улучшен JS код для предотвращения повторной инициализации.
  • Мелкие изменения в строках, исправлены опечатки.
  • В коде добавлены подсказки для переводчиков.

1.8 — 2019-07-29

  • Добавлена опция «Использовать rel=»nofollow» для ссылок»
  • Добавлена совместимость с плагином Rank Math SEO.
  • Опция «Автоматическая вставка содержания» по умолчанию отключена.
  • В уведомлении «Оценить плагин» действие «Я уже оценил плагин» заменено на «Больше не показывать».
  • В коде добавлены подсказки для переводчиков.

1.7 — 2019-07-18

  • Для хеша добавлена опция «Заменить подчёркивания (_) на дефисы (-)».
  • Для хеша добавлена опция «Преобразовать в нижний регистр».
  • Мелкие правки в текстах.
  • В коде добавлены подсказки для переводчиков.
  • Исправлено: в некоторых случаях некорректно работал пропуск заголовков.

1.6.1 — 2019-07-14

  • Для формата хэша добавлена опция «Как заголовок без транслитерации».
  • Добавлен перевод на иврит, спасибо @cdk-comp и @0enaro.
  • Добавлен перевод на испанский язык, спасибо @fernandot, @sanbec и @nobnob.
  • Улучшена генерация хэша с опцией «Как заголовок».

1.6 — 2019-07-13

  • Добавлена поддержка RTL.
  • Добавлена опция «Суффикс нумерации».
  • Текстовый домен изменён на «luckywp-table-of-contents».
  • Улучшена поддержка плагина Beaver Builder.

1.5.7 — 2019-07-10

  • Улучшена реализация плавной прокрутки для поддержки в контенте изображений с «ленивой загрузкой».
  • Исправлено: в некоторых случаях некорректно работала плавная прокрутка к заголовку.

1.5.6 — 2019-07-06

  • Исправлено: в некоторых случаях некорректно работала опция «Минимальное количество заголовков».

1.5.5 — 2019-07-06

  • Изменён код для совместимости с плагином Toolset Access.

1.5.4 — 2019-06-29

  • Добавлена поддержка плагина Beaver Builder.
  • Исправлено: в некоторых случаях обработка заголовков выполнялась некорректно.

1.5.3 — 2019-06-27

  • Исправлено: если содержание вставлялось автоматически, то не переопределялись настройки «Обернуть содержание тегом <!—noindex—>» и «Пропустить заголовки».
  • Исправлено: в некоторых случаях автоматическая вставка после первого блока не работала.

1.5.2 — 2019-06-17

  • Добавлен фильтр lwptoc_heading_id.
  • Реализовано классическое поведение при клике на кнопку «Назад» в браузере.

1.5.1 — 2019-06-05

  • Исправление ошибок

1.5 — 2019-06-04

  • Улучшения для поисковых систем (Google и других).

1.4.1 — 2019-06-01

  • Исправление ошибок

1.4 — 2019-06-01

  • Добавлен виджет «Содержание».
  • Добавлена поддержка вывода содержания через шорткод do_shortcode('[lwptoc]').
  • Улучшена совместимость с темами.

1.3.1 — 2019-05-09

  • Исправление ошибок

1.3.0 — 2019-05-08

  • Пропуск заголовков по уровню или тексту.

1.2.2 — 2019-04-24

  • Исправление ошибок

1.2.1 — 2019-04-24

  • Улучшена совместимость с темами.

1.2.0 — 2019-04-23

  • Добавлены опции для выравнивания: «По центру» и «Вправо без обтекания».
  • Добавлена настройка «Формат хэша».
  • В якорях вместо атрибута «name» используется «id».
  • Небольшие улучшения в CSS для большей совместимости с темами.

1.1.1 — 2019-04-15

  • Тег <noindex> заменён на <!—noindex—>.

1.1.0 — 2019-04-14

  • Добавлена опция «Обернуть содержание в тег <noindex>».
  • Добавлены фильтры lwptoc_before, lwptoc_after, lwptoc_shortcode_tag.
  • Исправлено: в редакторе Гутенберг в блоке «Классический редактор» не загружался CSS для шорткода.

1.0.4 — 2019-11-18

  • Исправление ошибок

1.0.3 — 2019-11-17

  • Мелкие улучшения внешнего вида
  • Исправление ошибок

1.0.2 — 2019-11-16

  • Исправление ошибок

1.0.1 — 2019-11-15

  • Исправление ошибок

1.0.0 — 2018-11-14

  • Первая версия.