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 Tableofcontents

Установка

Установка из панели управления 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.

Отзывы

03.11.2024 1 ответ
It´s good, easy functional. I´d like only some more functions for example the possibility to define the depht of a chapter without using h1, h2 etc.
30.10.2024 1 ответ
I am very happy with the plugin, it is easy to use and does what it is supposed to do, it also offers many creative design options. A small difficulty initially arose when I tried to create a table of contents from already numbered headings, as the numbering appeared twice. This was easily solved by selecting the option ‘without enumeration’ in the plugin settings under General/Enumeration. Thank you very much!
28.10.2024 1 ответ
This is a great plugin! Initially, I wasn’t sure about installing a plugin that automatically installs table of contents on every posts, instead of selected the posts I want to show the TOC on. After using it, I came to the conclusion that: 1/ It’s much better if you may uninstall the plugin, it won’t require removing code from posts; 2/ The options ensure you will make TOC available on posts that realy need it. It’s very well thought.
06.10.2024 1 ответ
Fa tutto quanto descritto nella pagina del plugin e lo fa bene, inoltre da la possibilità di inserire un widget nella barra laterale, molto comodo per avere sempre visibile il TOC nella visualizzazione da desktop.
Посмотреть все 827 отзывов

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

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

Участники

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

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

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

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

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

2.1.8 — 2024-10-28

  • Adapt to WordPress 6.7.

2.1.7 — 2024-10-18

  • Fix non-critical vulnerability.

2.1.6 — 2024-10-04

  • Fix vulnerabilities.

2.1.5 — 2024-09-05

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

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

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