Skip to content

MH-Accessibility Pro – Documentation

MH-Accessibility Pro is an all-in-one solution for digital accessibility in WordPress.

1. Overview

The plugin combines:

  • Customizable accessibility widget
  • Automatic WCAG analyzer
  • Generator for accessibility statements

The goal is to help website owners comply with WCAG, EN 301 549, and BFSG while providing users with individual accessibility options.

2. Installation

2.1 Requirements

  • WordPress 6.2 or higher
  • PHP 8.0 or higher
  • Modern theme with semantic HTML
  • Recommended: up-to-date browser (Chrome, Firefox, Safari, Edge)

2.2 Install Plugin

  • Download the plugin ZIP from your customer account
  • In WordPress backend: Plugins → Add New → Upload Plugin
  • Select the file and click Install Now
  • Then activate the plugin

2.3 Activate License

  • Navigate to: MH-Accessibility → License
  • Enter your license key
  • Click Activate
  • Status “Active” will be displayed

3. Getting Started

After activation, three modules are available:

  • Accessibility Widget
  • Accessibility Analyzer
  • Accessibility Statement Generator

All modules are ready to use immediately and can be individually configured.

4. Settings

4.1 Configure Widget

MH-Accessibility → Widget

Available options:

  • Widget position
  • Color scheme
  • Enable individual features:
    • Font size
    • Contrast
    • Text-to-speech
    • Keyboard navigation
    • Profiles (ADHD, visual impairment, etc.)
  • Multilingual support
  • Visibility per page type

4.2 Use Analyzer

MH-Accessibility → Analyzer

The analyzer checks, among other things:

  • Heading structure
  • Alternative texts for images
  • Form labels
  • Keyboard accessibility
  • ARIA attributes
  • Color contrasts

Results are categorized into:

  • Passed
  • Warning
  • Failure

Concrete recommendations are provided for each point.

4.3 Create Accessibility Statement

MH-Accessibility → Generator

The assistant creates a statement including:

  • Website description
  • WCAG compliance status
  • List of met criteria
  • Feedback mechanism
  • Responsibilities according to BFSG

The statement can be created as a page or exported.

4.4 Contrast Checker

MH-Accessibility → Contrast

  • WCAG AA/AAA rating
  • Simulate color vision deficiencies
  • Recommendations for better color combinations

5. Daily Use

5.1 Recommended Workflow

  • Create page
  • Check with Analyzer
  • Fix issues
  • Test widget
  • Update accessibility statement

5.2 Editorial Guidelines

  • Always add alt text to images
  • Use clear heading hierarchy
  • Label forms
  • Write meaningful link text
  • Provide captions for videos

6. Troubleshooting

6.1 Widget not displayed

Check:

  • Is the plugin activated?
  • Is a caching plugin used → clear cache
  • Theme overrides z-index
  • Visibility settings correct?

6.2 Analyzer shows incorrect errors

Possible causes:

  • Content is loaded via JavaScript
  • Theme uses unusual markup structures
  • Forms without visible labels

6.3 License issues

  • Domain does not match license
  • Firewall blocks API
  • Server time incorrect

6.4 Conflicts with other plugins

Known issues:

  • Page builders with custom markup
  • Cookie banners covering widget
  • Minifiers remove ARIA attributes

7. Support

  • Documentation: mh-accessibility.de
  • Support ticket in customer account
  • Email: support@mh-accessibility.de

8. Updates

The plugin is regularly updated:

  • WCAG adjustments
  • Improved checking rules
  • New widget features
  • Security updates