How do I use legacy customizations in the new sidebar?

Legacy customizations must be brought into the new customizations course in varying ways. In some cases, the content must be upgraded after migrating it.

This means that if you want the new sidebar to use the customization content that already exists in your legacy course, you will need to migrate the customization content into the new course, following the specific steps below. (Please do not import the entire legacy course into your new customizations course, as this will cause issues.)

Recorded Training

This recorded live training session will teach you how to migrate your existing Legacy Customizations for use in the New Sidebar.

After watching the introduction, the sections on upgrading content, and the two separate customizations courses section, feel free to use the video chapters (visible when you hover over the video's timeline) to jump to the topics you need for your institution's content migration!

Instructions

Content Blocks (or Syllabus Blocks)

1. In the legacy Design Tools Customizations course, edit the [Content Blocks] (or [Syllabus Blocks]) page:
   1. Use the Upgrade tool to ensure that content we will copy in the next step is ready to be utilized by the new sidebar.
   2. Switch into the HTML, and copy the HTML code for the content block(s) you want to migrate.
   3. CANCEL the changes you have made on this page, as you do not want to save the upgraded content in your Legacy Customizations course.
2. In the new DesignPLUS Customizations course, edit the [Content Blocks] page and paste the HTML code at the end of the second-to-last line of the page (so that it is still contained inside the </div> tag of the dp-wrapper).
   1. If desired, use the Action Toolbar or the Arrange Content tool to reorder the content blocks.
   2. If desired, apply titles and categories to the content blocks. Learn more in the Admin Guide: Instructions for customizing Content Blocks.
3. Save the page in the new customizations course.

Note: These steps can be applied to migrating Syllabus Blocks as well. You will copy content from the [Syllabus Blocks] page instead of the [Content Blocks] page in the legacy customizations course, and then paste them onto the [Content Blocks] page in the new course, assigning them a category of "Syllabus." (Learn more in the Admin Guide: Instructions for customizing Content Blocks.)

Template Pages, Syllabus pages, or Policies pages

1. In the new DesignPLUS Customizations course, go to the course settings and choose Import Course Content.
2. Select Copy a Canvas Course.
3. Put the legacy Design Tools Customizations course ID in the space provided and select the course.
4. Choose Select Specific Content.
5. Select the Import button.
6. Select the Select Content button in the Current Jobs queue.
7. Expand the Pages option and check the template page(s) you want.
8. Import the page(s).
9. Go to the course Pages and find the new page(s).
10. Edit the page and use the new sidebar to upgrade the content (Accessibility/Usability > Upgrade).
    1. Note: if the page's title formerly began with [Syllabus] you will need to change it to [Template][Syllabus]. For example:
       1. Title in Legacy = [Syllabus] English Syllabus
       2. Title in New = [Template][Syllabus] English Syllabus
11. Save the page.

Video: Moving Legacy Template Pages to New Customizations

HTML Snippets

1. In the legacy Design Tools Customizations course, edit the [HTML Snippets] page:
   1. Use the Upgrade tool to ensure that content we copy is ready to be utilized by the new sidebar.
   2. Copy content one of two ways:
      • If you have multiple categories (Content Blocks) of Snippets, go into the HTML and copy the HTML code for all of the Content Blocks and their associated Snippet tables.
      • If you only have Snippets in one category (Content Block), copy the row(s) in the table that contain(s) the snippet(s) you want to migrate.
   3. CANCEL the changes you have made on this page, as you do not want to save the upgraded content in your Legacy Customizations course.
2. In the new DesignPLUS Customizations course, edit the [HTML Snippets] page and either:
   • Enter the HTML view and paste the HTML code at the end of the second-to-last line of the page (so that it is still contained inside the </div> tag of the dp-wrapper).
   • Add a row to the custom snippets table and paste the snippet(s) you copied into the new blank row.
3. Save the page.

Banner Images

1. In the legacy Design Tools Customizations course, edit the [Banner Images] page and copy the image you want.
2. In the new DesignPLUS Customizations course, edit the [Banner Images] page and paste the image under the custom images heading.
3. Save the page.

Note: If you have multiple categories (Content Blocks) of Banner Images that you would like to preserve, you can upgrade the page and copy/paste the HTML, as described for Content Blocks and HTML Snippets. Just be sure to paste the HTML code at the end of the second-to-last line of the page (so that it is still contained inside the </div> tag of the dp-wrapper).

Video: Moving Legacy Banner Images to New Customizations

Color Palette

1. In the legacy Design Tools Customizations course, edit the [Color Palette] page and copy the list items you want. Each category requires two list items: a label in the first bullet, and a set of color hex codes in the following bullet. (Note: You do not need to utilize the Upgrade tool for this migration.)
2. In the new DesignPLUS Customizations course, edit the [Color Palette] page and paste the list items in the unordered list on the page.
3. Save the page in the new customizations course.

Video: Moving a Legacy Color Palette to New Customizations

 

Support Information

1. In the legacy Design Tools Customizations course, edit the [Support] page:
   1. Use the Upgrade tool to ensure that content we will copy in the next step is ready to be utilized by the new sidebar.
   2. If your support information is contained within a single content block, make sure the Content Block tool is selected in the Edit tab, and utilize the Action Toolbar to copy the Content Block. Or, if you have multiple Content Blocks, you can copy the HTML for all of them.
   3. CANCEL the changes you have made on this page, as you do not want to save the upgraded content in your Legacy Customizations course.
2. In the new DesignPLUS Customizations course, edit the [Support] page, and place your cursor inside the existing Content Block in the Rich Content Editor.
3. In the Edit tab of the Sidebar, select Content Block as the active tool, and utilize the Action Toolbar to delete the existing Content Block from the page.
4. Then, either:
   1. Paste the single Content Block in its place.
   2. Enter the HTML view, and paste the HTML code for all your Content Blocks at the end of the second-to-last line of the page (so that it is still contained inside the </div> tag of the dp-wrapper).
5. Save the page in the new customizations course.

Objectives

1. In the legacy Design Tools Customizations course, edit the [Objectives] page:
   1. Use the Upgrade tool to ensure that content we will copy in the next step is ready to be utilized by the new sidebar.
   2. Enter the HTML view, and copy the HTML for all of your categories (Content Blocks) of Objectives.
   3. CANCEL the changes you have made on this page, as you do not want to save the upgraded content in your Legacy Customizations course.
2. In the new DesignPLUS Customizations course, edit the [Objectives] page.\
3. Most likely, you do not need the two example categories of Objectives we have provided as a default (IDEA Objectives and Example Effective Teaching Standards). If not, in the Edit tab, utilize the Action Toolbar to delete those two Content Blocks. 
4. Enter the HTML view, and paste the HTML code for all your Content Blocks at the end of the second-to-last line of the page (so that it is still contained inside the </div> tag of the dp-wrapper).
5. Save the page in the new customizations course.