Setting up an integration between EP and Moodle

Adding support for Moodle is a straightforward process, which normally requires a couple of hours of work by your school's IT team/LMS manager. Education Perfect's integration may differ from other integrations your school has, because we need a way to match a Moodle user to their EP account.

Get in touch with us

To get started, get in touch with our team. If you're not the person who will be configuring the integration, please also include them in the email so we know who to contact with next steps. Our team will send you a consumer and secret key pair which you can use to authenticate with us. Please let us know that you wish to integrate with Moodle!

Install the App

To install the Education Perfect Tool across the entire Site, you will need Administrator access.
First, go to Site Administration, then Plugins, then External Tool, Manage tools:
Click configure a tool manually:

Enter the following details:

In the Consumer key and Shared Secret fields, please enter the keys that we provided you.
Please note, you may need to click "Show More" to show the bottom fields.
Under Privacy, enter the following:

Additional configuration

First go to Site Administration, then Appearance, then Additional HTML. Enter the following code under Before BODY is closed:

<style>
	div.modal-dialog { max-width: 75% ! important; }
	#contentitem-page-iframe { width: 100% ! important; }
</style>

and click Save Changes

Testing out the integration

Once this has been all set up, please try to add some content in Moodle as described here. Once you get to "Select Content", we expect an error to show up stating that your account could not be found. This is perfectly normal and part of the process! Please screenshot this error and send it to us, as the information included in this will let us know what the expected identifier format is for Moodle, usually it is an email address but not always depending on your set-up.

Potential errors

If you received an error similar to A required parameter (oauth_consumer_key) was missing please check that access to https://sockets.educationperfect.com/ is allowed in your firewall

Match existing users to their Moodle accounts

If your students have already been using Education Perfect without a Moodle integration, their EP accounts will need to be linked to the unique identifier Moodle uses to confirm their identity. This enables any work that students do on Education Perfect in Moodle to be stored against their account. Often this is the user's school email address, but it can differ from school to school - the information in the error message given above helps us to work out exactly what to use. If we already have the unique identifier associated with teachers' and students' accounts, for example, because it's their email addresses, we'll match up everyone we can on your behalf. We will then send you a list of anyone we couldn't match. Once you send us the details for those people, we'll update them as well.