Fun: UserPermissions facade

[jonwaldstein]

Resolves #

Description

The UserPermissions Facade is a class that allows you to check if a user has a specific capability or role but not necessarily in the traditional way. The DX focuses on the resource, not the capability, so we don't have to remember what specific caps or roles have access to the resource.

It is a wrapper around the WordPress current_user_can() function but geared toward the roles in GiveWP.

Example:

use Give\Framework\Permissions\Permissions;

if (!UserPermissions::donationForms()->can('edit')) {
    throw new Exception('You do not have permission to edit donation forms.');
}

if (!UserPermissions::donors()->can('delete')) {
    throw new Exception('You do not have permission to delete donors.');
}

Affects

Nothing yet, but eventually would be used for validating permissions

Visuals

N/A

Testing Instructions

Pre-review Checklist

• Acceptance criteria satisfied and marked in related issue
• Relevant @unreleased tags included in DocBlocks
• Includes unit tests
• Reviewed by the designer (if follows a design)
• Self Review of code and UX completed