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

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

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

Типичные симптомы:

• Пользователь видит заказы других ролей.
• Заказы не отображаются вообще.
• Ошибка типа "недопустимый аргумент" или "неправильный SQL-запрос".
• Производительность страницы заказов сильно падает.

Пошаговое решение: фильтрация списка заказов для ролей пользователей

1. Определяем роль пользователя

Сначала получаем текущего пользователя и проверяем его роль. Это позволяет фильтровать заказы по назначению.

function get_current_user_role() {
    if (!is_user_logged_in()) {
        return false;
    }
    $user = wp_get_current_user();
    if (empty($user->roles)) {
        return false;
    }
    return $user->roles[0]; // берем первую роль
}

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

Для изменения списка заказов в админке WooCommerce используется фильтр pre_get_posts. Важно проверить, что мы находимся именно в нужном разделе и подгружаем правильный запрос.

add_action('pre_get_posts', 'filter_orders_by_user_role');
function filter_orders_by_user_role($query) {
    if (!is_admin() || !$query->is_main_query()) {
        return;
    }
    global $pagenow;
    if ($pagenow !== 'edit.php' || $query->get('post_type') !== 'shop_order') {
        return;
    }

    $role = get_current_user_role();
    if (!$role) {
        return;
    }

    // Пример: для роли 'shop_manager' показываем все заказы, для 'customer' только свои
    if ($role === 'customer') {
        $current_user_id = get_current_user_id();
        $meta_query = array(
            array(
                'key' => '_customer_user',
                'value' => $current_user_id,
                'compare' => '=',
                'type' => 'NUMERIC'
            )
        );
        $query->set('meta_query', $meta_query);
    }
    // Для других ролей можно добавить свои условия
}

3. Оптимизация запроса

Если список заказов большой, meta_query может замедлять запросы. Рекомендуется добавить индекс на поле _customer_user в таблице wp_postmeta для ускорения выборки.

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

• Авторизуйтесь под пользователем с ролью customer и откройте админку -> Заказы. Должны отображаться только заказы, связанные с этим пользователем.
• Авторизуйтесь под shop_manager — должен отображаться полный список заказов.
• Проверьте, что в других разделах админки и на фронтенде функционал не сломан.
• Проверьте страницу заказов с большим количеством записей на скорость загрузки.

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

• Ошибка: Список заказов пуст для всех пользователей.
  Причина: Неверная проверка условий внутри pre_get_posts или неверно сформированный meta_query.
  Решение: Проверьте, что условия is_admin(), $query->is_main_query(), $pagenow === 'edit.php' и post_type === 'shop_order' корректно применяются.
• Ошибка: Пользователь видит заказы других пользователей.
  Причина: Не добавлена фильтрация по _customer_user или неверно получена роль пользователя.
  Решение: Убедитесь, что get_current_user_role() возвращает корректно роль, и фильтрация по мета-ключу применяется.
• Ошибка: Значительное падение производительности.
  Причина: Отсутствие индекса на поле _customer_user в базе.
  Решение: Добавьте индекс в базу данных (MySQL):

  ALTER TABLE wp_postmeta ADD INDEX _customer_user_idx (meta_key(20), meta_value(20));

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

• Всегда проверяйте права доступа пользователя перед изменением запроса, чтобы не раскрыть данные другим ролям.
• Используйте is_main_query() в pre_get_posts, чтобы избежать изменений в сторонних запросах.
• Оптимизируйте запросы с meta_query добавлением индексов в базе данных.
• Кэшируйте результаты (например, с помощью Transients API), если список заказов не меняется часто.
• Тестируйте на staging-сервере перед внедрением в продакшен.

Сравнение вариантов реализации фильтрации заказов по ролям