Данное руководство пополняется по мере обновления плагина и добавления в него нового функционала. Обновлено для версии 1.4.0+.

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

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

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

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

Изменения в редакторе

На странице создания/редактирования записи или страницы появляется дополнительная кнопка над редактором с надписью «Перелинковка» (1), нажатие на которую открывает панель перелинковки (2). Эти элементы показаны на Рис. 1.

Рис. 1 Интерфейс редактора

Панель перелинковки содержит (сверху-вниз):

  • тулбар для фильтрации ссылок с помощью чекбоксов (с надписью LINK) и поля для ввода слова для поиска по заголовкам; чекбоксы позволяют показать или скрыть ссылки которые уже вставлены в текст (серые перечеркнутые) и не вставленные (красные, неперечеркнутые); поле «Фильтр» позволяет ввести слово или фразу для мгновенного поиска среди всех найденных ссылок;
  • вкладки «Записи» и «Таксономии» содержат релевантные ссылки на записи или страницы и список всех категорий, меток и пр. соответственно;
  • поле со списком ссылок — основная область, в ней показаны предлагаемые для перелинковки ссылки; алгоритм для их поиска и дополнительные возможности фильтрации будут рассмотрены ниже в разделе с натройками плагина;
  • в самом низу находится панель статуса, на которой выводится общее количество вставленных в текст ссылок (без учета документов и медиафайлов).

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

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

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

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

Примечание: выделять анкор в тексте не обязательно, достаточно просто установить курсор в нужное место и вместо анкора будет вставлен плейсхолдер (ТЕКСТ_ССЫЛКИ). Также, плагин распознает комбинацию CTRL+Click, то есть, при зажатом CTRL, клик по ссылке вставит в текст ссылку с анкором, содержащим тайтл ссылки. Другими словами, если мы хотим вставить ссылку на статью «Установка плагина CherryLink» (см. в панели перелинковки, первый в списке на Рис. 1) и использовать тайтл как анкор, то достаточно поставить курсор в нужное место в тексте статьи и нажать на ссылку с зажатой клавишей CTRL.

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

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

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

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

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

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

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

Рис. 2 Релевантные ссылки

Слева от каждой ссылки присутствуют два дополнительных элемента:

  1. количество повторов ссылки в тексте,
  2. быстрый переход к статье.

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

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

Вкладка «Таксономии»

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

 

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

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

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

Настройки

Настройки плагина расположены в админке 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+, но возможны индивидуальные конфликты с другими плагинами и темами. Эта проблема решается очередным обновлением — пишите в телеграм или на почту, будем разбираться.

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

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

Ваш e-mail не будет опубликован. Обязательные поля помечены *