Описание
Создаёт 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 был успешно протестирован со следующими плагинами:
- Elementor Page Builder
- Beaver Builder и Beaver Builder Themer Add-On
- WPBakery Page Builder
- Oxygen
- WordPress Multilingual Plugin (WPML), официально подтверждено
- Rank Math, официально подтверждено
- WP Rocket
- Toolset Views и Toolset Access
Хуки
Фильтры 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);
Скриншоты
Блоки
Этот плагин предоставляет 1 блок.
- Luckywp Tableofcontents
Установка
Установка из панели управления WordPress
- Перейдите на страницу «Плагины > Добавить новый»
- Введите «LuckyWP Table of Contents» в поле для поиска
- Найдите плагин «LuckyWP Table of Contents» в результатах поиска и нажмите кнопку «Установить», запустится процесс установки плагина.
- Нажмите на кнопку «Активировать» после завершения установки.
Установка из архива
- Перейдите на страницу «Плагины > Добавить новый» в панели управления WordPress
- Нажмите на кнопку «Загрузить плагин», откроется форма для загрузки архива.
- Выберите архив с плагином и нажмите «Установить».
- Нажмите на кнопку «Активировать» после завершения установки.
Ручная установка
- Загрузите папку
luckywp-table-of-contents
в папку с плагинами, обычно это/wp-content/plugins/
. - Перейдите на страницу «Плагины > Добавить новый» в панели управления WordPress
- Найдите «LuckyWP Table of Contents» в списке плагинов и нажмите «Активировать».
После активации
В классическом редакторе появится кнопка «Содержание» (доступна на экране редактирования страницы/поста).
В редакторе Gutenberg появится блок «Содержание» (см. «Общие блоки»).
В меню панели управления WordPress в разделе «Настройки» появится пункт «Содержание».
Для сайтов НЕ на английском языке рекомендуется включить PHP-расширение Intl
.
Отзывы
Участники и разработчики
«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
- Первая версия.