AI Roles
AI Roles
The AI Roles view maps JoomlaAI capabilities to Joomla user groups (or WordPress roles). Use it to control who can access which features without touching the CMS's native ACL system.
Capability matrix
Navigate to JoomlaAI → AI Roles.
The matrix is displayed as a table: rows = user groups/roles, columns = capabilities.
| Capability | Joomla ACL key | WP capability | Description |
|---|---|---|---|
| Dashboard | core.manage | wpai_dashboard | View the Dashboard |
| Chatbot | joomlaai.chatbot | wpai_use_chatbot | Send chat messages |
| Scheduler | joomlaai.scheduler | wpai_manage_scheduler | Create/edit/run scheduled jobs |
| Content Review | joomlaai.content_review | wpai_review_content | Approve / reject / publish AI content |
| Template Library | joomlaai.templates | wpai_manage_templates | Create and edit prompt templates |
| Budget | joomlaai.budget | wpai_manage_budget | Set and view budget rules |
| AI Roles | joomlaai.roles | wpai_manage_roles | Edit the roles matrix |
| Personalities | joomlaai.personalities | wpai_manage_personalities | Create and edit AI personalities |
| Chat History | joomlaai.chat_history | wpai_view_chat_history | View saved chat sessions |
| Audit Log | joomlaai.audit | wpai_view_audit | View the audit trail |
| Health Check | joomlaai.health | wpai_view_health | View environment diagnostics |
Editing the matrix
Each cell in the matrix is a checkbox. Check a cell to grant that group the capability; uncheck to revoke it.
Click Save (or Save Roles in WP) to apply changes. Changes take effect immediately for all users in that group — no cache flush needed.
Default role assignments
| Group / Role | Defaults |
|---|---|
| Super Users / Administrator | All capabilities |
| Managers / Editor | Dashboard, Chatbot, Content Review, Template Library, Chat History |
| Registered / Author | Dashboard, Chatbot |
| Public / Subscriber | None |
Joomla ACL integration
In Joomla, the AI Roles view writes to the standard #__assets / #__user_groups ACL tables. You can also manage the same permissions via System → Global Configuration → Permissions or via component-level permissions in Components → JoomlaAI → (component permissions tab).
The access.xml file defines all 10 custom actions:
<action name="joomlaai.chatbot" title="COM_JOOMLAAI_ACL_CHATBOT" />
<action name="joomlaai.scheduler" title="COM_JOOMLAAI_ACL_SCHEDULER" />
<action name="joomlaai.content_review" title="COM_JOOMLAAI_ACL_CONTENT_REVIEW" />
...WordPress capabilities
In WordPress, capabilities are stored per user in the wp_usermeta table (key: wp_capabilities). The AI Roles view uses WP_Role::add_cap() / WP_Role::remove_cap() to manage them.
You can also use a plugin like Members or User Role Editor to manage wpai_* capabilities alongside your other custom caps.
Permissions to edit AI Roles
| Capability | Access |
|---|---|
joomlaai.roles / wpai_manage_roles | Edit the matrix |
core.admin / manage_options | Full access (super admin override) |
_Last updated: 2026-05-19 · v2.5.3_
