Siteimprove Integration

Overview

Cascade CMS's Siteimprove plugin allows existing Siteimprove customers to access the Siteimprove Intelligence Platform   from within the CMS. It enables you and your team to identify and correct accessibility issues in your editing environment as soon as a page is published.

This plugin also makes it easier for content contributors, managers, and editors to leverage Siteimprove Analytics data to create better content more efficiently. You can use the plugin to check if unpublishing a page will have an impact on your site. For example, you'll be able to see if deleting a page will affect your SEO, or if users will lose access to important documents and links.

The plugin overlays quality assurance, analytics, and accessibility data when viewing the relevant content in Cascade CMS. Overall, the Siteimprove integration provides insights into:

  • Misspellings and broken links
  • Readability levels
  • Accessibility issues (A, AA, AAA conformance level) 
  • SEO: technical, content, UX, and mobile 
  • Page visits and page views
  • Feedback rating and comments 
  • The impact of unpublishing a specific page
  • URL shortener data and its impact on your digital assets
Note: The Siteimprove service is separate from Cascade CMS and is not included with the cost of your Cascade CMS subscription.

siteimprove plugin overlay

Enabling the Siteimprove integration

At the system level

To enable the Siteimprove integration for your environment:

  1. Click the system menu button (  ) > Administration > Preferences > Integrations & Plugins.
  2. Under Siteimprove Settings enable the Enable Siteimprove Plugin option.
  3. Optionally, enable Do not include "index" in Siteimprove URLs.
    • Select this option if the index pages for your site appear as https://www.example.com/about/ in Siteimprove as opposed to https://www.example.com/about/index.html.
  4. Submit your changes.
Note - This plugin requires a secure HTTPS connection to connect and exchange information with the Siteimprove service. Please ensure SSL is configured for your instance before enabling it.

At the site level

To enable the Siteimprove integration for a site:

  1. Ensure the Siteimprove integration is enabled at the system level (see above).
  2. Navigate to Manage Site > Site Settings.
  3. Toggle the Enable Siteimprove Integration option.
  4. Submit your changes.

At the Site Role level

To enable User/Group access the Siteimprove overlay:

  1. Ensure the Siteimprove integration is enabled at the system and site levels (see above).
  2. Review the Site Roles assigned to your site under Manage SiteSite SettingsRoles.
  3. Edit the appropriate Site Role under Administration > Roles.
  4. Toggle the Access the Siteimprove integration ability.
  5. Submit your changes.

Logging into the Siteimprove integration

If you have a user account in Siteimprove, you can log into the Siteimprove overlay with your credentials after it's been enabled. Your user role and permissions in Siteimprove will determine which sites you can see data for in the overlay.

To log in to the Siteimprove integration:

  1. Navigate to an enabled site and you'll see the Siteimprove badge on the right-hand side of the interface.
  2. Click Login to log in with your Siteimprove credentials.
Note - The first login will need to be by a Siteimprove Account Owner who can accept the plugin’s Terms and Conditions. Afterwards, other Siteimprove users will be able to login with their own credentials.

Viewing Siteimprove data

Page Data

To view Siteimprove data for a page, navigate to the page within Cascade CMS and open the overlay by clicking on the Siteimprove badge. You can view data for index pages either by navigating to the index page itself or its parent folder.

If you're not seeing data for your page in the overlay, ensure that:

  • Your site been imported into your Siteimprove account.
  • The Site URL for your site in Cascade CMS is the same as the URL in your Siteimprove account. If not, set the Siteimprove URL in Site Settings.
  • Your page has been published.
  • Your page has been crawled by Siteimprove.

Publishing a page will trigger a re-check of the page by Siteimprove. You can also use the Re-check page button in the plugin to issue a manual request for Siteimprove to re-check its content.

Publishing a folder will trigger a re-check of all pages in the folder.

Site Data

To view site-level data for your site, select the Site Overview tab in the overlay. When viewing a folder that doesn't contain an index page, site-level data will be displayed by default.

Configuring your Siteimprove URL

If the URL of your site in Siteimprove is different than the Site URL of your site in Cascade CMS, specify your Siteimprove URL under Manage Site > Site Settings > Siteimprove URL.

Deeplinking in Siteimprove

To make correcting issues in your content easier, Siteimprove offers CMS Deeplinking. Deeplinking creates links to your page assets in Cascade CMS from within reports in your Siteimprove account. To do this, the Cascade CMS ID of your page assets needs to be included in the page's published source.

You can include a page's ID in your Template(s) with a simple region and Velocity format:

  1. Create a Velocity Format containing the following:

    <meta name="id" content="${currentPage.identifier.id}"/>
  2. Create a new region within the <head> tags of your Template(s). Example:

    <!-- Page ID for Siteimprove deeplinking. -->
    <system-region name="PAGE_ID"/> 
  3. Attach your Format to this new region in your Template(s).
  4. Publish all pages that use the Template(s) to ensure that your page ID <meta> tag gets included the pages on your web server.