Как использовать хуки WooCommerce для создания и изменения вкладок с данными продукта

Проблема: необходимость добавить или изменить вкладки с информацией о продукте в WooCommerce

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

Диагностика: как проверить текущие вкладки и их хуки

Для начала важно понять, какие хуки отвечают за вывод вкладок. Основной фильтр — woocommerce_product_tabs, который возвращает массив вкладок. Чтобы увидеть текущие вкладки, добавьте временный код в functions.php вашей темы:

add_filter('woocommerce_product_tabs', function($tabs) {
    error_log(print_r($tabs, true));
    return $tabs;
});

После обновления страницы товара проверьте лог ошибок сервера: там будет массив с ключами вкладок и их свойствами (title, callback, priority).

Пошаговое решение: добавление новой вкладки с кастомным контентом

Чтобы добавить вкладку, нужно расширить массив $tabs и указать заголовок, приоритет и функцию для вывода содержимого.

add_filter('woocommerce_product_tabs', 'wplite_add_custom_product_tab');
function wplite_add_custom_product_tab($tabs) {
    $tabs['custom_tab'] = array(
        'title'    => __('Характеристики', 'woocommerce'),
        'priority' => 50,
        'callback' => 'wplite_custom_product_tab_content'
    );
    return $tabs;
}

function wplite_custom_product_tab_content() {
    echo '<h2>Дополнительные характеристики продукта</h2>';
    echo '<p>Здесь можно вывести любые данные, например, из метаполей.</p>';
}

Этот код добавит новую вкладку с заголовком "Характеристики" после стандартных вкладок.

Изменение существующей вкладки "Описание"

Чтобы изменить содержимое вкладки "Описание", можно заменить callback этой вкладки:

add_filter('woocommerce_product_tabs', 'wplite_modify_description_tab');
function wplite_modify_description_tab($tabs) {
    if (isset($tabs['description'])) {
        $tabs['description']['callback'] = 'wplite_custom_description_tab_content';
    }
    return $tabs;
}

function wplite_custom_description_tab_content() {
    echo '<h2>Мое описание продукта</h2>';
    the_content(); // Стандартное содержимое описания
    echo '<p>Добавлено дополнительное описание через код.</p>';
}

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

Обновите страницу товара и посмотрите вкладки. Новая вкладка должна появиться с вашим контентом. Изменённая вкладка "Описание" покажет ваш дополнительный текст вместе со стандартным описанием. Если вкладки не отображаются, проверьте:

• Правильность добавления кода в functions.php или в отдельный плагин.
• Не конфликтуют ли другие плагины с фильтром woocommerce_product_tabs.
• Ошибки PHP через error_log или в консоли браузера.

Частые ошибки и их решения

• Вкладки не появляются или показываются пустыми. Проверьте, что callback функции выводят HTML через echo, а не возвращают строки.
• Фильтр woocommerce_product_tabs перезаписывается другими плагинами. Установите приоритет фильтра выше (например, 99) или используйте дополнительные хуки для обхода.
• Код добавлен в неправильное место. Поместите код в functions.php активной дочерней темы или создайте мини-плагин.
• Ошибки синтаксиса PHP. Используйте редактор с подсветкой синтаксиса, проверяйте код перед загрузкой.

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

• Не загружайте большие объемы данных в вкладках напрямую — используйте AJAX для динамического подгружаемого контента.
• Соблюдайте стандарты безопасности: экранируйте вывод функциями esc_html() или wp_kses_post() при выводе пользовательских данных.
• Кешируйте результаты запросов к базе данных, если данные вкладок сложные.
• Тестируйте изменения на копии сайта, чтобы избежать простоев.

Сравнение способов добавления вкладок: плагин vs код