🧩 Plugin: Rubric Importer Core (local_customgradingform_renderer)

Component: local_customgradingform_renderer

📌 Features

• Enables importing rubrics from a CSV file into any Moodle Assignment using the advanced grading method.
• Processes and structures criteria, levels, and scores using Moodle's internal grading APIs.
• Ensures data integrity through robust validation and sanitization.
• Provides auto-debugging when Moodle debugging mode is enabled — helpful for developers and site administrators.
• Supports localization and uses standard Moodle file handling APIs for secure temporary file management.

📂 CSV Format Example

Your CSV file should follow this exact structure:

criterion,level,level_description,score
"Clarity","1","Clear and concise","10"
"Clarity","2","Mostly clear","5"
"Clarity","3","Lacks clarity","0"

🧪 Usage Scenario

1. Download and install the latest version of this plugin from:
   🔗 https://github.com/ingrichardrangel/moodle-local_customgradingform_renderer
2. Also download and install the block plugin to access the import button within Assignment activities:
   🔗  https://github.com/ingrichardrangel/moodle-block_importrubric
3. You can download the block from his page in the moodle plugin repository: https://moodle.org/plugins/view.php?id=3612
4. After Installation of Both Plugins, Enter an Assignment activity and add the “Import rubric from CSV” block manually.
5. Click the button, upload your CSV, and the plugin will process and validate the rubric data.
6. You will be redirected to the Advanced Grading interface where the rubric is available in draft form for review and activation.

✅ Validation Rules

• Ensures no repeated scores among levels under the same criterion.
• Validates that the sum of the levels with the maximum score across all criteria equals the maximum grade of the Assignment.
• Displays actual score total and expected maximum to help user comparison in case of error.
• If enabled in plugin settings:
  • Verifies that each criterion includes a level with the minimum allowed score.
  • Checks that individual level scores do not exceed the maximum allowed score.

📤 File Handling

• Uploaded CSV files are stored temporarily in Moodle's draft area while parsing and processing.
• Rubric data is inserted directly into Moodle’s database through the Advanced Grading APIs.
• Rubrics are always stored as drafts, giving teachers full control to enable, modify, or discard them.

🛡️ Security and Debugging

• All user-submitted data is sanitized using clean_param() to ensure input security.
• In Moodle debugging mode, the plugin outputs helpful information and error messages for deeper insight.

⚙️ Requirements

• Requires Moodle 4.1 or later.
• Must be used alongside the block block_importrubric to enable interface access from Assignment activities.

Developed by Richard Rangel – 2025