Moodle Local Plugin: Parent Assignment

This Moodle local plugin automatically assigns a Parent role to a user based on custom profile fields (parent_email, parent_name) located within the student's account.

If the specified parent account does not exist in the system, the plugin automatically creates one, generates a secure password, and emails the credentials directly to the parent!

---

✨ Features

• 🚀 Event-Driven Assignment: Instantly acts the exact moment a student account is created or updated.
• 🛡️ Built-in Security: Auto-generates cryptographically secure passwords for new parents.
• 📧 Moodle Native Communications: Standard welcome emails dispatch automatically containing the randomly generated temporary credentials.
• 🔒 Forced Reset: Mandatory password reset for parent accounts during their first login ensures absolute account privacy.
• ⚙️ Fallback Scheduled Tasks: Periodically sweeps for missed users, ideal for massive bulk uploads via the scheduled task system (\local_parentassign\task\process_parents).

📋 Prerequisites

Before installing the plugin, ensure the following setup is configured on your Moodle site:

1. Moodle Version: 4.1 or later.
2. User Profile Fields: Navigate to Site Administration > Users > Accounts > User profile fields and create two new Text Input fields:
   • Shortname: parent_email
   • Shortname: parent_name
3. Parent Role: A valid system role with the shortname parent.

📦 Installation

1. Copy the local_parentassign directory into the local/ folder of your Moodle installation:

   git clone https://github.com/Smartlearn-edu/moodle_local_parentassign.git local/parentassign

2. Navigate to Site administration > Notifications as an administrator to invoke the installation process, or run the following CLI command:

   php admin/cli/upgrade.php

🚀 How it Works

The lifecycle of the plugin guarantees seamless parent onboarding:

1. Student Registration: An administrator, teacher, or external system registers a student, ensuring the parent_email and parent_name profile fields are populated.
2. Account Synchronization: The plugin intercepts the user creation event. If the parent's email already maps to a Moodle user, it links the student to them via the parent role.
3. Auto-Provisioning: If the parent account doesn't exist, an account is created on-the-fly using their parent_name and parent_email.
4. Welcome Email: The parent immediately receives Moodle's standard welcome email containing their dynamically generated temporary 12-character password.
5. Secure Authentication: The parent logs in and is forced to configure a permanent password securely.

🔏 Privacy

Fully compliant with Moodle's 4.5+ Privacy API (\local_parentassign\privacy\provider implements \core_privacy\local\metadata\null_provider). This plugin stores absolutely no personal tracking data natively. It strictly maps existing core user entity data to facilitate architectural role assignments.

📄 License

This plugin is licensed under the GNU GPL v3 or later.