Moodle Site Setup

If you don’t have admin rights to your Moodle site, you won’t be able to go through these steps to get ClassCube working with every course. As an instructor, you should still be able to add ClassCube to your course using the instructions here. Or, you can check with your Moodle administrator and see if they will add ClassCube for you.

Introduction

For ClassCube and Moodle to play together, they need to be able to communicate securely. ┬áThere’s quite a bit of secure communication going on behind the scenes. Fortunately, that’s all taken care of where you don’t have to worry about it. The most you’ll need to do is create a set of keys on ClassCube and let Moodle know about them.

Creating a Key

First step is to create a key and secret so that Moodle and ClassCube can talk. This is done in ClassCube, so go ahead and open up another browser tab and head over to app.ClassCube and login.

User Settings

User name link
User name link

The screens to create a key are under your user settings. On the bottom left of the site you should see your name along with a small Gravatar image. It’ll look something like the image to the right.

Once you’ve clicked on your user settings, click on the Keys tab on the next page and you should see something like this.

Empty OAuth Keys List
Empty keys list

Your list is probably empty. That’s fine. We’ll take care of that in the next step.

Adding a Key

You should see a little green Add Key button. Click that. The next page will be a blank for where you can create a new key.

Create OAuth Key Screen

Setting Notes
Description This can be anything you want. It’s only going to show up in your ClassCube account and helps you keep track in case you have multiple keys.
Key Type You’re going to want to set this to Domain. That will let anyone from your Moodle domain use this connection. The other option would be user which would link all of the accounts with yours. Probably not something you want if you’re setting up a domain wide connection.
Domain This is the domain name of your Moodle site. When you launch content on ClassCube through your Moodle site this value is checked against the site making the request – your Moodle site – as one of the steps to validate the launch. The other validation happens with the keys that you’ll see in the next step.

Press Save to create your keys. You can always go back and edit the key set later if you need to.

Your Keys

After saving your new keys you’ll go back to a familiar screen. But this time there will be a key set in the list.

Keys List Page
Keys List Page

Moodle Setup

Now, go ahead and open up your Moodle site in another browser tab. You’re going to need the User Key and Shared Secret from the last screen in a bit and it’s much easier to copy and paste.

Adding the Tool

In Moodle, click on the Manage Tools link. It’s under Site Admin > Plugins > Activity Modules > External Tools. If you don’t see a Site Admin section you may not have access rights to do this, or you may have hidden the block.

That should take you to a screen that looks like this.

manage-tools-empty

If you already have LTI tools setup, there may be some listed under the Tools heading. That’s fine. Adding ClassCube won’t affect the other tools.

In the Tool URL field, enter https://app.classcube.com/lti-config.xml .  This is an XML file on our server that will tell Moodle how to create the tool. You can also do it manually, but nobody has time for that.

Click on the Add button and your server will think for a bit before taking you to a screen where you can enter your key and secret.

manage-tools-keys

Copy and paste your Key and Secret from the ClassCube site into these two fields and click on Save Changes. The ClassCube tool should be added to your list.

tool-added

Tool Configuration

You probably can stop here and everything would work okay. But we’re going to go through one more step to make sure everything is working like it should. Go ahead and click on the little gear icon on the top right of the ClassCube Problems box. You should go to a screen that looks like this.

tool-config

There’s a lot going on here. Fortunately, most of it you don’t have to touch.

Setting Notes
Tool Name This is the name that Moodle will use for this tool. It’s filled in for you, but if you really want to change it you can. It won’t affect how everything works.
Tool Base URL This should be set as https://app.classcube.com/p/ and needs to stay that way. It’s how Moodle knows what tool you want to use.
Tool Description Like the name, this is something that you’ll see in Moodle. You can change it if you want, or just leave it alone.
Consumer Key & Secret The key and secret that you created in ClassCube. They should already be filled in from earlier. Don’t change these unless you also create a new set in ClassCube. Otherwise Moodle and ClassCube can’t talk.
Custom Parameters Leave this blank
Tool Configuration Usage This determines how the tool shows up when a teacher uses it. You can pick which ever you’re comfortable with. Click on the little help icon in Moodle if you want to see the difference.
Default Launch Container This sets how Moodle will lauch the ClassCube page. We’ve found that Embed without Blocks looks best, although it’s just a visual setting. The connection works the same for each one.
Icon URL Moodle will use the ClassCube icon in a few places. Leave this and the secure icon url field alone so that Moodle knows where to look.
Share Name/Email with Tool In our opinion, Always is the best setting for both of these fields. That way when ClassCube creates an account for your students it can be created with their name and email address. The name and email will show up in a few places for your teachers. If you don’t send that information ClassCube will create random names and emails instead which will make it more difficult for your teachers to sort through assignments.

Delegate to teacher works as well, but it’s a pretty easy setting for a teacher to forget when they create an assignment.

Accept Grades If you want ClassCube to send grades back to Moodle, and you probably do, set this to Always. You can also leave it at Delegate to Teacher. But like the sharing settings, it’s easy for a teacher to overlook and it easier to just go ahead and set it.
Force SSL Since the Launch URL is already SSL, you can leave this either checked or not. It shouldn’t make a difference.
Organization ID/URL Not used by ClassCube, so you can leave it blank

And yes, that was a lot. But you probably didn’t touch many of the fields. Click Save.

And Done!

And that should be it. Now that the tool is saved it’s available for every teacher on your site. To see how to use ClassCube, head over to this page on creating Moodle assignments. The good news is that you can skip over the first half which goes over how to set up Moodle and ClassCube for a specific Moodle course. You don’t need to do that if you’ve already set it up for your whole site.

 

 

Discuss This

Please visit our support forums if you have questions about this page.