Section Topics
Introduction
This chapter gives instructions on how to set up a source code exclusion with a CSS selector. CSS selectors can find and filter elements by tagname
, class
, id
, and attribute
, Combine the elements as needed.
A more advanced introduction for how this works:
The Monsido api sends the parameter: source_exclude_rules
. The scanner uses these as filters to create different texts which are then processed by different modules. For example, "original" contains the original text with no filter, "pagefix" contains the text after the Monsido PageCorrect script runs, and "spelling" contains the text that remains after the crawler removes everything that is indicated by source_exclude_rules (this is the text that is used in post-processing to find spelling errors).
Instructions
From the Monsido Domain Overview (globe icon), click Settings (gear icon) at the top of the page. The Admin Settings page opens.
Note: The Settings button is only available to site admins.
Select Source Code Excludes from the menu on the left-hand side of the page.
The Source Code Excludes page opens.
Click Add Source Code Exclude.
The Source Code Excludes selection page opens.
Click to select Accessibility, Readability, or Misspellings.
The Source Code Exclude details page opens.
Short Description (required): Click in the text field and type in a short description for this excluded snippet.
Default for CMS: Click in the field and identify the CMS from the drop-down menu, if applicable.
Note: If a CMS is selected here and a domain with the same selected CMS exists on the account, the domain will automatically have the source code exclude applied to it.
Note: If you use a CMS and it is not present in the list, contact Monsido Support to see if it can be added.
Type (required): Click in the field and select the exclusion type from the drop-down menu.
Exact: Identifies and filters out all instances where the complete and exact HTML snippet appears. For example, the snippet https://www.example.com/ is an exact match for:
While these HTML snippets are NOT a match:
Regex: Identifies and filters out specific patterns of HTML through the use of regular expressions.
Contains: Identifies and filters out all snippets that contain the HTML values entered. For example, the snippet example.com is a match for these HTML values:
Value (required): Put the HTML snippet in the text input field.
Identify specific HTML snippets for the filter and enter them into the value field.
See the next section Locate HTML snippets to use in a Source Code Exclude for instructions on how to find the snippets.
Note: The Source Code Exclude is now stored on an account level but not applied to any domains. See the steps HERE to apply the Source Code Exclude to a domain.
Locate HTML Snippets to use in a Source Code Exclusion
This section gives instructions on how to locate HTML snippets that can be used to set up a source code exclusion.
Locate snippets in FastTrack:
HTML snippets that affect the website compliance level can be found in FastTrack, along with a list of the checks the snippets are flagged for.
How to find HTML snippets that affect website compliance levels:
From the Monsido Home page (the globe icon on the top menu bar), click the URL to the domain. The domain dashboard opens.
Click Accessibility (icon of a person standing with arms outstretched) on the menu bar at the top of the domain dashboard. The Accessibility page opens.
Click Fast Track, from the menu on the left-hand side of the page. The Accessibility Fast Track page opens.
Copy the HTML snippets to include and paste them into the form for Source Code Excludes.
Locate snippets in Accessibility Page Details:
From the PageDetails section for any page within Monsido, click Accessibility (icon of a human with outstretched arms) on the top menu bar:
Snippets with potential errors are listed in the panel on the right side of the page.
Copy the HTML snippets to include and paste them into the form for Source Code Excludes.
Note: The Source Code Exclude is now stored on an account level but not applied to any domains. See the steps below for instructions on how to apply the Source Code Exclude to a domain.
Advanced CSS Target Selector Instructions
The Monsido scanner uses jsoup "select” to find source code snippets:
To find elements, refer to this external source: selector-syntax and then use the Source Code Exclude function to remove the elements from the HTML.
Note: This is almost identical to the:
Find and filter elements by tagname
,class
, id
, and attribute
. It is also possible to combine elements in this way.
Anything in the front-end field CSS Target Selector is sent to the scanner as the value that is passed on the jsoup select
.
The API sends the parameter source_exclude_rules
and the scanner uses these asbfilters to create different texts for processing by different modules.
For example,
"original" contains the original text with no filter.
"pagefix" contains the text after the Monsido PageCorrect script has run.
"spelling" contains the text after the scanner removes everything that is indicated by the source_exclude_rules.
Note: This is the text that is used in post-processing to find spelling errors.
Apply the Source Code Exclude to a Domain
This section gives instructions on how to apply a source code exclusion to a domain.
From the Monsido Domain Overview (globe icon), click Settings (gear icon) at the top of the page. The Admin Settings page opens.
Note: The Settings button is only available to site admins.
On the same row as the domain to scan, click Action.
In the drop-down list, select Edit Domain.
The Edit Domain page opens.
Locate the Features section.
Source Code Excludes: Click the drop-down arrow and select the domain that contains the source code.
Additional Information
For more information about the topics covered in this chapter, see also:
Useful external sources:
For further assistance, contact the Monsido support team at support@monsido.com or via the Monsido chat and help features inside the application.
Contact us:
Monsido, Powered by CivicPlus
San Diego, CA, USA
5880 Oberlin Dr,
San Diego, CA 92121, USA
Australia & New Zealand
Suite 2.04
80 Cooper St
Surry Hills, NSW 2010
Copenhagen, Denmark
Borupvang 3
2750 Ballerup, Denmark
London, UK
14 New Street
London, EC2M 4HE