Как установить права доступа к тикетам WPtickets через capabilities в WordPress

Диагностика проблемы: почему стандартные роли не подходят для управления тикетами WPtickets

По умолчанию WPtickets использует стандартные роли WordPress, такие как администратор, редактор и подписчик, для управления доступом к тикетам. Однако в большинстве случаев бизнес-задачи требуют более тонкой настройки прав доступа. Например, нужно разрешить агентам поддержки видеть и редактировать тикеты, но запретить создавать новые, или ограничить клиентов только просмотром своих тикетов. Стандартные роли этого не позволяют без кастомизации.

Если вы столкнулись с тем, что пользователи с определенной ролью видят тикеты, к которым не должны иметь доступ, или наоборот, не могут работать с тикетами по инструкции — стоит проверить capabilities, которые WPtickets использует для контроля прав.

Как WPtickets использует capabilities для контроля доступа

WPtickets интегрируется с системой capabilities WordPress, используя собственные права, например:

• manage_wptickets — полный доступ к управлению тикетами;
• edit_wptickets — возможность редактировать тикеты;
• read_wpticket — просмотр тикетов;
• delete_wptickets — удаление тикетов.

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

Пошаговое решение: как добавить и настроить capabilities для ролей WordPress

1. Определите роли, которым необходимо дать доступ

Чаще всего это «агенты поддержки» (например, роль support_agent) и клиенты (subscriber или кастомная роль).

2. Добавьте необходимые capabilities через код

Добавьте следующий код в файл functions.php вашей темы или в отдельный плагин:

function wptickets_add_capabilities() {
    // Получаем объект роли агента поддержки
    $role = get_role('support_agent');
    if ( ! $role ) {
        // Создаем роль, если ее нет
        add_role('support_agent', 'Support Agent', array(
            'read' => true,
        ));
        $role = get_role('support_agent');
    }

    // Добавляем права для работы с тикетами
    $role->add_cap('manage_wptickets');    // полный доступ
    $role->add_cap('edit_wptickets');      // редактирование
    $role->add_cap('read_wpticket');       // просмотр
    $role->add_cap('delete_wptickets');    // удаление

    // Аналогично для клиентов, ограничим только просмотр своих тикетов
    $client_role = get_role('subscriber');
    if ($client_role) {
        $client_role->add_cap('read_wpticket');
        // не даем права на редактирование или удаление
        $client_role->remove_cap('edit_wptickets');
        $client_role->remove_cap('manage_wptickets');
        $client_role->remove_cap('delete_wptickets');
    }
}
add_action('init', 'wptickets_add_capabilities');

3. Ограничьте доступ к тикетам только своими записями для клиентов

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

function wptickets_limit_tickets_to_owner($query) {
    if (is_admin() && $query->get('post_type') === 'wpticket' && !current_user_can('manage_wptickets')) {
        $query->set('author', get_current_user_id());
    }
}
add_action('pre_get_posts', 'wptickets_limit_tickets_to_owner');

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

• Авторизуйтесь под пользователем с ролью support_agent и убедитесь, что доступны все действия с тикетами (создание, редактирование, удаление).
• Авторизуйтесь под клиентом (роль subscriber) и проверьте, что в списке отображаются только тикеты, созданные этим пользователем, и отсутствует возможность их редактирования или удаления.
• Попробуйте зайти под ролью без назначенных capabilities и убедитесь, что доступ к тикетам закрыт.

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

• Capabilities не добавляются после изменения кода
  Причина: код с функцией wptickets_add_capabilities запускается слишком поздно или не запускается. Решение: убедитесь, что хук init используется правильно и код загружается при каждом запросе.
• Пользователь видит все тикеты, а не только свои
  Причина: фильтр pre_get_posts не применён или конфликт с другим плагином.
  Решение: проверьте, что фильтр подключён и не отключён, протестируйте без других плагинов.
• Роль не создаётся автоматически
  Причина: роль support_agent отсутствует, и создание роли не происходит из-за ошибок в коде.
  Решение: создайте роль вручную в админке или исправьте ошибки кода.

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

• Избегайте назначения права manage_wptickets пользователям без необходимости — это полный доступ к тикетам.
• Для массового добавления или удаления capabilities используйте WP-CLI команду wp role add-cap или wp role remove-cap — это безопаснее и прозрачнее.
• Проверяйте права доступа в шаблонах и AJAX-запросах, чтобы исключить обход ограничений через API.
• Для крупных сайтов с тысячами тикетов используйте индексацию базы данных на поле post_author, чтобы ускорить выборки по автору.

Сравнение способов управления доступом к тикетам