=== BuiltByAmit User Role Manager ===
Contributors: amitworx
Tags: roles, capabilities, user roles, user capability, edit role
Requires at least: 6.0
Tested up to: 7.0
Stable tag: 1.0.0
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Create custom WordPress user roles safely, review all registered roles, and manage capabilities for plugin-created roles.

== Description ==

BuiltByAmit User Role Manager is a lightweight, secure, and professional WordPress plugin designed to help administrators review all user roles in one place while safely creating and managing custom roles.

By default, newly created custom user roles inherit the permissions (capabilities) of the default WordPress `Subscriber` role. Site Administrators can then customize each role's permissions through an intuitive dashboard settings panel.

= Features =
* **Custom Role Creation**: Create custom user roles with user-defined keys and human-readable display names.
* **Default Subscriber Permissions**: New roles default to standard subscriber privileges (`read` only) to ensure security and prevent unauthorized access.
* **Role Directory View**: See all registered WordPress user roles in one place, including core and third-party roles, with source labels.
* **Role Capability Management**: A dedicated WordPress settings page that allows site administrators to check/uncheck specific capabilities for each custom role created by this plugin.
* **Built-in Safety**: Restricts changes to WordPress core roles and keeps third-party roles read-only.
* **Role Deletion**: Safely delete plugin-created custom roles that are no longer needed.
* **Fully Secure**: Implements strict WordPress capability checks (`manage_options`) and security nonces on all form submissions and actions.

== Installation ==

1. Upload the `builtbyamit-user-role-manager` directory to the `/wp-content/plugins/` directory.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Access the settings panel from the 'BuiltByAmit User Role Manager' top-level admin menu.

== Frequently Asked Questions ==

= Can I modify the default Administrator role? =
No. For safety and security reasons, the plugin protects all WordPress core roles (Administrator, Editor, Author, Contributor, Subscriber) from being modified or deleted.

= Can I edit roles created by another plugin? =
No. BuiltByAmit User Role Manager shows them in the role directory for visibility, but only edits and deletes roles that were created by this plugin itself.

= What permissions do custom roles get upon creation? =
Newly added custom roles inherit the default capabilities of the `Subscriber` role, which allows them to log in and view the frontend but grants no editing or admin-panel access.

== Screenshots ==

1. The BuiltByAmit User Role Manager dashboard showing all registered roles, grouped into plugin-managed and read-only sections.
2. The All Roles directory showing source labels and access state for core, plugin-managed, and third-party roles.
3. The Capability Manager grid where administrators check and uncheck permissions for custom roles.

== Changelog ==

= 1.0.0 =
* Initial release of BuiltByAmit User Role Manager.
* Features custom role creation, deletion, capability updates, and key validation.


