Исправление проблем с отображением affiliate ссылок в WooCommerce после обновления

Диагностика проблемы с отображением affiliate ссылок в WooCommerce

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

Для диагностики проблемы выполните следующие шаги:

• Проверьте консоль браузера на наличие JavaScript ошибок.
• Включите WP_DEBUG в wp-config.php и посмотрите на ошибки PHP.
• Отключите все плагины, кроме WooCommerce и плагина для affiliate ссылок, чтобы исключить конфликт.
• Переключитесь на дефолтную тему (например, Storefront) для проверки на тему.
• Проверьте, не изменились ли хуки и фильтры, используемые для вывода affiliate ссылок.

Почему проблема возникает после обновления WooCommerce

Обновления WooCommerce нередко меняют структуру шаблонов, хуков и фильтров. Если ваш affiliate плагин или кастомный код использует устаревшие хуки, вывод может перестать работать. Также изменяется поведение фильтров, влияющих на отображение кнопок и ссылок.

Например, в WooCommerce 7.0 и выше изменился хук woocommerce_single_product_summary, и некоторые приоритеты обработки были изменены.

Пошаговое решение: адаптация affiliate ссылок под новую версию WooCommerce

1. Обновите вызовы хуков и фильтров

Проверьте, используете ли вы хук woocommerce_after_add_to_cart_button или woocommerce_single_product_summary для вывода affiliate ссылки. В новых версиях WooCommerce рекомендуем использовать хук woocommerce_single_product_summary с приоритетом 35.

add_action('woocommerce_single_product_summary', 'custom_affiliate_link_output', 35); 
function custom_affiliate_link_output() { 
    global $product;
    if ($product->is_type('external')) { 
        echo '<a href="' . esc_url($product->get_product_url()) . '" class="button affiliate-button" target="_blank" rel="nofollow noopener">Перейти к партнеру</a>'; 
    }
}

2. Очистите кэш и обновите шаблоны

Если вы используете кэширование (например, через WP Rocket, LiteSpeed Cache или серверное), очистите весь кэш сайта после внесения изменений.

При кастомных шаблонах WooCommerce (в папке woocommerce/single-product вашей темы) убедитесь, что шаблоны обновлены и соответствуют версии WooCommerce.

3. Используйте фильтр для исправления ссылок

В некоторых случаях URL партнерской ссылки может не подтягиваться корректно. Используйте фильтр woocommerce_product_get_product_url для принудительной замены ссылки:

add_filter('woocommerce_product_get_product_url', 'fix_affiliate_link_url', 10, 2);
function fix_affiliate_link_url($url, $product) {
    if ($product->is_type('external')) {
        $affiliate_url = get_post_meta($product->get_id(), '_affiliate_url', true);
        if ($affiliate_url) {
            return esc_url_raw($affiliate_url);
        }
    }
    return $url;
}

Проверка результата

После внесения изменений проверьте на тестовом товаре с типом «Внешний продукт»:

• Отображается ли кнопка «Перейти к партнеру» с правильной ссылкой?
• Открывается ли ссылка в новой вкладке с атрибутами rel="nofollow noopener"?
• Нет ли ошибок в консоли браузера?
• Если есть кэш, очистите его и повторите проверку.

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

• Кнопка не отображается: вероятно, неправильно указан хук или приоритет. Проверьте, что используете актуальный хук woocommerce_single_product_summary с приоритетом 35.
• Ссылка ведет на неправильный URL: убедитесь, что метаполе _affiliate_url заполнено и фильтр woocommerce_product_get_product_url подключен.
• Кнопка отображается, но не работает: проверьте консоль браузера на JS-ошибки и отключите конфликтующие плагины.
• Кэш не обновляется: очистите кэш плагина и браузера, отключите кэширование на время проверки.

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

• Для ссылок используйте rel="nofollow noopener noreferrer" и открывайте в новой вкладке, чтобы снизить риски и улучшить SEO.
• Кэшируйте вывод affiliate ссылок с помощью transient API, если ссылки формируются динамически, чтобы уменьшить нагрузку.
• Регулярно обновляйте WooCommerce и плагины, следите за совместимостью кастомных решений.
• Используйте Clearfy Pro для автоматического удаления дублей и оптимизации базы данных, что повысит скорость загрузки страниц с affiliate ссылками (https://wpshop.ru/plugins/clearfy?utm_source=wpaffiliate.ru&utm_medium=article&utm_campaign=ispavlenie-problem-s-otobrazheniem-affiliate-ssylok-v-woocommerce-posle-obnovleniya).

Сравнение вариантов решения проблемы