Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/catalyst/moodle-tool_redirects
An admin tool enabling easy setup of redirects from inside Moodle
https://github.com/catalyst/moodle-tool_redirects
moodle moodle-plugin redirect redirect-urls
Last synced: 3 days ago
JSON representation
An admin tool enabling easy setup of redirects from inside Moodle
- Host: GitHub
- URL: https://github.com/catalyst/moodle-tool_redirects
- Owner: catalyst
- Created: 2018-01-24T00:34:12.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2024-06-11T01:13:04.000Z (5 months ago)
- Last Synced: 2024-06-11T03:11:42.684Z (5 months ago)
- Topics: moodle, moodle-plugin, redirect, redirect-urls
- Language: PHP
- Homepage: https://moodle.org/plugins/tool_redirects
- Size: 52.7 KB
- Stars: 7
- Watchers: 23
- Forks: 7
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Configurable redirects for Moodle
A very simple plugin which allows admin to set redirects based on url. Redirects can
be from existing Moodle pages like from one course to another, or they can be 'vanity'
urls from non existing urls into a page inside Moodle.
## Installation
Step 1: Install the local module
--------------------------------
Using git submodule:
```
git submodule add [email protected]:catalyst/moodle-tool_redirects.git admin/tool/redirects
```
OR you can download as a zip from github
https://github.com/catalyst/moodle-tool_redirects/archive/master.zip
Extract this into /var/www/yourmoodle/admin/tool/redirects
Then run the moodle upgrade as normal.
https://docs.moodle.org/en/Installing_plugins
Step 2: Apply core patches
-------------------------------
This plugin requires [MDL-66340](https://tracker.moodle.org/browse/MDL-66340), which was added in 3.8.
You can easily backport these patches in one line for 3.5, 3.6 and 3.7:
For Moodle 3.5:
```
git apply --whitespace=nowarn admin/tool/redirects/patch/core35.diff
```
For Moodle 3.6:
```
git apply --whitespace=nowarn admin/tool/redirects/patch/core36.diff
```
For Moodle 3.7:
```
git apply --whitespace=nowarn admin/tool/redirects/patch/core37.diff
```
### Manual cherry-pick
In case the patches do not work due to an update to older Moodle branches (such as security updates), you can manually perform the cherry-picks.
For [MDL-66340](https://tracker.moodle.org/browse/MDL-66340):
```
git cherry-pick 4ed105a9fd4c37e063d384ff155bd10c3bfbb303
```
If there are merge conflicts, ensure the lines that you are adding are consistent with the lines being added inside the patch files. Everything else can safely be ignored.
Once this has been performed, you can generate your own patch files using `git format-patch`. An example for Moodle 3.5 is below:
```
git format-patch MOODLE_35_STABLE --stdout > admin/tool/redirects/patch/new_core35.diff
```
## Configuration
* Navigate to Site Administration > Plugins > Admin tools > Redirects
* Add rules. Each line should be a redirect rule like [php regex of local moodle URL to redirect from]=>[any URL to redirect to]. E.g. #/my/#=>/course/view.php?id=2
* Enable or disable redirects for administrators
If you wish to use redirects for urls which do not exist, eg /some-vanity-url then your webserver
needs to be configured to have Moodle handle error pages. Setup details are here:
https://docs.moodle.org/dev/Error_pages
## Backdoor option for Admins
Admins can bypass redirect by adding **noredirect=1** parameter to requested URL. E.g. http://moodle.example.com/my/?noredirect=1
# Contributing and Support
Issues, and pull requests using github are welcome and encouraged!
https://github.com/catalyst/moodle-tool_redirects/issues
If you would like commercial support or would like to sponsor additional improvements
to this plugin please contact us:
https://www.catalyst-au.net/contact-us
# Crafted by Catalyst IT
This plugin was developed by Catalyst IT Australia:
https://www.catalyst-au.net/
