- Basic Overview
- Requirements
- Download Category List for Moodle
- Installation
- Usage
- Updating
- Uninstallation
- Limitations
- Language Support
- Frequently Asked Questions (FAQ)
- Contributing
- Motivation for this plugin
- Further information
- License
The Category List plugin for Moodle displays a list of top level categories.
This plugin requires Moodle 3.7+ from https://moodle.org .
If you roll it back to the Initial Commit using Git, it may work with previous versions of Moodle all the way back to Moodle 2.7 but was only tested with Moodle 3.0. If it works for you, let us know. Tip: You might need to modify the version.php in order for Moodle to let you install it on earlier versions than 3.0.
The most recent STABLE release of Category List for Moodle is available from: https://moodle.org/plugins/block_category_list
The most recent DEVELOPMENT release can be found at: https://github.com/michael-milette/moodle-block_category_list
Install the plugin, like any other plugin, to the following folder:
/blocks/category_list
IMPORTANT: The there are different branches for different Moodle releases. You must choose a branch which is the same or closest lower for your version of Moodle. Example, choose MOODLE_37_STABLE for Moodle 3.8.
See https://docs.moodle.org/en/Installing_plugins for details on installing Moodle plugins.
Works just like the Courses block but only displays Categories.
There are no special considerations required for updating the plugin.
The first public BETA version was released on 2016-12-05. 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 > Category List
...and click Uninstall. You may also need to manually delete the following folder:
/blocks/category_list
There are no known limitations.
This plugin includes support for the English language. Additional languages including French are supported if you've installed one or more additional Moodle language packs.
If you need a language that is not yet supported, please contribute translations using the Moodle AMOS Translation Toolkit for Moodle at https://lang.moodle.org/
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 - block_category_list Martin Dougiamas - Author and Lead Developer of the block_course_list plugin upon which this is based.
Eventually I would like to see a configurable setting added to the course_list plugin making this plugin obsolete.
If you would like to see this happen as well, consider contributing or hiring us to accelerate development.
The initial development for this project was sponsored by the kind folk at l'Action ontarienne contre la violence aux femmes together with TNG Consulting Inc.
For further information regarding the block_category_list plugin, support or to report a bug, please visit the project page at:
https://github.com/michael-milette/moodle-block_category_list
Copyright © 2016-2020 TNG Consulting Inc. - https://www.tngconsulting.ca/
This file is part of Category List plugin for Moodle - https://moodle.org/plugins/block_category_list/
Category List 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.
Category List 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 Category List. If not, see https://www.gnu.org/licenses/.