Athenian Role Management
product details.
Athenian Role Management centralizes role administration, capability control, bulk user assignment, audit tracking, and scoped role-based pricing for WordPress and WooCommerce. It helps teams manage permissions and role-aware commerce behavior without scattering access rules across multiple plugins while keeping data, permissions, and automation aligned with the broader Athenian Platform Ecosystem.
Athenian Role Management is a lightweight WordPress and WooCommerce role operations plugin for managing roles, capabilities, user assignment, import/export, audit controls, and role-based discount policy from a dedicated admin workspace.
The plugin is designed for sites where native WordPress role management is too limited for real operational use. It supports custom staff workflows, wholesale or member pricing, staging-to-production role migration, bulk customer role updates, permission auditing, and Athenian Platform pricing compatibility.
Instead of treating roles as hidden technical settings, ARM turns role governance into an operational workflow. Administrators can create, clone, rename, delete, import, export, and audit role definitions, while WooCommerce teams can configure scoped percentage discounts by role and expose those decisions to Athenian pricing layers.
Within the Athenian Platform, Role Management fits as the role, permission, and pricing-policy control layer for stores, portals, staff tools, customer tiers, wholesale workflows, partner access, internal operations, and broader PriceDelegate-style commerce logic.
Role Operations
Manage WordPress Roles, Capabilities, and Access Rules From One Workspace
Athenian Role Management gives administrators a dedicated WordPress-native
workspace for creating, cloning, renaming, deleting, searching, importing,
exporting, and auditing roles while keeping capability editing organized
into practical permission groups.
| Access Layer | Operational Value |
|---|---|
| Role Lifecycle | Create, clone, rename, and delete non-protected roles from a dedicated Users → Role Management admin screen. |
| Capability Editor | Review, search, group, expand, collapse, and update capabilities across WordPress, WooCommerce, users, posts, pages, plugins, and themes. |
| Protected Roles | Prevents deletion of the administrator role while still allowing operators to manage safer custom-role workflows. |
| Interactive Admin UI | Uses AJAX-backed role operations and JSON bootstrap data to avoid forcing full admin reloads for most management actions. |
- Adds the main admin screen at
Users → Role Management. - Uses AJAX actions such as
arm_get_roles,arm_create_role,arm_clone_role,arm_rename_role,arm_delete_role, andarm_update_caps. - Groups capabilities into areas such as Core, Posts, Pages, Users, Themes & Plugins, WooCommerce, and Other.
- Uses
promote_users,manage_options, nonce validation, and sanitization helpers for access-control workflows.
User Assignment & Governance
Apply Roles at Scale, Move Role Definitions, and Track Administrative Changes
ARM helps teams manage role operations beyond one-off user edits by adding
bulk assignment tools, structured JSON role import/export, and audit logging
for role, capability, import, assignment, and settings changes.
Search users and apply roles in add or replace mode
Export and import role definitions with capability maps
Track role operations, capability updates, imports, and settings changes
| Governance Layer | How It Helps |
|---|---|
| User Search | Find users by login, email, or display name, then select accounts for bulk role operations. |
| Add or Replace | Add a role while preserving existing user roles, or replace the current role set with a selected role. |
| Import/Export | Move role definitions between local, staging, and production using the structured arm_roles_v1 JSON format. |
| Audit Log | Stores timestamped administrative activity with user ID, action key, context payload, and IP address when available. |
- Uses AJAX actions such as
arm_search_users,arm_apply_role,arm_export,arm_import,arm_get_audit,arm_clear_audit, andarm_save_settings. - Stores settings in
arm_settingsand audit entries inarm_audit_log. - Supports import modes such as merge and replace for role capability maps.
- Uses audit retention settings and a retained-entry cap to reduce option bloat while preserving operational visibility.
Role-Based Commerce Policy
Connect User Roles to Scoped WooCommerce Discount Rules
Athenian Role Management adds a WooCommerce Role Discounts workspace where
each role can receive percentage-based discount rules with priority values
and include/exclude targeting by products, categories, and tags.
| Pricing Layer | Operational Purpose |
|---|---|
| Role Discount Rules | Configure per-role enabled state, percentage discount, priority, and catalog targeting from WooCommerce → Role Discounts. |
| Scoped Targeting | Include or exclude discounts by product IDs, product categories, and product tags, with product and parent-product checks. |
| Winning Rule Logic | Evaluates the current user’s roles and selects the highest percentage discount, using lower priority as the tie-breaker. |
| Platform Compatibility | Exposes role-discount decisions through Athenian pricing filters and a legacy-compatible REST endpoint for pricing consumers. |
Policy source, not price replacement:
ARM defines role-discount policy and exposes the resolved discount decision.
A consuming pricing layer such as Athenian Platform Core or PriceDelegate can
then decide how and where that discount should affect displayed or calculated prices.
- Stores preferred v2 discount rules in
arm_role_discounts_v2while retaining legacy fallback options such asarm_role_discounts,ath_pricing_tiers_role_discounts, andapt_role_discounts. - Exposes the canonical pricing filter
ath/apc/role_discount_for_price. - Provides the legacy-compatible route
/wp-json/ath-pricing/v1/role-discountfor logged-in users. - Supports the discount display shortcode name
'role_discount_display'with text, percent, and JSON output modes.