yard/wp-user-roles

An Acorn package for managing user roles in WordPress.

v2.0.2 2025-03-28 09:05 UTC

Requires

• php: >=8.1
• spatie/laravel-package-tools: ^1.16
• webmozart/assert: ^1.11
• wp-cli/wp-cli-bundle: ^2.11

Requires (Dev)

• 10up/wp_mock: ^0.4.2
• larastan/larastan: ^2.0
• orchestra/testbench: ^8.23
• pestphp/pest: ^2.34
• szepeviktor/phpstan-wordpress: ^1.0
• yard/php-cs-fixer-rules: ^1.0

MIT

README

An Acorn package for managing user roles in WordPress.

Features

• Configure: Define custom roles and capabilities with a configuration file.
• (Re)Create: Insert roles into the database with a single wp-cli command.
• Clone roles: Quickly set up new roles based on existing ones.
• Delete roles: Remove any roles that you don’t need.

See config for all configuration options.

Requirements

• Sage >= 10.0
• Acorn >= 4.0

Installation

1. Install this package with Composer:

   composer require yard/wp-user-roles

2. Run the Acorn WP-CLI command to discover this package:

   wp acorn package:discover

Usage

1. Publish the config file with:

   wp acorn vendor:publish --provider="Yard\UserRoles\UserRolesServiceProvider"

2. Run WP-CLI command to create roles:

   Single site:

   wp acorn roles:create

   In a multisite:

   wp site list --field=url | xargs -n1 -I % wp acorn roles:create --url=%