Hub administration

Community hubs


Contents


Deciding to run a Hub

Running a hub server is not something you should undertake lightly.

As the hub administrator we are responsible for the content in the hub, and you need to put in place processes to:


Minimal Requirements

Below is a list of Minimal requirements for running a Moodle Community Hub.


How the hub software works

The hub software is implemented as a separate "local" plugin designed to be added to a standard install of Moodle 2.x. In this way the hub gets to use on all the features in the Moodle core API and benefits from maintenance of the core code.

Once installed the whole site gets a new frontpage with a simple search box (see http://hub.moodle.org/ for example).

Please don't add the hub capabilities to an existing Moodle site with real courses. Although it may work, there are some opportunities for GUI confusion and some unknowns when it comes to security, so please just avoid it. Moodle is free, so it's trivial to install another clean copy to build your hub with.


How to set up a Moodle Hub server

  1. Install the latest stable version of Moodle somewhere on a web server with a nice URL.
  2. Download the latest hub plugin from https://github.com/moodlehq/moodle-local_hub
  3. Save the zip into the /local directory of Moodle and unzip, producing /local/hub
  4. Visit the "Notifications" page in Moodle (/admin) to complete the upgrade and install the hub software.
  5. Uncheck password policy (search 'passwordpolicy' in admin search)
  6. Allow extended characters in usernames (search 'extendedusernamechars' in admin search)
  7. Enable web services for the hub (Administration > Site Administration > Advanced features)
  8. Enable the XML-RPC protocol (Administration > Site Administration > Plugins > Web services > Manage protocols)
  9. Set up the SMTP (Administration > Site Administration > Plugins > Message outputs > Email)
  10. Set up the recaptcha (Administration > Site Administration > Plugins > Authentication > Manage authentication)
  11. Set up your hub (Administration > Site Administration > Hub > Settings) Supply a description, enable the hub, supply a hub password.

Congratulations! You now have a working hub with no content!


Site registration

Only sites that are registered with the hub are allowed to publish content there.

Sites register on the hub via Administration > Site administration > Server > Hubs.


Hub registration

We can also register your hub with the Moodle Hub Directory, enabling people from all over the world to find your hub and search the courses within it. Your registration will be approved when your hub contains some courses.


Managing sites

In Administration > Site administration > Hub > Manage sites, we can:


Managing courses

In Administration > Site administration > Hub > Manage courses, we can:


Important things about roles, users and web services

A hub server uses Web services a lot. For this reason it is important to understand the web services administration, and what happens if you change some roles/users/services.


Roles

The hub server creates on the fly some roles that you should never delete/modify:


Users

The hub server creates on the fly some users that you should never delete/modify:


Services

The hub creates during installation some web services that you should never delete/modify:

It also creates tokens on the fly. These tokens are not displayed on the token management list, so we cannot accidentally delete them.


See also