Как отладить, почему YARPP не показывает похожие записи после переезда на новый хостинг

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

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

Что обычно ломается после миграции

YARPP опирается на данные из базы, на собственный индекс и на обычные WordPress-фильтры. После переезда чаще всего сбивается один из этих слоёв:

• плагин не может читать или обновлять свои таблицы;
• остался старый кэш объекта или кэш страницы;
• изменился префикс таблиц, а в базе остались ссылки на старую схему;
• на новом сервере другая версия MySQL/MariaDB, и запросы работают медленнее или с ошибками;
• тема или другой плагин отключает вывод похожих записей на уровне шаблона;
• после импорта не пересобрался индекс YARPP.

Диагностика проблемы: с чего начать

Сначала нужно понять, это проблема вывода или проблема данных. Если на странице записи блок YARPP отсутствует полностью, а в админке плагин включён, проверяйте шаблон и хуки. Если блок есть, но пустой, чаще виноваты индекс, кэш или ограничения в настройках релевантности.

Проверьте, не отключён ли вывод на уровне темы

После миграции часто меняют тему или child theme, и в шаблоне остаётся старый код. Ищите в single.php, content-single.php или в подключаемых шаблонах вызовы, которые могли быть удалены или обёрнуты в условия.

<?php if ( function_exists( 'yarpp_related' ) ) : ?>
    <?php yarpp_related(); ?>
<?php endif; ?>

Если такого вызова нет, плагин может быть активен, но на фронтенде ничего не покажет. Это особенно заметно после переноса на новую тему.

Проверьте логи и режим отладки

Если есть доступ к wp-config.php, временно включите логирование. Это не лечит проблему, но помогает увидеть ошибки запросов и предупреждения PHP.

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );

После этого откройте проблемную запись и посмотрите wp-content/debug.log. Ищите ошибки SQL, проблемы с памятью, недоступные таблицы или предупреждения о несовместимости плагина с текущей версией PHP.

Пошаговое решение после переезда

1. Очистите кэш на всех уровнях

Если на сайте есть page cache, object cache или серверный кэш, сначала сбросьте его. После миграции старые кэшированные HTML-страницы могут продолжать отдавать пустой блок, даже если YARPP уже работает.

• очистите кэш плагина;
• сбросьте Redis/Memcached, если он используется;
• очистите кэш CDN, если он стоит перед сайтом;
• обновите страницу в режиме инкогнито и без кэша браузера.

Если после очистки кэша блок появился, проблема была не в YARPP, а в слое доставки страницы.

2. Пересоберите индекс YARPP

После импорта базы или переноса файлов индекс похожих записей может быть неактуальным. В админке YARPP обычно есть действие для пересчёта или переиндексации. Если интерфейс плагина не даёт результата, проще всего временно отключить и снова включить плагин, а затем запустить пересборку из его настроек.

Если у вас есть доступ к WP-CLI, можно хотя бы проверить, что плагин активен и WordPress видит его корректно:

wp plugin status yet-another-related-posts-plugin

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

3. Сверьте префикс таблиц и целостность базы

При миграции иногда меняется $table_prefix в wp-config.php, а часть таблиц или записей остаётся привязана к старому префиксу. Проверьте, что в базе есть стандартные таблицы WordPress с новым префиксом и что сайт не смотрит в старую схему.

Если вы переносили сайт вручную, сравните содержимое wp-config.php на старом и новом сервере. Ошибка здесь может выглядеть как «всё работает, кроме одного плагина», хотя на деле плагин просто не видит нужные записи.

4. Сравните настройки релевантности и типы записей

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

Проверьте:

• какие типы записей участвуют в подборке;
• не исключены ли рубрики, теги или отдельные посты;
• не завышен ли порог релевантности;
• не отключён ли вывод для записей без минимума совпадений.

Если сайт небольшой, слишком строгие настройки могут полностью обнулить результаты. В таком случае лучше временно ослабить критерии и посмотреть, начнёт ли YARPP возвращать записи.

Сравнение подходов: что быстрее помогает

Проверка результата после внедрения

После каждого шага не ограничивайтесь главной страницей. Проверяйте конкретную запись, где раньше YARPP точно работал. Лучше взять:

• старую запись с большим числом тегов;
• запись из популярной рубрики;
• запись без минимума совпадений, чтобы увидеть, как плагин ведёт себя на границе настроек.

Что должно измениться:

• на странице появляется блок похожих записей;
• внутри блока есть не только заголовки, но и реальные релевантные посты;
• при обновлении страницы список не исчезает из-за кэша;
• в логах нет новых ошибок SQL или PHP.

Если блок появился только после очистки кэша, значит, на сервере нужно отдельно настроить TTL для страниц с динамическими рекомендациями. Если помогла переиндексация, стоит проверить, не запускается ли импорт контента или массовое обновление записей без последующего пересчёта индекса.

Частые ошибки и как их исправить

Плагин активен, но блока нет

Обычно это либо удалённый вызов в шаблоне, либо конфликт с темой. Проверьте, что функция вывода вызывается в нужном месте и не обёрнута в условие, которое не выполняется на сайте.

Показываются одни и те же записи

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

После переноса всё работало, а потом перестало

Частая причина — автоматическая очистка кэша, обновление PHP или установка другого плагина оптимизации. Особенно осторожно нужно относиться к плагинам, которые объединяют, откладывают или переписывают скрипты и стили: они иногда ломают вывод блоков, завязанных на AJAX или динамический рендер.

На новом хостинге YARPP работает медленно

Здесь уже вопрос производительности. Проверьте лимиты памяти PHP, версию MySQL/MariaDB и наличие object cache. Если сайт большой, лучше не оставлять слишком тяжёлые настройки релевантности без теста на нагрузку.

Практические советы по безопасности и производительности

Если вы уже лезете в миграцию и отладку, не ограничивайтесь только YARPP. После переноса полезно проверить, не остались ли лишние точки доступа и старые данные, которые мешают индексации и увеличивают нагрузку. Для технической чистки сайта и удаления дублей иногда удобнее использовать отдельный инструмент, например Clearfy Pro: https://wpshop.ru/plugins/clearfy.

• не держите включённым лишний debug на продакшене;
• после миграции проверьте права на файлы и доступ к wp-content;
• не ставьте одновременно несколько плагинов похожих записей;
• если используете кэш, исключите из него страницы, где критичен динамический блок рекомендаций;
• регулярно пересобирайте индекс после массового импорта или правки таксономий.

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