Adjust-All HQ

Installation Guide

1. Login to your Canvas LMS.

canvas login

2. Use the Account tool to visit your root account.

canvas login

3. Create a Developer Key

A Developer Key allows Adjust-All HQ to your Canvas LMS.

3.1 Navigate to Developer Keys

canvas login

3.2 Press + Developer Key and then select + API Key

canvas login

3.3 Fill in the Developer Key information

Fill in the Key Name and Redirect URI (Legacy) - the other values can be left blank. Press Save Key when done.

Adjust-All HQ

https://apps.etudes.org/api/lti/launch/3

canvas login

Press Save Key when done. You will then see the new key in your list of Developer Keys. Note the ID and Key - you will need to share these with us when you request your subscription.

canvas login

3.4 Make sure "Test Cluster Only" is not selected.

Check this in the developer key edit mode.

canvas login

3.5 Make sure developer key "State" is ON.

In the developer key's list the created developer key "State" should be ON. If it's not ON, change it to ON.

4. Request a subscription.

Etudes apps are made available on a subscription basis. Contact us to request a trial or yearly subscription, or to renew your subscription.

4.1 Note your Canvas LMS Account ID and Domain .

We need to know the ID of the Canvas LMS root account in which you will be using the app. This is the same account you choose to install the Developer Key.

The easiest way to find this ID is to navigate there in your Canvas LMS, and then note the URL in your browser.

canvas login

Note both the Domain portion of the URL (in this example, "canvas.myetudes.org") and the Account ID (in this example, "1").

4.2 Contact us

When you contact us to request a subscription, you will need to provide the following information:

The name of your organization

Where you are located (City, State, Country).

The timezone of your central location.

The name of the department or unit within your organization that is using the subscription.

The name, email and phone of the person responsible for the subscription.

The second set of contact information, possibly for a technical contact.

Your Canvas LMS account ID.

Your developer key ID.

Your developer key.

Your Cavnas LMS domain.

The start and length of the period you wish to subscribe to.

Email that information to us at: license.etudes.org

4.3 Wait for our subscription information email

After your subscription is entered, we will send you an email with information you will need to complete installation.

Continue with step 5 of these instructions once you get it.

5. Install Adjust-All HQ into Canvas

Now you are ready to install the app into your Canvas LMS.

5.1 Navigate to your account Settings .

canvas login

5.2 Press Apps .

canvas login

5.3 Press + App .

canvas login

If your Canvas does not show the "+ App" button, but shows this instead:

canvas login

Press View App Configurations, to get this:

canvas login

Then press + App

5.4 Fill in the Add App dialog

First change the Configuration Type to By URL

canvas login

Fill in the values as follows

Adjust-All HQ

The Consumer Key you got in the subscription email

The Shared Secret you got in the subscription email

https://apps.etudes.org/settings/lti/lti.xml

canvas login

Press Submit when complete. A course navigation titled Adjust All will then appear on all courses in the account.

Start using your new app

At this point, you are all installed. If your subscription is active, you can start using your app.

The first time you or your teachers access the app from a course in the account, Canvas will ask you to authorize the app.

canvas login

Press Authorize . This authorization is required for the app to work.

You can see the authorizations you have made in your Canvas LMS under Account > Settings in the Approved Integrations section.

canvas login

Contact us with any questions.

California, US

license@etudes.org