Ranking Activities AI plugin permissions
The following table summarises the main permissions used by the Ranking Activities AI plugin and their default role assignments.
Since version 1.0.5 the AI-analysis capabilities (generateanalysiscourse and generateanalysisactivity) are enforced: the Generate AI analysis buttons are hidden from users who lack the capability, and the corresponding web services reject requests from users without it.
| Technical permission | Description | Default roles |
|---|---|---|
local/datacurso_ratings:viewcoursereport | View the Datacurso ratings report inside a course and call the supporting AJAX services (activity comments, AI summaries, etc.). | Manager, Editing teacher, Teacher, Course creator |
local/datacurso_ratings:viewgeneralreport | Intended to guard the global ratings dashboard and plugin settings, although the current UI still checks moodle/site:config. | Manager |
local/datacurso_ratings:generateanalysisgeneral | Marks users who are allowed to generate the global AI analysis when contacting the Datacurso AI provider. | Manager |
local/datacurso_ratings:generateanalysiscourse | Marks users who are allowed to trigger the course-level AI analysis endpoints. | Manager, Editing teacher, Course creator |
local/datacurso_ratings:generateanalysisactivity | Marks users who are allowed to request AI analyses focused on individual activities. | Manager, Editing teacher, Course creator |
local/datacurso_ratings:viewcoursereport
Allows users to access the Activity ratings report inside each course (local/datacurso_ratings/admin/report_ratings_course.php) and the navigation shortcut injected via local_datacurso_ratings_extend_navigation_course() in lib.php.
With this permission, a user can:
- Open the in-course report UI to inspect likes, dislikes, and comments per activity.
- Use the AJAX services that power the report (
get_activity_comments,get_ai_analysis_comments,get_ai_analysis_course,get_ratings_report_course, and related AMD modules), because each service checks this capability before returning data. - Be included in the course picker returned by
get_courses_by_category, which allows the global dashboard to list only courses where the user has this capability ormoodle/course:view.
local/datacurso_ratings:viewgeneralreport
Designed to protect the site-wide ratings dashboard and settings (admin/report.php and settings.php). The string description ("Manage datacurso ratings settings") reflects that intent. At the moment those entry points still call require_capability('moodle/site:config'), so this capability is not enforced yet. You can assign it to custom roles in preparation for when the plugin switches the checks to this capability.
local/datacurso_ratings:generateanalysisgeneral
Identifies who is allowed to ask the Datacurso AI provider for a global analysis (/rating/general).
With this permission a user can:
- Request global AI summaries once the Datacurso AI service is configured.
local/datacurso_ratings:generateanalysiscourse
Marks the users that can request course-level AI analyses through the Datacurso AI services (/rating/course).
With this permission, a user can:
- Generate the "AI analysis" visible in the course report once the permissions are granted.
local/datacurso_ratings:generateanalysisactivity
Complements the previous permission by signalling which users can send activity-level AI analysis requests (/rating/query).
With this permission, a user can:
- Trigger the activity comment analysis widget that appears next to the ratings report once the AI integration is enabled.