Integrating with Moodle - best practices


This document and video goes over some best practices to consider when setting up your Moodle LMS with MediaCore. Throughout this document you will find tips on the following topics:

  • How to set up single Moodle instances with your MediaCore site.

  • How to set up multiple Moodle instances with your MediaCore site.

  • How to auto-create collections within MediaCore when uploading content directly from Moodle.

  • How to give LTI users access to a specific collection, or set of collections.

  • Assigning roles and permissions to your LTI users to control access rights such as viewing and creating media.

  • How to properly install and use the Moodle plugin, also referred to as the Chooser

1) Set up an LTI Consumer within MediaCore

To get started, click on the Cog icon on the right side of the site header bar, and select Settings.
save image
  • Select "Authentication" > Configure LTI Consumers".

    save image

  • Next, click on the "Add New" button and enter a Consumer Key and Shared Secret of your choice. These keys will also need to be added to your Moodle plugin settings (See Section 6 below for more information).

For more detailed instructions check out our support article

2) Decide which collections of media your LTI users will have access to

A good way to start is to create a parent collection which will house all of your Moodle courses. It is important that this collection does not inherit any permission schemes on the rest of your MediaCore site. To do this:


  • From the left sidebar of the "Library" tab, we recommend creating a collection called Moodle Collection_semester_year. Once you've created the collection, you can drag it to the appropriate location under the top level collection.


  • Select the new "Moodle Collection" and then click the "Manage" link in the right sidebar to manage its permissions.

  • Uncheck the "Automatically include members from..." checkbox so that this collection does not inherit any permissions from the root.



  • If you need to migrate your course content between different semester contact us for information on migrating your courses.

Now head on back to the "Configure LTI Consumer" settings page from above, and do the following:

  • Check the checkbox beside "create a collection for each new LTI context" at the bottom of the page.

  • And then, choose the "Moodle Collection" you created above as the place where your Moodle courses will be auto-created.

  • This will ensure that any Moodle courses you use the MediaCore Chooser from will be automatically created as collections inside the parent "Moodle Collection".


save image

If you would like to give your Moodle users access to other collections in MediaCore, you can check these off under the "Assign to collections" list. Note that all Moodle users will have access to each collection you select in this list. Access will not be course specific and will be global to your Moodle site. 

You may also want to restrict access to public or registered user collection. To do this, deselect the "Also include collections shared with the public and registered user groups". This will ensure that Moodle users do not see collections that "public" or other "registered users can see.

You can also give individual Moodle users and groups in Moodle access to additional collections. Click here to learn how.

3) Edit user roles to control permissions

LTI security roles allow you to specify exact permissions (ie. viewing, creating, etc) for each LTI role that will access your MediaCore site from your LMS.


  • Click on "Authentication" and select "Configure LTI Security Roles"

Note that currently Moodle only supports three LTI roles: Administrator, Instructor, and Learner. Therefore, only one of these 3 roles will be passed to MediaCore when authenticating with MediaCore. Specifically:                                    

  1. If a user is the Moodle site Administrator, their LTI Role is "Administrator"                     

  2. If a user is a teacher and can manage a course, their LTI Role is "Instructor"                

  3. If none of the above, their LTI Role is "Learner". This role is typically a Student.

  • Click "Edit" next to each of the roles above that you wish to change permissions for. By default "Learners" can crate and upload media but that cannot publish. All of their uploads will be saved as drafts fro you to review and publish. If you want them to be able to publish media, then check off the box next to "publish media".  Check out our support documentation for more information.

If you neglect to give a user role either View or Create media permissions then they will be unable to access the Chooser. when they click on the MediaCore logo to open the Chooser they will receive a message that read "Access Denied". For more details click here

4) LTI Users and Groups in MediaCore

For each one of your course collections at least one LTI group will automatically be created in the Groups pane of your MediaCore site. The group will appear with the name of your course collection. You'll notice that some LTI collections have multiple groups created for them, this is because you have users with different roles logged into this collection. In the screenshot below you'll notice that there are 2 collections for "Applied Finance Project" - one for the instructor role and one for the learner role. Each user that has viewed this course with a particular role will automatically be added to the appropriate group. You can see the number of users in each group next to the group name.

To access the "Groups" page in MediaCore navigate to "Site Settings"  and click on "Groups". To change the role associated with a group click on "Edit" next to the group name and choose a new role from the dropdown menu. 

Alternatively, you can navigate to "Library" > select the collection this group belongs to > click on the cog next to the collection and select "permissions". From here you can delete the group and re-add it with another MediaCore role.

This shot shows the default roles assigned through LTI:

Below shows the new role you selected from your existing MediaCore roles:
5) Configure your LTI consumer within Moodle


  • Un Moodle navigate to: Settings > Site Administration > Plugins > Local plugins > MediaCore package config

  • Enter your MediaCore URL

  • Set your MediaCore LTI Consumer Key to match the consumer key you set up in MediaCore

  • Set you MediaCOre LTI shared secret to match the shared secret you set up in MediaCore

  • For information on how to setup your LTI consumer in MediaCore, see here

You also have the option to disable LTI from this page if you'd prefer to use InCommon or Active Directory as your authentication method inside Moodle. To do this uncheck the box next to "Use LTI authentication?".


6) Moodle Course Migrations

We support Moodle course migration which gives schools and organizations the ability to transfer their Moodle course content from one semester to the next. In order to facilitate Moodle course migrations an administrator will need to provide us with the course migration information in the form of a comma separated value (CSV) file.

Please contact us for more information. If you plan to take advantage of this feature we recommend that you give all of your Moodle courses unique course IDs containing the course name and year. An example of a properly formatted course id: ABC_SCI_2014_15

7) Embedding your MediaCore site into Moodle
  • Log into Moodle as an admin and navigate to a course page or stay on the main page if that's where you want the link to appear.

  • Next, "Turn Editing on" and click on "Add an activity or resource". Select "External Tool" and click "Add".

  • Fill in the activity name, add a link to your MediaCore site in the Launch URL field, fill in the "Consumer Key" and "Shared Secret" fields and click "Save and Display" .

  • You will see a green check mark appear next to the URL if you are successful.

For more detailed instructions consult our support pages


8) Download and install the plugin

The MediaCore plugin for Moodle allows you to embed your MediaCore videos, MS docs, images, PDFs and audio files into Moodle effortlessly. The video below walks you through the steps involved in downloading and installing the plugin.


  • Click here to download the MediaCore plugin code.

  • If you're running Moodle V2.3 read the document carefully and ensure that you're copying the correct code over for the TinyMCE.

  • Follow the instructions laid out in the README document to first remove the old plugin code (if required), and then install the new plugin code.

Once you're done, make sure the following plugins are shown as being installed:           

  1. MediaCore Media Filter                                                                                                            

  2. MediaCore search                                                                                                                     

  3. MediaCore Chooser/Media picker                                                                                           

  4. MediaCore package config

If they are not all installed return to the README doc to see where you went wrong. Click here for full instructions and a support video on installing the plugin.    

9) Upload media to a course page using the Moodle plugin (Chooser)         

The Chooser let's you upload large video, audio, documents or image files (up to 20 GB) into Moodle to be stored in your MediaCore library. You can also use the Chooser to add content already housed on your MediaCore site into Moodle. The video below walks you through the steps involved in uploading media using the Chooser.
  • Open your TinyMCE by adding a page, new topic, etc.

  • Click on the MediaCore logo and the Chooser will pop-up.


  • To upload a video from your MediaCore library click on the "Add" button next to the video.

  • To upload a media file from your computer into Moodle click on "Upload" and select a file from your computer. Enter the necessary details and click "Publish" once it's finished uploading.

  • The video will appear within your Moodle TinyMCE. Fill in required details and publish the video to your course page.

For detailed instructions and screen shots check out our support article.
Note: If you come across a login screen for one of your embedded videos it means you have not given LTI users access to that media item. Navigate to your MediaCore site and edit your consumer key to give users access. 

For more detailed instructions and screen shots visit our support page


Nov. 02, 2015