All Collections
Scanning
Source Code Exclude with CSS Selectors
Source Code Exclude with CSS Selectors
How to set up a source code exclusion with CSS selectors
Faith George avatar
Written by Faith George
Updated over a week ago

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

  1. 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.

  2. Select Source Code Excludes from the menu on the left-hand side of the page.

    Image that shows the Source Code Excludes option on the left menu bar, and the Admin Setting button on the top right corner of the page.

    The Source Code Excludes page opens.

  3. Click Add Source Code Exclude.

    Image showing the location of the Add Source Code Exclude button, on the upper right-hand side of the page.

    The Source Code Excludes selection page opens.

    Image showing the Source Code Excludes landing page.

  4. Click to select Accessibility, Readability, or Misspellings.

    Image showing the location of the Accessibility source code excludes creation button.

    The Source Code Exclude details page opens.

    Image showing the Accessibility Source Code Excludes creation page.

  5. Short Description (required): Click in the text field and type in a short description for this excluded snippet.

  6. 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.

  7. Type (required): Click in the field and select the exclusion type from the drop-down menu.

  8. Value (required): Put the HTML snippet in the text input field.

  9. Identify specific HTML snippets for the filter and enter them into the value field.

    Screenshot showing where you can create a short description, set the exclusion type, and then identify the particular HTML snippets for filtering by entering them into the value field.

  10. 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:

  1. From the Monsido Home page (the globe icon on the top menu bar), click the URL to the domain. The domain dashboard opens.

  2. 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.

  3. Click Fast Track, from the menu on the left-hand side of the page. The Accessibility Fast Track page opens.

    Image of the list of the checks that flagged the snippets for further attention.

  4. 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.

Image that shows the layout of the snippets view.
  • 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.

  1. 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.

    Image that shows the location of the Settings button, on the top menu bar.

  2. On the same row as the domain to scan, click Action.

    Image showing the location of the Actions button for a domain, on the right-hand side of the page.

  3. In the drop-down list, select Edit Domain.

    Image of the location of the Edit Domain option in the Actions menu.

  4. The Edit Domain page opens.

    Image showing the Edit Domain Features section.

  5. Locate the Features section.

    Image that shows the Features section on the page.

    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:

Contact:

For further assistance, contact the Monsido support team at support@monsido.com or via the Monsido chat and help features inside the application.

Image of the dashboard showing the locations of the Help Center buttons.

Locations:

Monsido, an Optimere brand:

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

Did this answer your question?