{"id":24506784,"url":"https://github.com/michael-milette/moodle-local_mailtest","last_synced_at":"2025-10-08T15:52:06.505Z","repository":{"id":49856545,"uuid":"45376473","full_name":"michael-milette/moodle-local_mailtest","owner":"michael-milette","description":"Moodle MailTest allows administrators to test Moodle's email system. A trace of the SMTP dialogue will be displayed if the email message cannot be sent for any reason.   For premium support, contact us at https://www.tngconsulting.ca/contact","archived":false,"fork":false,"pushed_at":"2025-04-28T00:09:51.000Z","size":206,"stargazers_count":19,"open_issues_count":0,"forks_count":12,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-09-03T20:17:27.675Z","etag":null,"topics":["hacktoberfest","moodle","moodle-local","moodle-plugin"],"latest_commit_sha":null,"homepage":"https://moodle.org/plugins/local_mailtest","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/michael-milette.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2015-11-02T06:36:47.000Z","updated_at":"2025-04-28T00:09:29.000Z","dependencies_parsed_at":"2024-04-28T05:42:49.770Z","dependency_job_id":"5311e831-fce4-4cb4-9668-a56c943a9413","html_url":"https://github.com/michael-milette/moodle-local_mailtest","commit_stats":{"total_commits":35,"total_committers":4,"mean_commits":8.75,"dds":"0.19999999999999996","last_synced_commit":"7b8cfa70dd08d668d9a64e13c63b0fdb1672a500"},"previous_names":[],"tags_count":14,"template":false,"template_full_name":null,"purl":"pkg:github/michael-milette/moodle-local_mailtest","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/michael-milette%2Fmoodle-local_mailtest","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/michael-milette%2Fmoodle-local_mailtest/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/michael-milette%2Fmoodle-local_mailtest/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/michael-milette%2Fmoodle-local_mailtest/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/michael-milette","download_url":"https://codeload.github.com/michael-milette/moodle-local_mailtest/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/michael-milette%2Fmoodle-local_mailtest/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278972330,"owners_count":26078017,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-08T02:00:06.501Z","response_time":56,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["hacktoberfest","moodle","moodle-local","moodle-plugin"],"created_at":"2025-01-21T23:39:51.663Z","updated_at":"2025-10-08T15:52:06.500Z","avatar_url":"https://github.com/michael-milette.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cimg src=\"pix/logo.png\" align=\"right\" /\u003e\n\nLocal eMailTest plugin for Moodle\n=================================\n![PHP](https://img.shields.io/badge/PHP-v5.6%20to%208.3-blue.svg)\n![Moodle](https://img.shields.io/badge/Moodle-v2.5%20to%20v4.5-orange.svg)\n[![GitHub Issues](https://img.shields.io/github/issues/michael-milette/moodle-local_mailtest.svg)](https://github.com/michael-milette/moodle-local_mailtest/issues)\n[![Contributions welcome](https://img.shields.io/badge/contributions-welcome-green.svg)](#contributing)\n[![License](https://img.shields.io/badge/License-GPL%20v3-blue.svg)](#license)\n\n# Table of Contents\n\n- [Basic Overview](#basic-overview)\n- [Requirements](#requirements)\n- [Download eMail Test for Moodle](#download-email-test-for-moodle)\n- [Installation](#installation)\n- [Usage](#usage)\n- [Updating](#updating)\n- [Uninstallation](#uninstallation)\n- [Limitations](#limitations)\n- [Language Support](#language-support)\n- [Frequently Asked Questions (FAQ)](#faq)\n- [Contributing](#contributing)\n- [Motivation for this plugin](#motivation-for-this-plugin)\n- [Further information](#further-information)\n- [License](#license)\n\n# Basic Overview\n\nThe eMailTest module for Moodle allows administrators to test Moodle's email system. A trace of the SMTP dialogue will be displayed if the email message cannot be sent for any reason.\n\nOnce the test email has been sent, you will need to check your email in-box to confirm that the email message was successfully delivered. This plugin will not do that for you.\n\n[(Back to top)](#table-of-contents)\n\n# Requirements\n\nThis plugin requires Moodle 2.5+, 3.x+, 4.x+ or 5.x+ from https://moodle.org\n\n[(Back to top)](#table-of-contents)\n\n# Download eMail Test for Moodle\n\nThe most recent STABLE release of eMail Test for Moodle is available from:\nhttps://moodle.org/plugins/local_mailtest\n\nThe most development release can be found at:\nhttps://github.com/michael-milette/moodle-local_mailtest\n\n[(Back to top)](#table-of-contents)\n\n# Installation\n\nInstall the plugin, like any other plugin, to the following folder:\n\n    /local/mailtest\n\nSee https://docs.moodle.org/en/Installing_plugins for details on installing Moodle plugins.\n\nThere are no special considerations required for updating the plugin.\n\n[(Back to top)](#table-of-contents)\n\n# Usage\n\nThere are no configurable settings for this plugin at this time.\n\nThe local_mailtest plugin is designed allow administrators to test Moodle to ensure the email message system is correctly configured.\n\nOnce installed, login as a Moodle administrator and then click:\n\n    Home \u003e Site Administration \u003e Server \u003e eMail Test\n\nEnter the email address of the recipient where you want to send the message and click the [Send a test message] button.\n\nIf the email message was successfully sent by Moodle, you will see a message that says \"Success - The test message was successfully delivered to the SMTP server.\". If it fails to send the email, a dialogue between the Moodle and the SMTP server will be displayed.\n\n[(Back to top)](#table-of-contents)\n\n# Updating\n\nThere are no special considerations required for updating the plugin.\n\nThe first public BETA version was released on 2015-11-01. This plugin is now considered STABLE.\n\nFor more information on releases since then, see\n[CHANGELOG.md](https://github.com/michael-milette/moodle-local_mailtest/blob/master/CHANGELOG.md).\n\n[(Back to top)](#table-of-contents)\n\n# Uninstallation\n\nUninstalling the plugin by going into the following:\n\nHome \u003e Administration \u003e Site Administration \u003e Plugins \u003e Manage plugins \u003e eMail Test\n\n...and click Uninstall. You may also need to manually delete the following folder:\n\n    /local/mailtest\n\n[(Back to top)](#table-of-contents)\n\n# Limitations\n\nThere are no known limitations at this time.\n\n[(Back to top)](#table-of-contents)\n\n# Language Support\n\nThis plugin includes support for the English language. Additional languages including French are supported if you've installed one or more additional Moodle language packs.\n\nIf you need a different language that is not yet supported, please feel free to contribute using the Moodle AMOS Translation Toolkit for Moodle at https://lang.moodle.org/\n\nThis plugin has not been tested for right-to-left (RTL) language support. If you want to use this plugin with a RTL language and it doesn't work as-is, feel free to prepare a pull request and submit it to the project page at:\n\nhttps://github.com/michael-milette/moodle-local_mailtest\n\n[(Back to top)](#table-of-contents)\n\n# FAQ\n\n## Frequently Asked Questions\n\n### Why do I get a 500 server error when I use eMailTest?\n\nThis plugin has been extensively tested and used on hundreds of sites. If you are getting this error, it is likely that you have a file owner/group permissions issue on your server which needs to be resolved.\n\n### Why does it say that Moodle sent the test message successfully yet I did not receive the email?\n\nThis could be due to a number of reasons including but not limited to:\n\n* Incorrect PHP Mail settings in your php.ini file (if you have not configured Moodle's SMTP settings).\n* You may have an anti-virus or firewall blocking email communications.\n* The mail server receiving your email may be discarding emails received from your site.\n* The test email may be blocked by anti-spam filters. Check your junk mail folder.\n\n### How do I find out the correct email settings I should be using?\n\nContact your network administrator or your web hosting provider. These are typically the same settings as you would use for an email client but the administrator may need to add special settings to allow emails to be sent from your `support` and `no-reply` email addresses.\n\n### Why is the test emails not being sent successfully?\n\nYour SMTP email settings are incorrect or the mail server is refusing emails coming from your Moodle site. Read the whole communications dialogue that is displayed when you send a test message. It will often provide some hint of where the problem might be.\n\n### What is the difference between PHP Mail and Moodle SMTP Mail?\n\nIf you don't configure the mail settings in Moodle, Moodle will hand off the delivery of email to PHP's built-in mail system. Its settings are typically in your server's PHP.INI file. If you do configure the SMTP settings in Moodle, it will attempt to deliver emails directly to the local SMTP server.\n\n### How can I use this tool to send emails from other email addresses?\n\nYou can't. This is to prevent the tool from being used to send spam. If you really must, you can temporarily test the email address of one of the following \"From\" addresses:\n\n* Your user account\n* Support\n* No-reply\n* Primary admin\n\n### My email used to work in Moodle previous to 3.2. After upgrading to Moodle 3.2 or later, why can't my site send emails?\n\nAs of Moodle 3.2, use of the no-reply email address is no longer optional in many cases. You will need to make sure it is now configured correctly. Some mail server may even only permit connections if this is actually a valid email address.\n\n### Why do I see a message about cron not having run for at least 24 hours?\n\nIMPORTANT - See https://docs.moodle.org/en/Cron . If a link is included within the message, clicking it will cause Moodle to try sending queued messages immediately. However, future message will still not be sent automatically. Clicking the link instead of configuring cron will just hide the notice for 24 hours after which it will return until you fix this issue.\n\nIf for some reason you are unable to setup an automated cron job and don't see the link, you can enable the link and allow remote running of the cron job by going to Site administration \u003eSecurity \u003e Site Policies and unchecking **Cron execution via command line only**. For a little extra security, also set a **Cron password for remote access**.\n\n### Why do I see some debugging code in the communications log even though debugging is turned off?\n\nMoodle does some validation before sending an email and can display some useful information so we've enabled some minimal display of debugging information. Informative lines start with **email_to_user**. You can ignore the line number references that follow the information line.\n\n### Regardless of which \"from\" email address I use, the test email always arrives from the same email address. Why?\n\nThis is likely a setting in your mail server. To confirm which email address was used to send the email, look at the bottom of the status message after you try to send the email. If the test email was successfully delivered, you can also try to reply to the test message and take a look at the To email address. There is no need to actually send the reply.\n\n### I am not sure if the problem is with Moodle, my mail server or my firewall. What should I do?\n\nFirst, the problem is very unlikely to be Moodle. Moodle is used by organization in virtually every country of the world. If there was a problem, someone would have spoken up by now. That said, it could be your email settings. To find out if it is potentially your Moodle settings or firewall, or if it is you mail server, try setting Moodle up to use Gmail as your email server. If it works, it is very likely your email settings. If it doesn't, you might have a firewall blocking email traffic or your email server is incorrectly configured.\n\n### How can I use Gmail to send SMTP emails from Moodle?\n\nGmail requires that you create an [App Password](https://support.google.com/mail/answer/185833?hl=en) to send email for Moodle.\n\nFor more details as well as some of the limitations, see the Moodle documentation on [Email Setup Gmail](https://docs.moodle.org/en/Email_setup_gmail).-\n\n### All the settings seem to be correct. What else can I try?\n\nDespite your best efforts, sometimes you will find that a :port Number needs to be added after the address of the SMTP server. Example: smtp.example.com:587\n\n### Are there any security considerations?\n\nUse of this plugin is restricted to Moodle Site Administrators and allows them to submit an email through a restricted web form that only they can access.\n\n## Other questions\n\nGot a burning question that is not covered here? If you still can't find your answer, submit your question in the Moodle forums or open a new issue on Github at:\n\nhttps://github.com/michael-milette/moodle-local_mailtest/issues\n\n[(Back to top)](#table-of-contents)\n\n# Contributing\n\nIf you are interested in helping, please take a look at our [contributing](https://github.com/michael-milette/moodle-local_mailtest/blob/master/CONTRIBUTING.md) guidelines for details on our code of conduct and the process for submitting pull requests to us.\n\n## Contributors\n\nMichael Milette - Author and Lead Developer\n\nBig thank you to the following contributors. (Please let me know if I forgot to include you in the list):\n\n* laurentdavid: Fixed deprecated strings in Moodle 4.4 (2024).\n\n## Pending Features\n\nLet us know if you have any suggestions.\n\n[(Back to top)](#table-of-contents)\n\n# Motivation for this plugin\n\nThe development of this plugin was motivated through our own experience in Moodle development and comments in the Moodle support forums and is supported by TNG Consulting Inc.\n\n[(Back to top)](#table-of-contents)\n\n# Further information\n\nFor further information regarding the local_mailtest plugin, support or to report a bug, please visit the project page at:\n\nhttps://github.com/michael-milette/moodle-local_mailtest\n\n[(Back to top)](#table-of-contents)\n\n# License\n\nCopyright © 2015-2025 TNG Consulting Inc. - https://www.tngconsulting.ca/\n\nThis file is part of MailTest/eMailTest for Moodle - https://moodle.org/\n\neMailTest is free software: you can redistribute it and/or modify\nit under the terms of the GNU General Public License as published by\nthe Free Software Foundation, either version 3 of the License, or\n(at your option) any later version.\n\neMailTest is distributed in the hope that it will be useful,\nbut WITHOUT ANY WARRANTY; without even the implied warranty of\nMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\nGNU General Public License for more details.\n\nYou should have received a copy of the GNU General Public License\nalong with eMailTest.  If not, see \u003chttps://www.gnu.org/licenses/\u003e.\n\n[(Back to top)](#table-of-contents)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmichael-milette%2Fmoodle-local_mailtest","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmichael-milette%2Fmoodle-local_mailtest","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmichael-milette%2Fmoodle-local_mailtest/lists"}