📝 UNIMA Lecturer Feedback Auto-Fill Extension

A browser extension to automatically fill lecturer evaluation forms on the University of Malawi student portal.

⚠️ Important Notice

This extension is designed to help students who find the feedback process tedious. However, please consider:

• Providing genuine feedback helps improve teaching quality
• Random responses may not accurately reflect your experience
• Check your university's policies regarding automated form submission

Use this tool responsibly and at your own discretion.

---

🚀 Features

• ✅ One-Click Auto-Fill: Fill entire evaluation forms with a single click
• 🎲 Random Responses: Generates random ratings (1-5) for all questions
• ⚙️ Customizable Settings: Choose rating preferences (high, medium, low, neutral, or random)
• 💬 Optional Comments: Automatically fill comment fields with generic positive feedback
• 🔄 Auto-Submit: Optionally submit forms automatically after filling
• 📋 Fill All Lecturers: Process multiple lecturer evaluations in sequence
• 🎨 Beautiful UI: Modern, user-friendly interface

---

📦 Installation Instructions

For Chrome/Edge/Brave

1. Download the Extension

   • The extension files are located in: /home/khoo/Desktop/KHOO/codespace/lecturer-feedback/

2. Open Extension Settings

   • Open Chrome/Edge/Brave
   • Type in the address bar: chrome://extensions/ (or edge://extensions/ for Edge)
   • Press Enter

3. Enable Developer Mode

   • Look for "Developer mode" toggle in the top-right corner
   • Turn it ON

4. Load the Extension

   • Click "Load unpacked" button
   • Navigate to /home/khoo/Desktop/KHOO/codespace/lecturer-feedback/
   • Select the folder and click "Select"

5. Verify Installation

   • You should see "UNIMA Lecturer Feedback Auto-Fill" in your extensions list
   • The extension icon should appear in your browser toolbar

For Firefox

1. Open Firefox

   • Type in the address bar: about:debugging#/runtime/this-firefox
   • Press Enter

2. Load Temporary Add-on

   • Click "Load Temporary Add-on..."
   • Navigate to /home/khoo/Desktop/KHOO/codespace/lecturer-feedback/
   • Select the manifest.json file
   • Click "Open"

Note: In Firefox, temporary extensions are removed when you close the browser. For permanent installation, the extension would need to be signed by Mozilla.

---

📖 How to Use

Method 1: Using the Extension Popup

1. Log in to the Portal

   • Go to https://students.unima.ac.mw/
   • Log in with your credentials
   • Navigate to the course evaluation page

2. Open the Extension

   • Click the extension icon in your browser toolbar
   • A popup will appear with options

3. Configure Settings (Optional)

   • Default Rating: Choose how ratings should be generated
     • Random (1-5): Completely random
     • High (4-5): Mostly positive ratings
     • Medium (3-4): Neutral to positive
     • Low (1-2): Mostly negative
     • Neutral (3): All ratings will be 3
   • Auto-submit after filling: Check to automatically submit the form
   • Fill comment fields: Check to add generic comments

4. Fill the Form

   • Click "Fill Current Form" to fill the current lecturer's evaluation
   • OR click "Fill All Lecturers" to process all evaluations sequentially

5. Review and Submit (if auto-submit is disabled)

   • Review the filled form
   • Click the submit button manually

Method 2: Quick Fill

1. Navigate to any evaluation page
2. Click the extension icon
3. Click "Fill Current Form"
4. Done! ✓

---

⚙️ Settings Explained

Default Rating Options

• Random (1-5): Each question gets a completely random rating from 1 to 5
• High (4-5): Ratings will be either 4 or 5 (positive feedback)
• Medium (3-4): Ratings will be either 3 or 4 (neutral to positive)
• Low (1-2): Ratings will be either 1 or 2 (negative feedback)
• Neutral (3): All ratings will be 3 (middle ground)

Auto-Submit

When enabled, the extension will automatically click the submit button after filling the form. Use with caution!

Fill Comment Fields

When enabled, the extension will fill text areas and comment boxes with generic positive feedback like:

• "Good teaching methods and clear communication"
• "Well organized course with helpful materials"
• "Engaging lectures with practical examples"

---

🎯 For Non-Technical Users

Simple Installation Guide

1. Open your browser (Chrome, Edge, or Brave recommended)

2. Copy this and paste in address bar: chrome://extensions/

3. Turn on "Developer mode" (switch in top-right corner)

4. Click "Load unpacked"

5. Find the folder:

   • Go to Desktop → KHOO → codespace → lecturer-feedback
   • Click "Select Folder"

6. Done! You'll see a new icon in your browser

How to Use (Simple Steps)

1. Log in to the student portal
2. Go to course evaluation page
3. Click the extension icon (looks like a clipboard)
4. Click "Fill Current Form"
5. Wait 2 seconds
6. Click submit (or it will submit automatically if you enabled auto-submit)

---

🔧 Troubleshooting

Extension doesn't appear in toolbar

• Go to chrome://extensions/
• Make sure the extension is enabled (toggle switch is ON)
• Click the puzzle icon in toolbar and pin the extension

Forms not filling correctly

• Make sure you're on the course evaluation page
• Try refreshing the page and clicking "Fill Current Form" again
• Check that the form has loaded completely before clicking

Auto-submit not working

• Some forms may have different submit button structures
• Try disabling auto-submit and clicking submit manually
• Check browser console for errors (F12 → Console tab)

Extension not loading

• Make sure all files are in the same folder
• Check that the manifest.json file is present
• Reload the extension: go to chrome://extensions/ and click the reload icon

---

📁 Extension Files

lecturer-feedback/
├── manifest.json       # Extension configuration
├── popup.html          # Extension popup interface
├── popup.css           # Popup styling
├── popup.js            # Popup functionality
├── content.js          # Form-filling logic
├── icons/              # Extension icons
│   ├── icon16.png
│   ├── icon48.png
│   └── icon128.png
└── README.md           # This file

---

🛡️ Privacy & Security

• No data collection: This extension does NOT collect, store, or transmit any personal data
• Local operation: All processing happens locally in your browser
• No external servers: No data is sent to any external servers
• Open source: All code is visible and can be reviewed
• Credentials: Your login credentials are NEVER accessed or stored by this extension

---

🤝 Sharing with Friends

To share this extension with friends who don't have technical knowledge:

1. Zip the folder:

   • Right-click on the lecturer-feedback folder
   • Select "Compress" or "Create Archive"
   • Send the zip file to your friend

2. Share these simple instructions:

   1. Extract the zip file
   2. Open Chrome
   3. Type: chrome://extensions/
   4. Turn on "Developer mode" (top-right)
   5. Click "Load unpacked"
   6. Select the extracted folder
   7. Done!
   

---

📝 Notes

• The extension works on: https://students.unima.ac.mw/pages/course_evaluation/*
• Settings are saved automatically and persist across browser sessions
• The extension only activates on UNIMA portal pages
• You can disable/enable the extension anytime from chrome://extensions/

---

⚖️ Disclaimer

This tool is provided as-is for educational purposes. The developers are not responsible for any consequences of using this extension. Users are responsible for ensuring their use complies with university policies and academic integrity guidelines.

---

🆘 Support

If you encounter issues:

1. Check the troubleshooting section above
2. Make sure you're using the latest version of Chrome/Edge/Firefox
3. Try disabling other extensions that might interfere
4. Clear browser cache and reload the extension

---

Made with ❤️ for UNIMA students

Version 1.0.0