WooCommerce: не сохраняется пользовательский атрибут товара (SKU) — решение

Диагностика проблемы: почему не сохраняется пользовательский атрибут SKU

При добавлении или редактировании товаров в WooCommerce иногда возникает ситуация, когда пользовательский атрибут, например, SKU (артикул), не сохраняется или сбрасывается после обновления товара. Это частая проблема при использовании кастомных метаполей или нестандартных способов добавления атрибутов.

Основные причины:

• Неправильное использование хуков для сохранения данных;
• Отсутствие валидации и фильтрации данных перед сохранением;
• Конфликты с другими плагинами, которые переопределяют или очищают метаданные;
• Ошибки в коде, отвечающем за сохранение пользовательских атрибутов;
• Несоответствие формата данных стандартам WooCommerce для SKU.

Пошаговое решение: как правильно сохранить пользовательский атрибут SKU

1. Добавление пользовательского поля SKU в страницу редактирования товара

Используем хук woocommerce_product_options_sku для добавления нового поля в метабокс SKU:

add_action('woocommerce_product_options_sku', 'add_custom_sku_field');
function add_custom_sku_field() {
    woocommerce_wp_text_input( array(
        'id' => '_custom_sku',
        'label' => __('Custom SKU', 'woocommerce'),
        'description' => __('Введите уникальный артикул для товара.', 'woocommerce'),
        'desc_tip' => true,
    ) );
}

2. Сохранение значения пользовательского поля при сохранении товара

Используем хук woocommerce_process_product_meta, чтобы сохранить значение из поля:

add_action('woocommerce_process_product_meta', 'save_custom_sku_field');
function save_custom_sku_field($post_id) {
    if (isset($_POST['_custom_sku'])) {
        $custom_sku = sanitize_text_field($_POST['_custom_sku']);
        update_post_meta($post_id, '_custom_sku', $custom_sku);
    }
}

3. Подключение пользовательского SKU к стандартному полю WooCommerce

Если вы хотите, чтобы пользовательский SKU использовался как основной, можно переписать стандартное значение SKU, чтобы WooCommerce отображал и работал с вашим значением:

add_filter('woocommerce_product_get_sku', 'replace_sku_with_custom', 10, 2);
function replace_sku_with_custom($sku, $product) {
    $custom_sku = get_post_meta($product->get_id(), '_custom_sku', true);
    if (!empty($custom_sku)) {
        return $custom_sku;
    }
    return $sku;
}

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

Чтобы убедиться, что пользовательский атрибут SKU сохраняется и отображается корректно, выполните следующие шаги:

1. Откройте страницу редактирования товара в админке WooCommerce.
2. Введите значение в поле «Custom SKU» и сохраните товар.
3. Обновите страницу и проверьте, что значение осталось сохранённым.
4. Перейдите на страницу товара на фронтенде, если SKU выводится в шаблоне — проверьте отображение.
5. Выполните var_dump($product->get_sku()); в шаблоне, чтобы проверить, что метод возвращает пользовательский артикул.

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

• Проблема: Значение не сохраняется после обновления.
  Причина: Неправильный ID поля или отсутствие проверки isset($_POST['field']).
  Решение: Используйте точные ID и проверяйте наличие данных перед сохранением.
• Проблема: Конфликт плагинов, из-за которого SKU сбрасывается.
  Причина: Другие плагины могут очищать метаданные или переопределять SKU.
  Решение: Временно отключите плагины, чтобы выявить конфликт, и добавьте приоритеты или условия для хуков.
• Проблема: Пользовательский SKU не отображается на фронтенде.
  Причина: Шаблон темы не выводит кастомный SKU.
  Решение: Используйте фильтр woocommerce_product_get_sku или отредактируйте шаблон для вывода метаполя.

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

• Всегда используйте функции sanitize_text_field() и esc_html() при сохранении и выводе данных, чтобы избежать XSS-уязвимостей.
• Не храните чувствительные данные в произвольных метаполях без шифрования.
• Для массового обновления SKU используйте WP CLI или пакетные операции, чтобы избежать нагрузки на сервер.
• Кэшируйте часто используемые данные SKU, если они активно используются в запросах.

Сравнение способов добавления пользовательского SKU