Upgrading custom websites that are using the Constellations template

Note: The following information is meant for those currently using iMIS 2017 and are in the process of upgrading to iMIS EMS.

The iMIS EMS Staff site navigation was enhanced in February 2023 with the following:

  • A collapsible navigation, allowing staff users to utilize more horizontal space on the screen.
  • Updated icons that are powered by out-of-the-box CSS classes. These CSS classes, in addition to several other new classes, are only available with the Orion theme.

These enhancements required many changes to the Constellations template; therefore, to accommodate those using the Constellations template with a custom website, the Constellations_Classic template was created.

Custom websites using the Constellations template must be updated to use the Constellations_Classic template to avoid upgrade issues.

How do I know if this affects me?

Do the following from the iMIS 2017 Staff site to determine if this change affects your websites:

  1. Go to RiSE > Site Builder > Manage websites.
  2. Select a custom website. A custom website is any website that is not an out-of-the-box website.
  3. Click the Look and feel tab.
  4. Expand the Advanced section.
  5. Review the template selected in the Template (master page) drop-down. If the selected template is Constellations, then this change affects the selected website.
  6. Continue that process for each custom website.

What should I do before upgrading?

Before upgrading, it is recommended to update all custom websites using the Constellations template to use the Orion theme. Do the following to change the theme prior to upgrading:

  1. Go to RiSE > Site Builder > Manage websites.
  2. Select the website.
  3. Click the Look and feel tab.
  4. Expand the Advanced section.
  5. From the Theme drop-down, select Orion.
  6. Click Save.
  7. Click Publish.

What should I do after upgrading?

After the upgrade, you can update the Theme and Template for the custom websites back to their pre-upgrade state.

Do the following:

  1. Go to RiSE > Site Builder > Manage websites.
  2. Note: If you did not update the website theme before upgrading, you may be unable to access Manage websites using the navigation. Use this link by replacing WEBSITENAME with the name of your website: https://WEBSITENAME.com/Staff/iMIS/ContentManagement/WebsiteList.aspx

  3. Select the custom website.
  4. Click the Look and feel tab.
  5. From the Website theme field, select the desired theme.
  6. Click Advanced Options.
  7. From the Template (master page) drop-down, select Constellations_Classic.
  8. Click OK, then click Save.
  9. Click Publish.

What else do I need to do?

The Constellations_Classic template will be deprecated in the future, so it is important to add all theme customizations to the website’s Custom CSS button and update the template to Constellations.

Important! Custom CSS may need to be updated, because of the many changes to the navigation’s markup and the related CSS selectors.

Example: The Staff site navigation background color is currently red (#c00). The CSS needs to be added to the Custom CSS button, so the template can be updated to Constellations.

Do the following to update the navigation background color:

  1. Go to RiSE > Site Builder > Manage websites.
  2. Expand the Core Sites folder, then click the Staff site.
  3. Click the Look and feel tab, then click Custom CSS.
  4. Add the following to the textbox:
  5. Copy
    .col-secondary,
    .sub-nav-body .RadTreeView_Orion ul.rtUL ul.rtUL,
    .sub-nav-body .RadTreeView_Orion > .rtUL > .rtLI > div.rtSelected,
    .sub-nav-body .RadTreeView_Orion > .rtUL > .rtLI > div.child-is-selected-wrapper,
    .sub-nav-body .RadTreeView_Orion > .rtUL > .rtLI:hover > div {
    background-color: #c00;
    }

  6. Click OK.
  7. Click Advanced Options.
  8. From the Template (master page) drop-down, select Constellations.
  9. Click OK, then click Save.
  10. Click Publish.