Данное руководство пополняется по мере обновления плагина и добавления в него нового функционала. Постепенно обновляется для текущей версии плагина 2.1+ (14.12.2020).

Описание и обзор плагина: CherryLink — плагин внутренней перелинковки для WP

Установка описана в отдельной статье по ссылке:  Установка плагина CherryLink.

Использование

Начнем это руководство с новых возможностей, которые добавляет плагин при редактировании статьи. Далее, перейдем к подробной настройке параметров CherryLink.

Панель перелинковки в редакторе

Это ваш основной инструмент, с помощью которого и добавляются ссылки в статью.

На странице создания/редактирования записи или страницы появляется дополнительная кнопка над редактором с надписью «Перелинковка» в классическом редакторе; либо кнопка с иконкой вишни справа сверху в Гутенберге (новый редактор).

Нажатие на кнопку открывает панель перелинковки. Вид панели в обоих редакторах рассмотрим отдельно.

Классический редактор

Где:

  1. Быстрые фильтры ссылок
  2. Вкладки: Записи (релевантные ссылки на записи) и Таксономии (ссылки на рубрики, метки, пр.)
  3. Быстрый фильтр по категориям
  4. Список релевантных ссылок

Редактор Gutenberg

Где:

  1. вкладки слева направо: Релевантные ссылки, Рубрики и метки, Статистика (вх/исх), Блок ссылок
  2. Спойлер с быстрыми фильтрами ссылок
  3. Список релевантных ссылок

Под спойлером с быстрыми фильтрами скрыто:

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

Различия между редакторами чисто визуальные, по функциям они практически идентичны.

Как вставить ссылку в текст?

Плагин CherryLink не вставляет ссылки автоматически, он предназначен для упрощения ручной перелинковки. Порядок действия для вставки ссылки в текст следующий:

  1. нужно выделить слово/фразу в поле редактора, которая будет анкором ссылки,
  2. выбрать ссылку на подходящую статью (или категорию…) из панели перелинковки,
  3. нажать на ссылку в панели перелинковки.

В результате получаем: в тексте появляется ссылка на желаемую статью с анкором, который вы выделили ранее. В панели перелинковки эта ссылка окрасится в серый цвет (в Гутенберге появится красная черта слева), что будет означать, что она присутствует в тексте.

Примечание: Плагин распознает комбинацию CTRL+Click, то есть, при зажатом CTRL (или CMD), клик по ссылке вставит в текст ссылку с анкором, содержащим тайтл записи. В этом случае используется альтернативный шаблон ссылки (см. секцию про настройки плагина).

Перелинковка в рубриках и метках

Поддержка в Gutenberg отсуствует и не будет добавлена. В классическом редакторе она пока существует, но в последствии поддерживаться не будет.
Плагин работает не только в статьях и записях ( а так же в кастомных типах записей), но и при редактировании рубрик, начиная с версии 1.2.0. Для этого нужен включенный визуальный редактор. «Из коробки» поле описания в рубриках не имеет визуального редактора, его можно включить дополнительными плагинами, например: Yoast SEO, F-Cattxt, Sp-category и другими.

Если у вас установлен F-cattxt, который добавляет два дополнительных поля для ввода описания, то CherryLink учтет весь текст из этих полей при подборе релевантных статей и позволит ставить ссылки в любое из них.

Быстрый переход к вставленной ссылке

В классическом редакторе

К любой вставленной ссылке (серые) можно быстро перейти, если нажать на нее в панели перелинковки. По умолчанию, в настройках стоит запрет на повторную вставку одной и той же ссылки, поэтому они перечеркиваются в панели перелинковки.

Клики по таким ссылкам переместят вас в нужное место в редакторе и выделят ссылку для ее быстрого редактирования или удаления.

В Гутенберге

Перейдите во вкладку со статистикой:

Раздел с исходящими ссылками — это все ссылки, которые найдены в текущей статье, которую вы редактируете. Красным цветом обозначены анкоры. Кликните на любой анкор и вы перейдете к этой ссылке в редакторе.

Дополнительные элементы

У каждой ссылки есть дополнительные элементы вокруг, которые упрощают редактирование и навигацию.

В классическом редакторе

Цифрами на скриншоте обозначено:

  1. Сколько раз эта ссылка найдена в тексте (при клике переместит к ней в редакторе) *
  2. Просмотр статьи, на которую ведет ссылка (откроется в новой вкладке)
  3. Добавление ссылки в блок ссылок (об этом ниже)
  4. Количество входящих ссылок на статью
  5. Количество исходящих ссылок из статьи
  6. Подсказки анкоров (плагин ищет в тексте подходящие слова и словосочетания для этой ссылки)

* Клик по этой цифре перекинет вас к ней в тексте. Это сделано на случай, если в настройках плагина выключено ограничение на вставку нескольких одинаковых ссылок в текст (в этом случае, клик на саму ссылку будет вставлять добавлять ее в статью, а не перемещать к ней).

В Гутенберге

При наведении курсора на ссылку вы увидите такую картину:

По пунктам:

  1. Вставить ссылку в текст
  2. Найти подсказки анкоров
  3. Добавить в/убрать из блока ссылок
  4. Скопировать ссылку
  5. Просмотр статьи, на которую ведет ссылка (откроется в новой вкладке)
  6. Перейти сразу в редактор статья, на которую ведет ссылка (откроется в новой вкладке)
  7. Количество исходящих ссылок из статьи
  8. Количество входящих ссылок на статью

Здесь нет количества повторов ссылки, как в классическом редакторе и быстрого перехода к ней. Этот функционал вынесен в отдельную вкладку со статистикой, которую мы рассмотрели выше.

Вкладка «Таксономии» или «Рубрики»

На этой вкладке выводится список всех категорий, меток и других произвольных таксономий вашего сайта. Они выводятся по разделам, учитывается иерархия и показано количество принадлежащих им записей (число справа, только в классическом редакторе), но без учета релевантности. В текст данные ссылки вставляются точно так же, как и ссылки на записи.

Так выглядит в классическом редакторе:

 

А это в Гутенберге:

Подсказки анкоров

Начиная с версии 1.3, CherryLink умеет находить анкоры для релевантных ссылок. Для этого берутся слова из заголовка, тайтла и текста статьи по ссылке и ищутся в текущем тексте, который вы редактируете.

Поиск не точный, т.е. могут учитываться словоформы (кричал — кричала — кричать). Плагин предлагает как одиночные анкоры, так и целые фразы, если они найдены в тексте.

У каждой ссылки есть иконка лупы, при нажатии на нее включается панель подсказок.

Так она выглядит в классическом редакторе:

У каждой подсказки имеются дополнительные кнопки для ее поиска в тексте, быстрой вставки ссылки, а также, справа в процентах обозначено примерное положение анкора в тексте (начало — 0%, конец — 100%).

А это гутенберг:

Все найденные подсказки подсвечиваются желтым маркером в тексте. Клик по подзказке в панели перелинковки активирует переход к ней в тексте и выделение. Для вставки ссылки можно использовать кнопку «Вставить ссылку» над подсказками.

Настройки

Настройки плагина расположены в админке WP (Настройки — CherryLink).

Настройки вывода

На вкладке «Шаблон ссылок» сначала настраивается вид ссылки в панели перелинковки.

Есть доступные теги:

  • {title} — заголовок записи H1;
  • {title_seo} — тайтл, который берется из плагинов AIO SEO или Yoast, если задан (если не найден, вставится {title} автоматом);
  • {url} — ссылка на запись;
  • {categorynames} — рубрики, к которым пренадлежит запись;
  • {date} — дата публикации;
  • {author} — кто опубликовал;
  • {postid} — идентификатор записи;
  • {imagesrc} — выдергивает ссылку на первую (превью) картинку из статьи (с версии 1.2.0);
  • {anons} — показывает вступительный текст статьи (с версии 1.2.0).

Любой из этих тегов можно добавить в поле «Содержание ссылки в списке«.

Поле «Длина анонса» ограничивает количество символов для тега {anons}, с помощью которого можно вывести часть текста статьи. Данный тег можно использовать в шаблонах вставки ссылки в текст, о чем ниже.

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

Далее есть селектор, где можно выбрать текст-заглушку, если в поле редактора ничего не выделено. В качестве анкора могут быть подставлены: заголовок, тайтл, плейсхолдер (ТЕКСТ_ССЫЛКИ) или пробел (именно пробел, а не пустое поле, иначе визуальный редактор не позволит вставить ссылку).

Далее идут поля шаблона вставки непосредственно в запись. Идея такая: вы выделяете слово или фразу в тексте, жмете на ссылку в панели перелинковки, и вокруг выделенного текста вставляется произвольный HTML код, как на скриншоте ниже:

Сейчас на скриншоте показан шаблон по умолчанию, когда текст обрамляется тегом <a> со ссылкой на запись и тайтлом (всплывающей подсказкой при наведении). Обратите внимание, что здесь 2 набора полей: первый для настройки шаблона ссылки на записи, а второй — для рубрик и таксономий. Для рубрик доступны лишь два тега: {url} и {title}.

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

Перед ссылкой:

[shortcode]<a href='{url}'><img src='{imagesrc}' alt='{title}'/>{anons}

После ссылки: 

</a>[/shortcode]

Где [shortcode] — это может быть какой-нибудь плагин блоков внимания, а конструкция внутри него — превью картинка с кратким анонсом статьи, заключенная в ссылку тегом <a>.  Ничто не мешает задать любые css стили или классы для каждого из элементов на ваше усмотрение.

Другой пример: чтобы ссылка открывалась в новой вкладке, нужно указать параметр target=»_blank» следующим образом:


Например, в шаблоне перед ссылкой:

<a href="{url}" target="_blank">

В последних версиях добавлено дополнительное поле «Альтернативный шаблон», который вставляется в текст при нажатой комбинации CMD/CTRL+Click.

Фильтр записей

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

Перечислим только те, что требуют пояснения:

  • количество ссылок — сколько максимум будет показано в панели перелинковки (с версии 1.4 подгружаются динамически и при нажатии на «загрузить еще» внизу списка; если статей слишком много, а ПК слабый, то разумно ограничить это число, чтобы избежать тормозов в редакторе;
  • ссылки на страницы и записи — тут можно выбрать, показывать лишь записи, либо только страницы, либо и то и другое;
  • если используются кастомные типы записей, то можно выбрать какие отображать в таблице.

Далее идут расширенные настройки (не влезло на скриншоте) с выбором рубрик, авторов, меток и способов сортировки. Поля сортировки могут быть полезны, если, например, вместо релевантности статей больше интересна их дата публикации. Тогда в условие можно вставить тег {date} и установить порядок (по возрастанию или по убыванию). С версии 1.4, поиск релевантных статей можно отключить и выводить все подряд (см. раздел Релевантность).

Настройки подсказок

В версии 1.3 появились подсказки анкоров для релевантных ссылок. Часть настроек находится в разделе «Подсказки», здесь настраивается поведение панели подсказок в редакторе записи.

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

Релевантность ссылок

В разделе «Релевантность» есть следующие поля:

  1. Игнорировать релевантность — вывести все статьи подряд, не обращая внимание на их схожесть. Может быть полезно при собственных настройках сортировки или для быстрого поиска сразу по всем статьям на сайте.
  2. Значимость полей — определяет что важнее для вас при поиске схожих статей. 3 поля (заголовок, текст, теги) могут принимать значение от 0 до 100%, но общая сумма всех не должна превышать 100%.
  3. Количество ключевых слов для определения схожести — важный пункт. Алгоритм всегда сравнивает статьи по наиболее частотным словам. Если вам кажется, что нашлись не все релевантные статьи, то можно увеличить это значение, чтобы алгоритм учитывал более широкий набор слов.
  4. Одностороннее сравнение с тайтлом — если вас больше интересуют тайтлы статей (или заголовки), то пункт может быть полезен. Принцип работы:

    Есть статья А с текстом (текст_А) и тайтлом (тайтл_А), которую вы редактируете в данный момент. Вы хотите найти все похожие статьи N, где есть общие слова между текст_А+тайтл_А и тайтл_N. Другими словами, текст статей N не будет учитываться алгоритмом.

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

Индекс ссылок

Плагин создает дополнительную таблицу в БД _linkate_posts, где хранятся очищенные данные всех индексируемых записей. В частности: текст записей, заголовки, теги и анкоры для подсказок.

  • Галочка Seo Title или H1позволит учитывать тайтл из плагинов AIO Seo или Yoast. Это полезно потому, что сео заголовок содержит больше ключевых слов и меньше разбавочного мусора, чем Н1 (но, это не точно :)).
  • Применить стоп-слова к анкорам (подсказкам) — чистит предполагаемые подсказки от стоп слов, если необходимо.
  • Доноры подсказок — определяет, какие слова будет искать плагин. Можно выбрать только тайтл, только Н1, объединение или пересечение данных полей. Конечно, тайтл будет учитываться, если он задан в СЕО плагинах.

Теперь о стоп-словах. Если ваш сайт, например, о собаках, то производные этого слова будут встречаться во всех статьях. Как следствие, алгоритм посчитает статьи «Лучший корм для собак» и «Дрессировка собак в домашних условиях» (названия придуманы для примера) релевантными, потому что обе статьи будут содержать слово «собака». Конечно, такие ссылки будут далеко не вверху списка в панели перелинковки, но общую картину могут немного замусорить.

Стоп-слова нужны для того, чтобы улучшить точность алгоритма, убрав общие термины ( в нашем случае, вы можете вписать в поле «собака», «собаку», «собак», «собаке» и т.п.). Необходимо вписывать все словоформы (с разными окончаниями, префиксами, суффиксами…).

Поле «Не учитывать слова короче N символов» позволяет отсечь сразу все предлоги, союзы и короткие слова. Кроме того, в плагин уже зашит большой список популярных наречий, прилагательных и прочих слов, которые часто встречаются в русском языке и не зависят от темы статей (можете его посмотреть в папке с плагином CherryLink/stopwords.php).

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

Экспорт статистики

С версии 1.4 был добавлен экспорт всех ссылок из статей в файл CSV, который можно импортировать в Excel.

Подробнее по ссылке.

Лицензия, экспорт настроек и прочее

Последняя вкладка «Разное» содержит поля для ввода лицензионного ключа, экспорта/импорта настроек плагина и кнопку сброса.

После установки CherryLink на новом сайте достаточно лишь скопировать настройки со старого сайта и вставить на новом, и нажать кнопку «Импортировать».

Если возникла проблема, или хотите вернуться к заводским установкам — жмите на кнопку «Сбросить настройки».

Решение проблем

Индекс не создан

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

Нажмите на кнопку Создать индекс и дождитесь окончания процесса.

Прочее

Преход с версии 1.2.01: В данной версии изменился адрес репозитория для обновлений, и из-за особенностей WP следующая версия отображается не сразу, а через несколько часов. Если вы только что обновились до 1.2.01, то нужно подождать, пока WP обнаружит новую версию.

Дублируются ссылки в панели перелинковки: Если плагин показывает несколько одинаковых ссылок в панели перелинковки в редакторе статьи, нужно сделать реиндексацию всех ссылок (Настройки-CherryLink-Индекс ссылок-Пересоздать индекс).

Плагин протестирован на WP версии 4.6+ и PHP 5.6+, но возможны индивидуальные конфликты с другими плагинами и темами. Эта проблема решается очередным обновлением — пишите в телеграм или на почту, будем разбираться.

Мои контакты присутствуют в сайдбаре сайта.

Добавить комментарий

Ваш адрес email не будет опубликован.

Этот сайт использует Akismet для борьбы со спамом. Узнайте, как обрабатываются ваши данные комментариев.