Total Validator
HTML5 / XHTML / WCAG / Section 508 / CSS / Links / Spelling

Using the Firefox extension

Start the Total Validator application and set the validation options in the usual way (except for the starting page). Then click the 'Listen Mode' button ready for validation requests from Firefox. This will shrink Total Validator into your System Tray.

picture of Total Validator in the system tray

Now just browse to the pages you wish to validate and click the Total Validator icon on your toolbar to start the validation. Alternatively choose 'Total Validator' from the context menu (right mouse click the page)

picture of the firefox toolbar picture of the firefox context menu

You can also hide the Total Validator button in your toolbar by right mouse clicking it, and just use the context menu option instead.

top

Extension options

To access and set the available options for the extension display the Add-ons page in Firefox (about:addons) and click the 'Preferences' button next to 'Total Validator'.

Listen port: This is set to 9889 by default. It is the 'TCP port' that the Total Validator application listens to for requests from the browser extension to validate pages. Whatever you enter here must match the value you've entered in the application. Any number in the range 1-65535 is valid, but you must choose one that does not conflict with any other service you use.

Send cookies: This is selected by default. The 'Send browser cookies to Pro application' option allows you to validate websites that are protected by a login form, by sending all the cookies for the current page (stored in the browser's cache) to Total Validator Pro. This works as follows: In Firefox log into the site you wish to check. Your browser should now hold a session cookie containing a reference to your login session. When you now use the extension to validate the current page this session cookie will be passed to the Total Validator application so that it will have access to the protected pages of the website. Make use of the 'Paths to skip' option in the application to avoid any 'log off' links.

Context menu: This is set by default and displays a 'Total Validator' option when you right mouse click any web page. You can also use this option to remove 'Total Validator' from the context menu.

Send source: The url of the current page is normally sent to the application for testing. But if the page is password protected then this may fail. In this case select this checkbox to send the source of the current web page for validation instead. Note: With this option broken links can only be checked if you have the Pro version.

Send DOM-generated source: Normally Total Validator validates the web page before any javascript has been run, which may modify the page. With this option the web page after any javascript has run is validated. Also selecting this option allows us to perform additional testing, such as contrast testing. The source in this case is not a 'real' web page but is generated from your browser's DOM, so you may see some issues that do not exist in the original web page, and line numbers will often differ. Note: With this option broken links can only be checked if you have the Pro version.

Debug: Normally this should not be selected. It should only be used when advised by Support as it will display a number of alert messages that will slow down the validation process.

Validating multiple source pages with Total Validator Pro

With the Pro version you can validate the source or DOM-generated source of as many pages as you wish on your site.

In action you will see each page being displayed in your browser in turn. On completion the original page will be displayed, and a new tab opened with the results. Note: Because the browser has to fully load each page, the whole validation will run much slower than normal.

When validating this way, you should never attempt to start a new validation whilst a current one is still executing. Use the Cancel button to cancel the current validation first, otherwise you may get unexpected and confusing results.

When validating DOM-generated source, you may need to slow the validation process down so that any initial javascript has fully run before the page source is validated. In this case use the Page pause option which will add a delay after loading each page.

top

Issues

If you have a problem that isn't covered below then complete the feedback form to report it. Don't forget to leave a valid email address where you can be contacted.

Validation failed

If this message appears then there may be a conflict between Total Validator and some other service. Use the options to select a different 'listen port'.

Could not contact the Total Validator application

If this message appears then you may have forgotten to start Total Validator, or forgotten to click the 'Listen Mode' button. Alternatively, the port you are using may already be being used by another service. In this case, select a new port number in the application and update the preferences page in Firefox as described above.

Could not retrieve source of page

If this message appears then the page you are trying to validate has unexpectedly disappeared from the web server, or is no longer visible due to authentication issues. Try repeating the validation.

Browser continues multi-page validation after cancelling it, or after an error

When validating source or DOM-generated source and you try to cancel or where some rare error situations occur, the browser may keep on validating, possibly opening up multiple tabs. Immediately close down your browser and/or Total Validator to stop this.

top