=== Titanium Advanced User Roles ===
Contributors: aplugins
Tags: roles, capabilities, user roles, content control, permissions
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Modern role editor, multiple roles, content control and smart role rules for WordPress.

== Description ==

Take control of WordPress roles, capabilities, admin access, and content visibility from one clean dashboard. Titanium Advanced User Roles helps you manage who can do what on your site without editing code or changing database values manually.

WordPress roles are powerful, but the default tools are limited. If your site has members, customers, editors, donors, staff, clients, or custom user types, it can quickly become difficult to see which roles have which permissions.

Titanium Advanced User Roles gives administrators practical tools for managing roles, capabilities, multiple user roles, admin UI restrictions, frontend content control, shortcodes, and role-related settings. The Free version includes the core tools needed for everyday role management. The Pro version is available separately for sites that need advanced audits, membership conditions, rule groups, and deeper capability tools.

Manage everything from the WordPress admin area. No custom snippets. No manual database editing. No role guesswork.

= What you can do =

* Edit WordPress role capabilities from a visual interface.
* Create, clone, rename, and delete custom roles.
* Compare roles and quickly spot capability differences.
* Assign multiple roles to users when needed.
* Hide the admin toolbar for selected roles.
* Block dashboard access for selected roles.
* Hide admin menu items by role.
* Block direct access to hidden admin menu pages.
* Control selected frontend content by login status or role.
* Use shortcodes to show or hide frontend content.
* Import and export role and plugin settings.

= Free features =

**Roles and capabilities editor**

View and manage WordPress roles and capabilities from a clean admin screen.

**Create, clone, rename, and delete roles**

Build custom roles for membership sites, client portals, editorial teams, staff dashboards, and custom workflows.

**Role comparison**

Compare roles side by side and see capability differences more clearly.

**Multiple roles per user**

Allow users to have more than one role when your workflow needs overlapping access.

**Admin UI restrictions**

Hide the admin toolbar, block dashboard access, hide selected admin menu items, and block direct access to hidden admin pages by role.

**Content Control and shortcodes**

Show or hide selected frontend content by login status or WordPress role, including small content sections with visibility shortcodes.

**Import and export**

Back up or move role and plugin settings between sites.

= Pro features =

Titanium Advanced User Roles Pro is available separately for professional sites that need deeper control.

Pro adds advanced content rules, AND/OR condition groups, membership plugin conditions, advanced admin menu visibility tools, Pro Tools audits, risky role scans, users without roles scans, role conflict scans, direct user capability tools, user-specific capability checks, advanced user filtering, beta update opt-in, and priority Pro support.

Supported Pro membership integrations include Paid Memberships Pro, MemberPress, WooCommerce Memberships, Restrict Content / Restrict Content Pro, and Paid Member Subscriptions.

= Free vs Pro =

Free is ideal for practical role management, capability editing, multiple roles, admin UI restrictions, content control, shortcodes, and import/export.

Pro is ideal for advanced content rules, membership-aware workflows, audits, direct user capability tools, and deeper professional role management.

= Useful for =

* Membership sites
* Donation sites
* Client portals
* WooCommerce customer areas
* Editorial teams
* Community sites
* Download sites
* Course sites
* Staff dashboards
* Sites with custom roles

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/` or install the ZIP from the WordPress Plugins screen.
2. Activate the plugin.
3. Open **Advanced User Roles** in the WordPress admin menu.

== Frequently Asked Questions ==

= Does this plugin create membership levels? =

No. It manages WordPress roles and capabilities only. It does not create membership levels or automatically connect roles to payment/subscription plugins.

= Are passwords exported? =

No. The Free import/export tools do not export passwords or full user database data.

= Can the Administrator role be edited? =

The Administrator role is protected to reduce the risk of locking yourself out.

== External services ==

This plugin connects to external services only on the plugin's admin screens when an administrator opens the Upgrade / pricing page or starts the checkout flow.

AdminPlugins pricing API

This plugin connects to the AdminPlugins pricing API at `https://adminplugins.com/wp-json/aur-freemius/v1/pricing` to load the current public plan prices, license limits, discount state, and checkout URLs shown on the Upgrade page for Titanium Advanced User Roles. The request is made from the WordPress admin area when an administrator opens or refreshes the plugin pricing page. The plugin sends a standard server-side HTTP GET request with a generic plugin user agent. No role rules, capability settings, site content, users, passwords, license keys, or site URL are intentionally sent by this request. If the primary REST URL is unavailable, the plugin can try the fallback WordPress REST route at `https://adminplugins.com/?rest_route=/aur-freemius/v1/pricing`.

This service is provided by AdminPlugins: Terms of Service: https://adminplugins.com/terms-and-conditions/ Privacy Policy: https://adminplugins.com/privacy-policy/

Freemius SDK and Checkout

This plugin uses the Freemius SDK for optional Pro licensing, account management, software updates, and checkout. The plugin loads the Freemius Checkout JavaScript from `https://checkout.freemius.com/js/v1/` on the plugin Upgrade / pricing page so administrators can open the secure checkout overlay when choosing a Pro plan. The checkout script is loaded only in the WordPress admin area on the plugin pricing screen. When an administrator opts in through the Freemius SDK, activates a license, opens the Freemius account/license screens, checks for updates, or clicks an upgrade button, Freemius may receive licensing and site/account data required to provide those services. Checkout-related data can include the product ID, plan ID, pricing ID, selected license quantity, billing cycle, currency, coupon code when active, and license key when upgrading an existing license. If the checkout overlay script is unavailable, the administrator is sent to the normal Freemius checkout URL instead.

This service is provided by Freemius, Inc.: Terms of Service: https://freemius.com/terms/ Privacy Policy: https://freemius.com/privacy/

== Screenshots ==

1. Dashboard overview with role, user, smart rule, controlled content, and feature status cards.
2. Multiple roles and frontend/login tools for toolbar, dashboard, redirects, admin menu visibility, and shortcode examples.
3. Role editor with capability groups, role details, and visual capability checkboxes.
4. Frontend and login tools with admin toolbar, dashboard access, redirects, admin menu visibility, and shortcode examples.
5. Roles and capabilities page with default role tools, role editing, add role, clone role, copy capabilities, and role comparison.
6. User Filters page for reviewing users by role conditions.
7. Content Control page with enabled content types and recent posts/pages status overview.
8. Advanced Content Rules builder with target content, visitor conditions, AND conditions, OR groups, and denied result settings.
9. Smart Rules page for automatic role cleanup when another role is added.
10. Import and Export page with plugin settings export, import, filtered user export, and full user data export/import tools.
11. Pro control center with license status, application password control, and Pro diagnostic summary cards.
12. Permission safety scanners for risky roles, users without roles, role conflicts, and user-specific capabilities.
13. User-specific permissions screen with direct capability grants, explicit deny capabilities, and per-user restrictions.
14. Admin and editor restrictions for dashboard widgets, notices, editors, metaboxes, block editor panels, and per-user restrictions.
15. Profile hide/lock rules for controlling WordPress profile fields and custom user meta fields.
16. Administrator capability review with baseline comparison and stale custom/plugin capability cleanup.
17. Custom capability manager for creating custom capabilities and deleting unused or stale plugin capabilities.
18. Gutenberg block visibility rules, multisite role sync, and Pro audit log tools.
19. Settings page with beta updates, primary roles and role order, color theme, and uninstall cleanup options.
20. Content Control metabox inside the block editor with allow/block modes, logged-in/logged-out modes, redirect URL, and denied message settings.

== Changelog ==

= 1.0.0 =
Initial release.
