Содержание
Оно свершилось — перелинковка теперь доступна в новом редакторе Gutenberg. Без лишних слов сразу перейду к обновлению и обзору того, что в итоге получилось.
Список изменений в 2.0
В новой версии плагина CherryLink (выдержка из readme.txt):
- Добавлена поддержка Gutenberg (отдельная реализация написанная с нуля на react)
- Плагин CRB интегрирован в основной, старый плагин CherryLink Related Block можно безболезненно удалить, он больше не поддерживается
- Теперь в блоке ссылок можно менять анкоры, задать произвольный текст вместо стандартных title/h1
- Добавлены колонки с количеством входящих/исходящих ссылок в списке записей (как у йоаста)
- Поправлен импорт настроек (после импорта могли перестать отображаться ссылки в панели перелинковки)
- Исправлено много ошибок (…и наверняка появились новые:))
Отдельно повторюсь, что плагин CherryLink Related Block теперь входит в состав основного плагина CherryLink и отдельно поддерживаться/распространяться не будет. После обновления до 2.0 его можно просто удалить (или до обновления, без разницы, настройки все равно хранятся в основном).
Как выглядит CherryLink в новом редакторе
Панель полностью переписана с нуля и интегрирована в сайдбар редактора. Тут я старался особо не колхозить, чтобы все выглядело более-менее гармонично и в едином стиле.
Получилось или нет — решать вам, все таки приходилось рисовать некоторые свои UI элементы, а дизайнер из меня никакой, поэтому упор был сделан больше на функциональность.
Короче, панель открывается волшебной кнопкой с «вишнями» в правой части глобального тулбара:
Либо из меню:
Сама панель состоит из 4-х табов, наглядная иллюстрация ниже:
Внешний вид отличается от старой панели в классическом редакторе, но в целом очень похож, разобраться будет не сложно.
Основные отличия ниже.
Кнопки на самой ссылке появляются при наведении
так было:
так стало:
Расшифровка обозначений:
- вставить ссылку (клик по тексту тоже работает)
- найти подсказки (где-то ниже покажу как выглядит)
- добавить в /удалить из блока ссылок
- копировать ссылку *
- просмотр статьи (откроется в новой вкладке)
- отредактировать статью (откроется в новой вкладке)
- статистика по этой записи, сколько вход/исход ссылок
Кстати, если ссылка найдена в тексте, то она помечается красной чертой слева, как на скриншоте.
Статистика входящих и исходящих ссылок
Раньше она была во всплывающем окне и не интерактивна:
А теперь так:
Для нее есть отдельный таб. Причем в разделе с исходящими ссылками (это те, которые найдены в статье, которую вы редактируете в данный момент), анкор помечен красным цветом. Если кликнуть по нему, то он выделится в редакторе.
Быстрые фильтры
раньше были на виду в верхней части:
в классическом редакторе в выпадающем списке категорий нельзя выбрать несколько разных, тут без изменений
теперь они спрятаны в спойлер над ссылками, плюс теперь можно выбрать несколько рубрик чекбоксами:
Настройка блока ссылок
Данные настройки ранее были доступны только если вы приобрели отдельно плагин CherryLink Related Block. Они располагались в метабоксе:
В классическом редакторе расположение не изменилось, зато появилась возможность редактировать анкор к каждой ссылке.
А в гутенберге настройки расположены в последнем табе:
Тут можно включить/отключить вывод ссылок для данной записи, включить редактор анкоров, либо удалить ссылки из блока. Оригинальный заголовок видно в input полях, когда редактирование анкора выключено, либо при наведении на ID записи появляется всплывашка.
На всякий случай уточню один момент - блок ссылок сохраняет свое состояние в meta полях каждой записи. Если вы что-то изменили в нем, то эти изменения нужно сохранить (нажать снопку Сохранить/Обновить над статьей, либо дождаться автосохранения), иначе они будут утрачены. А так же не забывайте чистить кэш блока ссылок в настройках плагина, если хотите увидеть изменения сразу.
Подсказки анкоров
Вместо своего велосипеда теперь используется сторонняя библиотека, по-другому выглядят и результаты.
Жмем на лупу у ссылки:
Открывается панелька:
Как и в классическом редакторе присутствуют фразы (это некий интервал текста между двумя ключевыми словами) и отдельные слова.
При клике на фразу/слово будет выделен блок в редакторе, в котором она найдена.
Сверху присутствуют кнопки для быстрой вставки ссылки вокруг выделенного текста (но выделить его нужно самостоятельно в редакторе, т.к. подсветка =/= выделение) и кнопка, чтобы скопировать ссылку*.
Подсказки ищутся на основании стеммы ключевых слов (т.е. было например слово условия, у него убирается окончание, остается услов и в тексте ищутся различные вариации и словоформы).
К подсказкам применяются стоп-слова, заданные в настройках индекса ссылок, но это уже было и раньше.
В настройках можно отключить поиск отдельных слов, будут показаны только фразы.
Причие изменения
Выше упомянул, что так же добавлена статистика ссылок в списке записей:
Так же починил импорт настроек. Бывали случаи, что после импорта плагин переставал показывать ссылки.
Поправлены различные мелкие баги.
Нюансы
Имеющиеся API для разработки плагинов и интеграция панели перелинковки в Gutenberg очень сильно отличаются от классического редактора (TinyMCE), из чего вытекают сложности с портированием кода из старого редактора в новый.
Помимо затянувшихся сроков разработки имеются некоторые ограничения. Например, в гутенберге на текущий момент поддерживаются не все блоки.
При попытке вставить ссылку в неподдерживаемый блок вы увидите уведомление слева снизу. Отчасти эта проблема решаема — выше по тексту я писал про новую кнопку «Копировать ссылку*«, пометил ее звездочкой. Таким образом скопированную ссылку можно вставить штатными средствами редактора туда, где черилинк не справился.
На текущий момент поддерживаются блоки:
- Абзац (он же параграф)
- Цитата
- Заголовки
- Списки
- Подписи к изображениям (но только к отдельным, картинки внутри галереи не поддерживается)
- Подпись к галерее (только к блоку целиком, не к отдельным картинкам внутри нее)
- Блок «Выдержка»
- Подписи к аудиозаписям
- Стихи
- Блок «Форматированный»
Не поддерживаются:
- Таблицы — только штатными средствами редактора
- Частично галерея
- Любые произвольные блоки, созданные другими плагинами (тут как повезет, зависит от конкретной реализации)
- Блок «HTML»
- Блок «Классический» — для этого переключитесь в классический редактор, либо приобразуйте его в блоки гутенберга
- Прочие блоки без текста, элементы разметки, виджеты и вставки
Как обновиться
Как и прежде — обновление само прилетит в админку. Кроме того, плагин можно скачать на этой странице.