Русифицированный плагин — «Table of Contents Plus»
Содержание:
Здравствуйте друзья! Как и обещал в прошлой статье, выкладываю русифицированную версию плагина “Table of Contents Plus” и файлы его русификации. А заодно, немного расскажу о возможных вариантах настроек плагина, хотя, их не так уж и много.
Плагин служит для создания оглавления/содержания статьи. А также автоматической или ручной вставки оглавления в пост. Table of Contents Plus очень лёгкий, имеет достаточно гибкие настройки и не конфликтует с другими плагинами. Есть возможность создать свой собственный вид отображения (дизайн), что позволяет использовать его в блогах любой цветовой гаммы.
Установка и настройка Table of Contents Plus
Скачать плагин можно по следующей ссылке: Скачать плагин.
Установить плагин можно из админ-панели, пройдя по пути: Плагины/Добавить новый/Загрузить плагин/. Выберите скачанный архив и нажмите кнопку: Установить. После чего, активируйте его.
В левой колонке админ-панели откройте: Настройки/ TOC+.
В разделе: Основные параметры
- Откройте список вариантов расположения оглавления на странице, нажав на треугольник (стрелка 1).
- Таким же образом, откройте список и укажите при каком количестве заголовков показывать Оглавление/Содержание статьи (стрелка 2).
- Следующая настройка требует небольшого объяснения. Она очень полезна для тех блогов, в которых уже написано много постов, а оглавлений по разным причинам ранее не были созданы. И, если включить автоматическую вставку оглавлений, то во всех постах автоматически появится Содержание/Оглавление. Разные сайты/блоги имеют разные типы контента, например, в моих блогах всего одна страница, главная, а в ней все посты (статьи). Поэтому, в моём случае активирована автоматическая вставка оглавлений для постов/статей (стрелка 3). В других сайтах для каждой информации создаётся отдельная страница. В этом случае следует активировать вставку для Page (страница), а если в отдельно созданных страницах присутствуют ещё по несколько статей, то есть смысл активировать обе вставки. И ещё, что важно. Не каждая статья требует оглавления, более того, оглавление требуется в редких случаях. В этом случае, активировать автоматическую вставку совсем не нужно, а воспользоваться ручной вставкой (об этом позже).
- Эта настройка проста. Если её активировать (стрелка 4), не забудьте указать текст заголовка списка оглавления.
- Бывают очень длинные посты с большим количеством заголовков и подзаголовков – оглавление получается так же, очень длинным. Именно для подобных ситуаций создана функция, разрешающая посетителю закрыть содержание (стрелка 5), нажав на ссылку, расположенную справа от заголовка содержания. Текст этой ссылки можете придумать сами и вписать в соответствующие строчки.
- Следующая настройка обратна предыдущей – при открытии страницы, оглавление/содержание отображается в свёрнутом состоянии. Посетитель, в этом случае, может сам открыть содержание, нажав на ссылку, придуманную вами в предыдущей настройке.
- Показывать иерархию. Активация этой функции (стрелка 7) придаёт оглавлению более симпатичный и профессиональный вид.
Продолжим настройки:
- Список Количество пунктов (следует читать: Количество пунктов списка) – Если снять галочку (стрелка 8), то не будет отображаться нумерация списка оглавления.
- Включение плавной прокрутки (стрелка 9) – в объяснении не нуждается, но играет роль при дальнейших тонких настройках плагина.
- Ширина — При желании, откройте список предлагаемых размеров (стрелка 10) и укажите желаемый размер ширины текстового поля оглавления.
- Обтекание текстом – Если открыть список(стрелка 11) и указать: Содержание слева или Содержание справа, оглавление займёт место в тексте слева или справа (как картинка в анонсе или тексте статьи), учитывая настройку №1. В этом случае, имеет смысл указать размер ширины (настройка №10).
- Размер шрифта – не нуждается в объяснениях.
- Вид отображения – По умолчанию активирован серый фон, можно подобрать из имеющихся или активировать радиокнопку: Собственные настройки (стрелка 13) и в открывшемся окне установить желаемые фон, цвета заголовка и ссылок, а также цвет границы (рамки).
- Для продвинутых – Откройте дополнительные настройки (стрелка 14).
Дополнительные настройки
Исключить CSS файл – Если поставить галку в чекбокс этой настройки (стрелка 1), отключаются CSS плагина и вступают в силу CSS вашей темы.
Уровни заголовков – В современных темах (шаблонах), если статья открыта, тегом h1 отмечается не заголовок сайта, а заголовок статьи. Он имеет приоритет перед всеми заголовками и подзаголовки теперь отмечаются тегами h2 и далее. Конечно, переделывать структуру старых статей наверное не стоит, поскольку они индексированы и неизвестно, как отнесутся к подобным изменениям «боты» поисковых систем. Поэтому, в моих настройках установлено – показывать в оглавлении заголовки уровней h2-h3 (стрелка 2). Зайдите в файл single.php и посмотрите, как настроены ваши заголовки. Если заголовок статьи (title) под тегом h1, то подзаголовки будут иметь теги h2-h3 и можно поставить галки, как у меня. А если заголовок под тегом h2, то подзаголовки будут иметь теги h3-h4. Ведь, именно подзаголовки отображаются в Оглавлении/Содержании.
Стрелкой №3 показан размер 30px. Именно такую высоту имеет горизонтальное меню WordPress, а значит, заголовок вызванный ссылкой из оглавления, не будет спрятан под горизонтальным меню (об этом я говорил в предыдущей статье). Но, эта функция работает только в том случае, если у вас включена функция плавной прокрутки (в настройках выше). В любом случае, посетитель всегда будет видеть правильное отображение заголовка на странице.
И, наконец, пожалуй самое важное. Если для вас необязательно иметь оглавление в каждой статье, независимо от количества заголовков и подзаголовков, а устанавливать только в тех статьях, в которых вы считаете нужным. В любом месте (верху статьи, перед первым или десятым заголовком или ещё где-то в статье) поставьте в квадратных скобках без кавычек «[toc]»(стрелка 4), независимо, в каком редакторе будете вставлять, в визуальном или в текстовом. (изначально квадратные скобки стояли в тексте без кавычек, но пришлось поставить, потому что оглавление создалось именно в этом месте) (:unknw:)
Осуществив необходимые настройки, нажмите кнопку: Обновить настройки (стрелка 5).
Файлы русификации для “Table of Contents Plus”
Скачать файлы русификации можно по ссылке ниже. Чтобы установить файлы, распакуйте архив, в нём два файла, и через файловый менеджер, например, FileZilla, установите их в папку languages пройдя по пути:
/Ваш сайт/wp-content/plugins/table-of-contents-plus/languages
Ссылка: Скачать файлы
По просьбе посетителя — небольшое дополнение!
Ручная вставка заголовка
Для ручной вставки заголовка в первую очередь в настройках плагина необходимо отключить автоматическую вставку (первый снимок, стрелка 3)
Затем, в статье выделите необходимый заголовок (окрашено синим) и присвойте ему степень приоритета (стрелка 1).
Перед заголовком, в квадратных скобках впишите тег: toc (стрелки 2)
В итоге получается примерно такой результат.
Удачи Вам!
© mkoven
Установила плагин и пользовалась им. Сегодня перестал работать.
не пойму, в чем дело.
Вместо Вставить оглавление появилось Отключить автоматическую вставку оглавления.
Не знаю, с чем это связано. Помогите, пожалуйста.
С ув. Лара
Если вы хотите установить оглавление вручную, используя «[toc]», то вам так и будут писать "Отключить автоматическую вставку оглавления", потому что в настройках активирована функция автоматической вставки. Т.е. если у вас 2 и более ссылки в тексте, оглавление устанавливается автоматически.
Я заходил к вам на сайт, оглавление работает хорошо.
Спасибо за статью! Буду пробовать.
Пожалуйста!
Здравствуйте, не могу разобраться в TOC с тем, как проставлять свои альтернативные заголовки вместо автоматических. Инструкция крайне путанная. Можете показать пример с конкретной схемой?
Денис, я написал дополнение в статье. Всё ли вам стало понятно?
Спасибо, Михаил. Попробую открыть пункт 14-для продвинутых 🙂 и кое-что изменить для себя.
Пожалуйста, Лидия!
Приветствую вновь участников обсуждения! Подскажите как в TOC выводить последним пунктом в списке подзаголовков ссылку на комментарии? В частности именно запись, например, "13 комментариев" — https://prntscr.com/fv2vbo
Пытался делать этот текст в <h2> и пихать комменты перед закрывающимся тегом </article> TOC все равно не воспринимает его.
В строке post-meta под заголовком статьи есть такая ссылка. Честно говоря, не пойму, зачем её в ТОС вставлять? Лишние ссылки на странице, не есть хорошо. А то, что показано на скрине, находится в файле: comments.php
<h4 id="comments"><span><?php comments_number(__('Комментариев нет', TEMPLATE_DOMAIN), __('1 комментарий', TEMPLATE_DOMAIN), __('% Комментариев', TEMPLATE_DOMAIN)); ?></span></h4>
В моей теме так, в других, возможно, чуть иначе, но принцип один для большинства тем/шаблонов.
Хочется, чтобы в оглавлении было видно, что есть обсуждение ))
У меня это выглядит так:
Но даже, когда я делаю
Не выводится "Обсуждение" в TOC. Перемещал этот код перед закрывающим /article, все равно не получилось..((
Просто так ссылку на комментарии в ТОС не вставить. Дело в том, что плагин берёт только текст статьи, остальное ему пофиг… А комментарии к тексту статьи не относятся…
Но, наверное, можно сделать так — в самой статье приписать эту ссылку, обрамив её тегами заголовков, которые указаны в настройках ТОС, тогда плагин включит это в оглавление… Но число комментариев не укажешь таким образом — это динамически меняющаяся величина… И при клике на соответствующий пункт оглавления переход будет не к комментам, а конкретно к этому заголовку… Игра не стоит свеч…
Я тоже такого мнения об этой затее. Под заголовком статьи размещена строка мета-данных и сразу, ещё до оглавления, видно, что статья обсуждается. Просто у меня на сайте в этой строке уменьшен шрифт, но кому надо, увидят то что их интересует.
Добрый день. Подскажите, как установить точку после цифры в TOC?
Видимо, где-то здесь? table-of-contents-plus/toc.php
Да, в этом файле вот здесь:
[// list item
if ( in_array($matches[$i][2], $this->options['heading_levels']) ) {
$html .= '<a href="#' . $this->url_anchor_target( $matches[$i][0] ) . '">';
if ( $this->options['ordered_list'] ) {
// attach leading numbers when lower in hierarchy
$html .= '<span class="toc_number toc_depth_' . ($current_depth — $numbered_items_min + 1) . '">';
for ($j = $numbered_items_min; $j < $current_depth; $j++) {
$number = ($numbered_items[$j]) ? $numbered_items[$j] : 0;
$html .= $number . '.';
}
$html .= ($numbered_items[$current_depth] + 1) . '.</span> ';]
Я поставил точку перед закрывающим тегом </span> между верхней одиночной кавычкой и скобкой.
Работает, отлично, спасибо!
Михаил, приветствую! Спасибо за информационную статью. В закладки!
Вопрос , к тебе, как знающему https://prntscr.com/e8sat2 (скрин проблемы) Выводятся точки списка с накладкой то на цифры то на первую букву, если цифры отключаю. Подскажи, пожалуйста, что поправить коде плагина, что бы он этого не делал.
Спасибо!
Привет, Владимир!
А как ты цифры отключаешь? Я что-то в этой статье такой настройки не нашёл. Вообщем, пройди сейчас на мой другой сайт: https://www.sadvin.ru/ и посмотри как там у меня отображаются цифры неред заголовками/ссылками — они в данный момент без точек после цифры. Плагин на этом сайте без изменений. У тебя так же отображается меню после установки плагина? А потом я тебе покажу где поставить точку в коде плагина.
Извините, что вмешиваюсь… Владимир, у Вас в стилях это прописано. Надо там корректировать…
Жаль, Миша тут вставку кода не активировал, но выглядит это примерно так:
Вот этот самый before надо либо убрать, либо изменить… Точка, которая Вас смущает именно тут прописана…
Привет, Саш!
Да нет, он активировал в редакторе маркированный или нумерованный списки, в предыдущей статье я об этой настройке говорил при установке якорей вручную. Поэтому у него кракозябры и стали получаться. Я так понял.
А, я понял, ты всё делал по предыдущей статье. Так там показана ручная установка якорей. А потом в конце статьи я упомянул об этом плагине и никаких цифр или точек в визуальном редакторе вордпресса делать не нужно. Написал статью, заголовки обозначил h2;h3…, опубликовал и забыл. Содержание автоматически устанавливается на своё место.
Вот за это мои благодарности! На всех контентниках его использую.
Пожалуйста, Nata!
Очень хороший плагин. Пользуюсь и уже настолько привык к нему, что иногда кажется = ну как можно статью без оглавления выпускать в свет?
Аналогично! Еле нашёл в php место куда точку вставить после нумерации. Но нашёл, поставил и рамку с боков убрал…Вообщем, полазил немного в кодах, под свой вкус изменил немного. Очень полезный плагин.
Я тоже как-то копался в php плагина, фон менял под дизайн своего блога. Было красиво, но недолго. Вышло бновление плагина и… Как всегда. После чего плюнул на это дело…
Саш, ну, не мне тебя учить — стили можно и в таблицу сайта поместить, думаю строчку, где установил недостающую точку в нумерации, также можно перенести отдельно от плагина. Или я не прав? 🙂