Exam result email notification

It allows you to send Email notification to the Eligible/Disqualified participants after completing a quiz test. It also emails the Final report of the Quiz to a specific Admin/Teacher/user.

Prerequisites

• Moodle >= 3.8.9
• PHP >= 7.3

Installing via uploaded ZIP file

1. Log in to your Moodle site as an admin and go to Site administration > Plugins > Install plugins.
2. Upload the ZIP file with the plugin code. You should only be prompted to add extra details if your plugin type is not automatically detected.
3. Check the plugin validation report and finish the installation.

Installing manually

The plugin can be also installed by putting the contents of this directory to

{your/moodle/dirroot}/local/exam_result_email_notification

Afterwards, log in to your Moodle site as an admin and go to Site administration > Notifications to complete the installation.

Alternatively, you can run

$ php admin/cli/upgrade.php

to complete the installation from the command line.

Usage

You will get it from Site administration/Plugins/Local plugins

You may get a page like below

Please make sure that you have a certain QUIZ that enables closing time & minimum passing grade of 1.0. You may check the image below to ensure the settings of QUIZ.

After that, A list of Quiz test would be available to get the Exam email notification.

Now Press + Button (Right Column) to make Schedule email for participants as we as admin/teacher/user.

You may customize your email template.

You may also mention participant name as {{name}} into the mail content.

Enable/Disable Email scheduling from Site Administrator

Please don't forget to complete the Setup of Outgoing mail configuration

Run Schedule Task (Manually)

php admin/cli/scheduled_task.php --execute=\local_exam_result_email_notification\task\cron_task

Caution

In case of Local PC or Localhost, you have to execute the Cron job manually using the above cli command.

Contributing

Contributions are what makes the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Tests

Add the Code Block below into your phpunit.xml file to execute single test

    <testsuite name="local_exam_result_email_notification_testsuite">
    <directory suffix="_test.php">local/exam_result_email_notification/tests</directory>
    </testsuite>

And execute the command below to perform test

php vendor/bin/phpunit --testsuite=local_exam_result_email_notification_testsuite

License

2022 Brain Station 23

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.