This plugin offers you the possibility to show people accessibility configurations in your menu. This means that everyone, including people with disabilities, will be able to configure the settings (contrast, font-size, coloration, …) that help them be able to use your website.
In order to make the plugin works, you need to create a menu first.
In your menu, you simply need to add a CSS class in this way “wpak_DISABILITY_PROPERTY”.
Where to add the CSS class mentioned above ?
– In the menu you’re in (Appearance > Menus > name_of_your_menu), you first click on an item you want to have the ability to change the state (accessibility menu item).
– Then, you should have the field “CSS Classes (optional)”. Inside this field, you can add the class in this way : “wpak_DISABILITY_PROPERTY” (see examples from the pre-configured classes below).
– If the field “CSS Classes (optional)” is not visible, you just have to look for the “Screen Options” button in the top-right corner of the page. Then, search for the checkbox “CSS Classes” which should be checked in order for the field to be visible. Finally, return to the field and add your class.
List of the pre-configured classes
- “wpak_color_normal” (normal state)
- “wpak_color_dark” (dark mode)
- “wpak_color_monochrome” (shades of gray, monochrome)
- “wpak_color_highcontrast” (high contrast)
- “wpak_color_lowsaturation” (low saturation)
- “wpak_color_highsaturation” (high saturation)
- “wpak_font_normal” (normal state)
- “wpak_font_large” (large font-size, default: 30px)
- “wpak_dyslexia_normal” (normal state)
- “wpak_dyslexia_comicsans” (Comic Sans font-family)
- “wpak_dyslexia_arial” (Arial font-family)
- “wpakReset” (reset all the filters)
Add an icon instead of text
You can use the field for the title to add HTML code. With HTML code, it is possible to add
– An image:
<img src="link_of_your_image.png" alt="name_of_property" />
– An icon from FontAwesome or any library you want to include:
<i class="fas fa-adjust"></i>
Suggested FontAwesome icons
Here is a list of the suggested icons to use for each pre-configured accessibility settings.
<i class="fas fa-adjust" title="Change the coloration of the site"></i>
<i class="fas fa-font" title="Change the font-size of the site"></i>
<i class="fas fa-pencil-alt" title="Change the font-family of the site"></i>
<i class="fas fa-text-width" title="Change the letter-spacing of the site"></i>
<i class="fas fa-text-height" title="Change the line-height of the site"></i>
- Reset button:
<i class="fas fa-undo" title="Reset all the accessibility configurations"></i>
If you want to add a link to your accessibility statement page, we recommend using this icon that displays perfectly
<i class="fas fa-child" title="Go to the accessibility statement page"></i>
Import a pre-generated menu
To import a pre-generated menu with already pre-configured accessibility settings, follow the instructions below.
- First, download the file menu-a11y.json on your computer, available in the folder SAMPLE of the plugin
- Install the plugin **Export Import Menus”, available here
- Activate the plugin
- Go to Appearance > Export/Import Menus
- Click on the tab Import Menus
- Click on Choose a file and import the menu-a11y.json file you just downloaded on your computer
- On the Menu Name field, feel free to name your menu (ex.: A11y topbar menu)
- Click on the Import Menus button
- Validate in Appearance > Menus that your menu has been imported correctly
If you want to use FontAwesome icons, install the plugin FontAwesome, available here
Overwritte accessibility settings (styles)
In the plugin directory, there’s a file SAMPLE/style-a11y.css that contains all the CSS variables used to style the different accessibility settings of the plugin. It is possible to overwritte those variables by adding this file to the root of your theme.
- You need to download the style-a11y.css
- You add the file to the root of your theme (or child-theme)
- You add this code to your style.css @import “style-a11y.css”;
This plugin was created and is maintained by WP inclusion, a glossary of Web accessibility terminologies.
This plugin is multilingual ready.
This section describes how to install the plugin and get it working.
- Activate the plugin through the ‘Plugins’ menu in WordPress
- You need to create a menu in order for the plugin to work.
- The trick is to simply add a CSS class in this way “wpak_DISABILITY_PROPERTY” in order to add custom styles to your accessibility settings.
“A11y Kit” هو برنامج مفتوح المصدر. وقد ساهم هؤلاء الأشخاص بالأسفل في هذه الإضافة.المساهمون
- Fix bug on plugin removal (deletion)
- Improve documentation (instructions) on how to configure the accessibility menu
- Add a DEMO (URL link) of the plugin to better understand the final result
- Fix the problem of displaying the documentation to WordPress.org
- Export pre-generated menu in JSON file and add it as a SAMPLE
- Documentation to import a pre-generated menu with FontAwesome icons
- Add a better documentation to the usability of the plugin
- Update the “dark mode” styles
- Update the “high contrast” styles
- Initial commit