Как создать динамические роли пользователей в WordPress с примерами кода

В WordPress стандартный набор ролей пользователей достаточно ограничен: Администратор, Редактор, Автор, Участник и Подписчик. Однако для многих проектов требуется более гибкое управление правами доступа с возможностью создания кастомных ролей, которые можно изменять динамически в зависимости от бизнес-логики.

Зачем нужны динамические роли пользователей в WordPress

Динамические роли позволяют создавать уникальные группы пользователей с определённым набором возможностей (capabilities), которые можно менять в зависимости от условий, например, активности пользователя, подписок или других параметров. Это особенно полезно для сайтов с платным доступом, образовательных порталов или сложных корпоративных систем.

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

Создание кастомной роли пользователя с помощью кода

Для создания кастомной роли в WordPress используется функция add_role(). Рассмотрим, как в wp5.ru мы можем создать роль «Редактор курсов» с ограниченными правами, которые можно расширять динамически.

function wp5_add_custom_role() {
    add_role('course_editor', 'Редактор курсов', array(
        'read' => true,
        'edit_posts' => true,
        'edit_courses' => true, // Кастомная capability для курсов
        'publish_courses' => true,
        'delete_courses' => false,
    ));
}
add_action('init', 'wp5_add_custom_role');

Обратите внимание, что для работы с кастомными типами записей (например, 'courses') нужно регистрировать соответствующие capabilities и назначать их ролям. Это позволит более тонко контролировать доступ.

Регистрация кастомного типа записи с поддержкой capabilities

Для полноты примера создадим тип записи «Курсы» и зададим для него собственные возможности.

function wp5_register_courses_cpt() {
    $capabilities = array(
        'edit_post' => 'edit_course',
        'read_post' => 'read_course',
        'delete_post' => 'delete_course',
        'edit_posts' => 'edit_courses',
        'edit_others_posts' => 'edit_others_courses',
        'publish_posts' => 'publish_courses',
        'read_private_posts' => 'read_private_courses',
    );

    register_post_type('course', array(
        'label' => 'Курсы',
        'public' => true,
        'supports' => array('title', 'editor', 'thumbnail'),
        'capability_type' => array('course', 'courses'),
        'map_meta_cap' => true,
        'capabilities' => $capabilities,
    ));
}
add_action('init', 'wp5_register_courses_cpt');

Теперь можно назначать эти capabilities ролям, в том числе нашей кастомной «Редактор курсов».

Динамическое изменение прав роли

Иногда нужно менять права роли в зависимости от действий пользователя или бизнес-логики. Например, повысить права редактора курсов после прохождения определённого теста или оплаты.

Для этого можно использовать функцию get_role() и методы объекта роли.

function wp5_update_role_capabilities($user_id) {
    $user = get_userdata($user_id);
    if (in_array('course_editor', $user->roles)) {
        $role = get_role('course_editor');
        // Добавляем возможность удалять курсы
        $role->add_cap('delete_courses');
    }
}

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

Удаление capabilities из роли

Для удаления прав используйте метод remove_cap():

function wp5_remove_delete_courses_cap() {
    $role = get_role('course_editor');
    $role->remove_cap('delete_courses');
}

Использование плагина для управления ролями и правами

Если не хочется писать код, можно использовать популярные плагины для управления ролями, например:

• User Role Editor — позволяет создавать и редактировать роли и capabilities через удобный интерфейс.
• Members — мощный инструмент для управления доступом, поддерживает работу с кастомными типами записей.

Плагины подходят для администраторов, которые не хотят вникать в код, но при этом дают гибкость и контроль.

Для интеграции с другими продуктами, например, Clearfy Pro, можно использовать возможности оптимизации и управления правами на уровне сайта.

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

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

function wp5_user_can_edit_courses($user_id = null) {
    if (!$user_id) {
        $user_id = get_current_user_id();
    }
    $user = get_userdata($user_id);
    return $user && user_can($user, 'edit_courses');
}

Использование:

if (wp5_user_can_edit_courses()) {
    echo 'Вы можете редактировать курсы';
} else {
    echo 'Доступ запрещён';
}

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

Важно тщательно контролировать добавляемые capabilities и роли, чтобы не дать лишних прав, особенно если на сайте работают несколько разработчиков или администраторов. Рекомендуется:

• Тестировать изменения ролей на локальной копии сайта.
• Использовать функции WordPress для проверки прав, а не полагаться на пользовательские переменные.
• Регулярно обновлять плагины и ядро WordPress для защиты от уязвимостей.

Таким образом, создание и управление динамическими ролями — мощный инструмент для реализации сложных сценариев доступа в WordPress.