CQU MyMoodle

Blocks ::: block_cqumymoodle
Maintained by Catalyst IT, Marcus Boon, David Binney, Brendan Heywood
Allows staff and students to see enrolments they have in external systems (or other Moodle's). This was predominately created to allow links between archived and separated instances of Moodle, but keep the separation hidden to the users. Handy if you also have single-sign on between the systems, as it allows them to jump to external courses without having to login again.

CQU MyMoodle 1.5.0 (Build: 2016031800)

Moodle 2.2, 2.3, 2.4, 2.5, 2.6, 2.7, 2.8, 2.9, 3.0
Released: Friday, 18 March 2016, 1:24 PM

Version History

1.5.0 : Adding caching using MUC which greatly improves performance, and reduces load on linked Moodle instances.

Installation

Installation is very straight forward. Just drop the cqumymoodle folder into the path/to/moodle/blocks directory and either navigate to http://www.yourmoodle.com/admin/index.php OR run php admin/cli/upgrade.php from the command line in your dirroot.

Web Service Configuration

  1. Make sure you have webservices and REST is turned on
  • Site administration > Advanced features
  • Make sure "Enable web services" is checked
  • Site administration > Plugins > Web services > Manage protocols > Enable REST protocol
  1. Create a new user for webservice functions, if user does not exist(this is for added security)
  • Site administration > Users > Accounts > Add a new user
  • Fill in the form, and make sure "Choose an authentication method" is set to "Web services authentication"
  1. Create a custom role for webservice functions and assign the webservice user to this role
  • Site administration > Users > Permissions > Define roles
  • Add a new role > "Use role or archetype" > Set to "No role"
  • Context types where this role may be assigned, set to "System"
  • Assign the following permissions:

Permissions

moodle/user:update moodle/course:useremail moodle/course:viewparticipants moodle/course:view moodle/user:viewdetails moodle/user:viewhiddendetails webservice/rest:use

  1. Create a new external service
  • Site administration > Plugins > Web services > External services
  • Under Custom services click "Add"
  • Give it a unique name, make sure "Enabled" and "Authorised users only" is checked
  • Click "Add service"
  • Click "Add functions"
  • Search for cqu_get_user_courses
  • Click "Add functions"
  • Go back to External services, under your newly created custom service, click on Authorised users
  • Add the webservice user you created in step 2
  1. Create a token for this external service
  • Site administration > Plugins > Web services > Manage tokens
  • Click on "Add"
  • Search for the webservice user you created in step 2 in "User"
  • Choose the custom external service that you created in step 4 in "Service"
  • You can choose to configure "IP restriction" and "Valid until" for more security

Block Configuration

Note: You may add this block wherever blocks are allowed but for the sake of this tutorial, we are going to assume that you are adding it to the /my page and have configured your site to go to /my instead of /index.php or SITE

  • Site adminsitration > Appearance > Default My home page
  • Turn "Blocks editing on"
  • Add block of type "CQU MyMoodle"
  • Move it to wherever you want to on the page
  • Edit the block settings (click on the hand icon or gear icon)
  • Give the block a unique name
  • For Endpoint, the normal path is "www.yourmoodle.com/webservice/rest/server.php"
  • "External Moodle" is checked if we are connecting to another Moodle site that also has this block installed
  • WebService Token, is the token we created in the Web Service configuration steps above

Version information

Version build number
2016031800
Version release name
1.5.0 (Build: 2016031800)
Maturity
Stable version
MD5 Sum
d3fb379567d29a9dc544b6e8310e5a88
Supported software
Moodle 2.2, Moodle 2.3, Moodle 2.4, Moodle 2.5, Moodle 2.6, Moodle 2.7, Moodle 2.8, Moodle 2.9, Moodle 3.0
  • Latest release for Moodle 2.2
  • Latest release for Moodle 2.3
  • Latest release for Moodle 2.4
  • Latest release for Moodle 2.5
  • Latest release for Moodle 2.6
  • Latest release for Moodle 2.7
  • Latest release for Moodle 2.8
  • Latest release for Moodle 2.9
  • Latest release for Moodle 3.0

Version control information

Version control system (VCS)
GIT
VCS repository URL

Default installation instructions for plugins of the type Blocks

  1. Make sure you have all the required versions.
  2. Download and unpack the block folder.
  3. Place the folder (eg "myblock") in the "blocks" subdirectory.
  4. Visit http://yoursite.com/admin to complete the installation
  5. Turn editing on in any home or course page.
  6. Add the block to the page
  7. Visit the config link in the block for more options.