- Local Login plugin for Moodle
- Table of Contents
- Basic Overview
- Requirements
- Download Local Login for Moodle
- Installation
- Usage
- Updating
- Uninstallation
- Limitations
- Language Support
- FAQ
- Contributing
- Motivation for this plugin
- Further information
- License
The Local Login module for Moodle allows users, with local login accounts, such as administrators, to be able to login even if the custom login URL is pointing to some other page such as Oauth2 or other identity management system. The local login page only offers the option of logging in using a local Moodle account.
This is also an example of how to create a custom login page.
This plugin requires Moodle 3.7+ from https://moodle.org
The most recent STABLE release of Local Login for Moodle is available from: https://moodle.org/plugins/local_login
The most development release can be found at: https://github.com/michael-milette/moodle-local_login
Install the plugin, like any other plugin, to the following folder:
/local/login
See https://docs.moodle.org/en/Installing_plugins for details on installing Moodle plugins.
There are no special considerations required for updating the plugin.
There are no configurable settings for this plugin at this time.
Once installed, login to Moodle by using a URL similar to https://example.com/local/login
There are no special considerations required for updating the plugin.
The first public ALPHA version was released on 2019-12-06.
For more information on releases since then, see CHANGELOG.md.
Uninstalling the plugin by going into the following:
Home > Administration > Site Administration > Plugins > Manage plugins > Login
...and click Uninstall. You may also need to manually delete the following folder:
/local/login
If you fail to login, you will be taken to the site's normal login page.
This plugin uses language strings from the Moodle language packs.
If 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/
This 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:
https://github.com/michael-milette/moodle-local_login
There are no special security considerations for this plugin.
Got 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:
https://github.com/michael-milette/moodle-local_login/issues
If you are interested in helping, please take a look at our contributing guidelines for details on our code of conduct and the process for submitting pull requests to us.
Michael Milette - Author and Lead Developer
Let us know if you have any suggestions.
The development of this plugin was motivated through our own experience in Moodle development and comments in the Moodle support forums. It is supported by TNG Consulting Inc.
For further information regarding the local_login plugin, support or to report a bug, please visit the project page at:
https://github.com/michael-milette/moodle-local_login
Copyright © 2019-2024 TNG Consulting Inc. - https://www.tngconsulting.ca/
This file is part of Local Login for Moodle - https://moodle.org/
Local Login 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.
Local Login 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 Local Login. If not, see https://www.gnu.org/licenses/.