How can we help?

My Cases

Adding an Echo360 Button to the Canvas Content Editor Toolbar
Last Updated: Mar 14, 2018 10:15AM EDT

This article applies to:  Echo360 Admins

The same type of Echo360 app you added to link Canvas Courses into Echo360 sections, can also be used to add an Echo360 embed button to content editor toolbars across courses. This allows instructors to embed Echo360 videos from their library directly into a Canvas content window for students to view.

Canvas course with Add Page window shown and Echo embed video button identified

IMPORTANT: For instructors to see the Echo360 embed toolbar button, you MUST enable Public Links for instructors in Echo360. Otherwise instructors are not authorized to generate either public links or the embed code necessary for this button to embed videos into Canvas.
In addition, like all public or embedded links to videos, the videos embedded into Canvas do NOT generate student viewing analytics. Analytics are currently tied to sections, meaning students must view media within the context of a section in order to provide instructors with student view data.

Instead of creating the app via URL (using URL/Key/Secret), you instead create the app "By XML", and then paste the properly configured XML cartridge provided by Echo360. This XML contains the placement encoding for the editor button.

The instructions below provide specific instructions for generating an XML cartridge for your CURRENT Canvas LMS configuration, then using that to create a new (second) External App in Canvas. If you are creating a NEW Echo/Canvas LTI tool configuration, see the Advanced info section later on this page.

The Advanced info for admins section at the bottom of the page describes in more detail what is happening, and provides additional options in the event those meet your needs better than the "add the embed button" instructions immediately below.

As with any LTI tool, while you can add the Echo360 App at the Course level, we strongly recommend adding it at the Account (or sub-account) level. Adding the app to the account level automatically makes it available for every course configured for the account.

These procedures must be performed by the LMS/Echo360 administrator.

To generate an XML cartridge that provides an Echo embed button

  1. Log into Echo360 as an Administrator.
  2. Select the Settings icon in upper-right of the screen.
  3. From the Settings menu, select Configurations.
  4. From the left panel, select LMS configurations as shown in the below figure.
    LMS Configurations page with settings menu and left tab navigation identified
  5. Find your existing Canvas LMS configuration.
  6. Select the LTI Config tab as shown in the below figure.
  7. Enable ONLY the Content embed button slider.
    LMS configuration page in Echo showing Canvas LTI config tab with options for steps as described
  8. Click SAVE.
  9. Click the XML tab.
    LMS Configurations page in Echo with Canvas XML tab shown with options for steps as described
  10. Click inside the XML textbox or click COPY XML. The XML cartridge text is copied to your clipboard.
  11. In a new tab or window, log into Canvas as an administrator.
    Leave the Echo360 tab/window open, as you will need to return to the LMS configuration page to also copy the Key and Secret values from the LTI tab in Echo into Canvas.
  12. Click Admin from the left, and navigate to the Account (or sub-account) that contains the courses where instructors will want to embed Echo videos into content windows.
  13. From the left side of the screen, select Settings.
  14. Click Apps from the top of the Settings page.
  15. Click View App Configurations to see the list of already installed external apps. Your existing Echo360 app for course linking should already be listed.
  16. Click + App.
    App configuration list in Canvas with Add App button identified for steps as described
  17. In the Configuration Type drop-down list at the top of the Add App dialog box, select Paste XML.
    Add App dialog box in Canvas with PasteXML selected and fields for steps as described
  18. Enter a Name for this tool. This can be anything you want but should clearly identify this as the LTI tool that provides the Echo embed button. While it will be visible for selection when adding an Assignment that uses an External Tool, if you followed the above instructions, it will NOT be visible as a selectable tool in the left panel for courses.
  19. Click into the XML Configuration section of the dialog box and press Ctrl+V or Command+V to paste the copied XML from Echo360.
  20. Go back to the Echo360 window (click the LTI tab for the Canvas configuration if necessary)and copy the Consumer Key value from Echo360, then paste it into the Consumer Key field in Canvas.
    (Tip: Click into the field, type Ctrl+A/Command+A to select all, then Ctrl+C/Command+C to copy; use Ctrl+V/Command+V to paste into Canvas.)
  21. From the Echo360 window, copy the Shared Secret value from Echo360 and paste it into the Shared Secret field in Canvas. (See above Tip for select/copy/paste.)
  22. When finished, click Submit.

You should now have two Echo360 apps in your Canvas configuration, the one that was already there, and a new one to enable the Echo embed button for embedding Echo360 videos into content windows. Both link to the same Echo360 institution, and use the same URL, Key, and Secret to do so.

If you click the Info button for each and check Placements, the original one should have "Course Navigation" as the placement and the new one should have "Editor Button" as the placement.

Do you need two different tools? That depends. Read the Advanced section below to find out.

Have you disabled left navigation to Echo in order to encourage instructors to link through Assignments and generate Gradebook export data? If so, one benefit of having an Echo360 app that does NOT have "course navigation" as a placement is that the link still appears in the External Tools list for Assignments links (in addition to the Echo button for content editors) but will not appear in the left panel so it would not have to be manually disabled. This means students would not be able to click the Echo link on the left to access their Echo sections, and would instead do so through their course Assignments page. In this case you may want to delete the old Echo360 app in favor of the new one, but READ BELOW BEFORE YOU DO THAT! Please?

Advanced information for admins

Prior to making the Echo editor button available, the only "placement" available for an Echo LTI tool was "Course Navigation." In Canvas, this means, "it will show up in the left navigation for all courses in the Account unless otherwise hidden from course navigation."  This is the default behavior for many LTI tools created using strictly the Key, Secret, URL method.

Echo360 has now provided a way to enable a content editor button as a placement option, but this requires that the LTI tool be created using the "by XML" method. The XML contains parameters that give specifics about the "placement" of the tool/link (where it should show up).

If Canvas allowed admins to simply edit the existing tool to add the XML information to the configuration, you would not need to create a new one just to get the editor button. But it doesn't. In order to provide the new, additional placement for the tool, you have to create a new tool "by XML" to identify the new placement. The above instructions are for creating a new Echo360 app that ONLY provides an editor button (so that you do not have two Echo360 links in the left panel).

Now you may have noticed that the LMS Config tab in Echo360 contained TWO sliders: Course Navigation and Editor Button. If you enable BOTH of these sliders, the resulting XML contains both placements. This will allow you to create a new Echo360 App in Canvas, using the XML, that provides both course navigation and editor button placements. In this case you CAN delete the old one and simply use the new one.

HOWEVER...BEFORE YOU DO THAT...BE SURE YOU UNDERSTAND THE FOLLOWING...

Since you simply updated the existing LMS configuration in Echo360 with the new placement information, the LTI tool URL remains the same. This means that any and all existing links into Echo360 from Canvas will continue to work exactly as they did before. They will still link to the configured Echo360 sections and/or classes even after replacing the old App with the new one.

What is unknown, however, is whether or not student actions INTO Echo through the existing links (specifically those configured on the Assignments page of a course) will retain the "click-through" information for each student. This is important if your instructors are exporting Echo360 analytics into their Canvas gradebook. It is especially important if instructors use multiple links into different classes to track student activity, engagement, and participation. If the click-through information is not retained, then exports to gradebook for students may not show any student involvement at all, even though Echo360 shows they did view those classes.

If your instructors are not using Assignment links for gradebook exports, or are solely using the Echo link on the left navigation panel to access Echo360 sections, you can freely replace the old Echo360 tool with a new one (configured by XML). You may also choose to do this between terms, when you know that any existing Assignment links are no longer being used for gradebook exports (or are deleted with the courses).

The following instructions are an abbreviated version of the above steps, with specifics for creating a replacement Echo360 App that includes the Editor Button as well as Course Navigation.

Creating a NEW Canvas to Echo360 integration? If this is your first time setting up an Echo360 LTI tool in Canvas, and you want the Echo tool to be available both for courses and as a button for embedding Echo360 videos into content windows, use the below instructions to create your Echo360 App in Canvas. No need to replace one if it didn't exist in the first place!

To replace an existing Echo360 app with a new one

  1. Log into Echo360 as an Administrator.
  2. Select the Settings icon in upper-right of the screen.
  3. From the Settings menu, select Configurations.
  4. From the left panel, select LMS configurations as shown in the below figure.
  5. Find your existing Canvas LMS configuration.
    If this is your first Echo/Canvas configuration, you may need to create one. See Configuring LMS Integration for instructions if necessary.
  6. Select the LTI Config tab.
  7. Enable BOTH the Course navigation and Content embed button sliders.
  8. Click SAVE.
  9. Click the XML tab.
  10. Click inside the XML textbox or click COPY XML. The XML cartridge text is copied to your clipboard.
  11. In a new tab or window, log into Canvas as an administrator.
    Leave the Echo360 tab/window open, as you will need to return to the LMS configuration page to also copy the Key and Secret values from Echo into Canvas.
  12. Click Admin from the left, and navigate to the Account (or sub-account) that contains the courses from which instructors will want to link to Echo360 sections.
  13. From the left side of the screen, select Settings.
  14. Click Apps from the top of the Settings page.
  15. Click View App Configurations to see the list of already installed external apps. If applicable, your existing Echo360 app for course linking should already be listed.
  16. Click + App.
  17. In the drop-down list at the top of the Add App dialog box, select Paste XML.
  18. In the Add App dialog box, enter a Name for this tool. This can be anything you want but should clearly identify this as the External Tool for linking to Echo360 content.
  19. Click into the XML Configuration section of the dialog box and press ctrl+V (Windows) or command+V (Mac) to paste the copied XML from Echo360.
  20. Go back to the Echo360 window and copy the Consumer Key value from Echo360, then paste it into the Consumer Key field in Canvas.
  21. From the Echo360 window, copy the Shared Secret value from Echo360 and paste it into the Shared Secret field in Canvas.
  22. When finished, click Submit.
  23. If this is a replacement for the existing app, find the existing Echo360 app, click the Settings icon to the right of it and select Delete.

The left navigation should now only show one Echo360 navigation option. And since the new Echo360 app uses the same URL as the old one, configured links through to Echo360 should still work exactly as they did before. Though as stated above, you may want to wait until between terms/semesters to make this change, just in case.

Content windows now also have an Echo360 button in the editor toolbar, allowing instructors to directly embed video content from their Echo360 library.

In addition, the Echo360 tool will appear in the External Tools list for Assignments. Remember that linking to Echo360 through the Assignments page allows instructors to export Echo360 Analytics to their Canvas gradebook. And students MUST access Echo through the Assignments links at least once in order to get credit (and exported data) for each link.

c9f5f1d87ac29bd0c146e9565da3c739@echo360.desk-mail.com
https://cdn.desk.com/
false
desk
Loading
seconds ago
a minute ago
minutes ago
an hour ago
hours ago
a day ago
days ago
about
false
Invalid characters found
/customer/en/portal/articles/autocomplete