# Ally - Web Accessibility & Usability

**Contributors:** elemntor \
**Tags:** Web Accessibility, Accessibility, A11Y, WCAG, Accessibility Statement \
**Requires at least:** 6.5 \
**Tested up to:** 6.8 \
**Requires PHP:** 7.4 \
**Stable tag:** 3.3.0 \
**License:** GPLv2 or later

Ally is a web accessibility plugin that enhances usability, offers custom controls, and auto-generates accessibility statements to help meet WCAG guidelines.

## Description

Ally (formerly One Click Accessibility) is a powerful web accessibility plugin designed to enhance usability and help websites align with WCAG guidelines. It enables custom accessibility controls and provides an auto-generated Accessibility Statement, supporting website owners in making their sites more inclusive.

# Why does web accessibility matter?

- **Who Needs It?** Every website owner—businesses, creators, and agencies.
- **Who is Responsible?** Website owners are legally and ethically responsible for accessibility. The web creator—who designs and builds the site—must implement and adjust accessibility features to ensure compliance with WCAG guidelines and provide an inclusive experience for all users.
- **Why Now?** Rising legal requirements (WCAG, EAA) and better user experience.
- **Why Should You Care?**  An accessible website isn't just ethical; it's good business. By prioritizing inclusivity, you improve user experience for everyone, boost your search engine rankings, and attract a wider audience.

# It’s the Law

As accessibility standards continue to evolve and become mandatory, it’s important to start making website adjustments to comply with fast-approaching global regulations. Among its other capabilities, this plugin lets you instantly generate your website's Accessibility Statement, which is now mandatory in most locales.

The Ally plugin is not a substitute for a thorough accessibility audit and is NOT intended to completely make your website legally compliant. However, with it, you’re one step closer to making your website inclusive to more visitors, including those with visual, auditory or cognitive challenges.

Ensuring that your website complies with all applicable accessibility requirements is your responsibility. We recommend working with qualified accessibility professionals to help achieve full compliance.

## Key Features & Benefits:

### Customization Options for Web Creators

- **Add Accessibility Statement URL**: Link an existing Accessibility Statement URL, ensuring it appears directly within the accessibility widget.

- **Generate the Accessibility Statement**: Effortlessly create your Accessibility Statement with our built-in generator without the need to search the web. Simply fill in a form with your details  and a custom Accessibility Statement will be instantly generated and placed on a dedicated page of your website.

- **Show icon / Hide icon**: Choose to show or hide the accessibility icon separately for desktop and mobile versions of the website.

- **Color Selection**:  Select the color scheme that the end-user will see when the icon is opened. This includes options for background, text, and highlight colors.

- **Icon Color**: Decide on the color of the selected icon to match your website’s branding. The same color will also be displayed in the widget’s header and footer for brand consistency.

- **Icon Positioning**: Define the position of the icon on any of the four corners of the page (top-left, top-right, bottom-left, bottom-right).

- **Icon Size**: Choose the size of the accessibility icon: Large, Medium, and Small.

- **Sitemap URL**: A default sitemap link is available in the widget to enhance the visibility of the site structure to end users. You can override the default and set any desired sitemap URL.

- **Skip to Main Content**: "Skip to Content" enables users to quickly navigate to the main content. Set to ‘On’ by default, web creators have the option to edit the anchor ID to navigate to the best location.

### Customization Options for Website Visitors

Below is a list of features website visitors can control. (Each feature may be enabled/disabled by the web creator during website setup, determining which are shown to website visitors.)

- **Hide the icon**: Allows the website visitor to turn off or hide the widget from the website interface, enabling them to use their own accessibility tools without interference.

- **Restore Defaults**: Provides a one-click option to reset all customized accessibility settings back to their default state.

- **Increase/Decrease Text Size**:  For users who have reading difficulties or low vision

- **Grayscale**: Apply a grayscale filter to the page for color blind users.

- **Contrast Scale**: A slider that adjusts between different contrast modes: Negative, High, Light, and Dark Contrast for color blind or the visually challenged.

- **Links Underline**: Underlines all links on the page to make them more visible for the visually challenged.

- **Readable Font**: Changes the font to one that is more legible for dyslexic users.

- **Sitemap**: Displays all headers, landmarks, and links in a structured list for easier navigation including for those who use screen readers.

- **Hide Images**: Hides all images on the page to reduce distractions and make the page more readable for the visually challenged or ADHD users.

- **Pause Animations**: Stops animations running on the page, helping users with ADHD or cognitive difficulties to focus on content

- **Reading Guide**: Makes the cursor bigger or turns it into a reading guide to focus on selected elements for users with reading difficulties.

- **Line Height**: Increases space between text lines to make the content easier to read for dyslexic or visually challenged users.

- **Text Align**: Allows users to align text (left, right, or center) to improve readability.

- **Focus Outline**: Enables users to see which element is currently active as they Tab through the page. Geared for keyboard-only navigation.

- **Skip to Main Content**: When users land on your site, pressing the Tab key brings the ‘Skip to main content’ link into focus. By selecting this link, users can skip directly to the main content, enabling them to quickly navigate to the main content. Useful for keyboard-only and screen-reader users.

### Premium features

These features will be available in Ally’s paid plans:

- **Screen Reader Compatibility** – Enhances support for screen reader software, ensuring visually impaired users can navigate and interact with your website more efficiently.

- **White Labeling** – Remove the Elementor logo from the widget interface, allowing full customization to match your brand’s identity and maintain a professional, cohesive look.

- **Widget Usage Analytics** – Gain insights into how visitors interact with the usability features on your site, helping you optimize the user experience and measure accessibility impact.

### Roadmap: Expanding Accessibility Features

Ally is continuously evolving to provide better accessibility tools. Future updates include:

- **Accessibility Scanner** – Accessibility Scanner (Coming Soon) – Detects and identifies compliance gaps across your site.

- **Remediation Wizard** – Remediation Wizard (Coming Soon) – A step-by-step guide to fixing accessibility gaps, with prompts and questions to help users understand and address the issues manually or automatically

- **Additional Enhancements** – Ongoing improvements based on best practices and user feedback.

These updates will help website owners and creators take greater steps toward accessibility with evolving regulations.

# Get Started Today

## Make your site more accessible with Ally!

For more information about Ally visit our [help center](https://go.elementor.com/acc-wp-repo-learn-more) If you have any questions or need support, feel free to [contact us](https://go.elementor.com/wp-repo-wp-dash-sm-contact-us/).

This plugin requires a connection to an active Elementor account in order to identify the user and provide the user with the purchased service. This connection is triggered manually by the user via the plugin’s settings panel. Learn more about our [terms and conditions](https://go.elementor.com/acc-wp-repo-term-and-conditions). This plugin uses a 3rd party service operated by Elementor.

More great features are on the horizon, so stay tuned!

More great features are on the horizon, so stay tuned!

## Related Plugins

* [Site Mailer](https://wordpress.org/plugins/site-mailer/): Effortlessly manage transactional emails with Site Mailer. High deliverability, logs and statistics, and no SMTP plugins needed
* [Image Optimizer](https://wordpress.org/plugins/image-optimization/): Compress and optimize your images, giving you leaner, faster websites. Automatically optimize any new image you upload to your site or run a bulk optimization process on all previously uploaded images.


## Installation

**Automatic Installation**

1. Install using the WordPress built-in Plugin installer > Add New
1. Activate the plugin through the 'Plugins' menu in WordPress
1. Go to the plugin page (under Dashboard > Accessibility)
1. Enjoy!

**Manual Installation**

1. Extract the zip file and just drop the contents in the <code>wp-content/plugins/</code> directory of your WordPress installation
1. Activate the plugin through the 'Plugins' menu in WordPress
1. Go to the plugin page (under Dashboard > Accessibility)
1. Enjoy!

## Frequently Asked Questions

### What is the Ally plugin?

The accessibility plugin is a free, easy-to-use plugin designed to enhance website usability for individuals with disabilities. It is designed to help web creators make their websites more inclusive, and works seamlessly on all WordPress and Elementor websites.

### Can I customize the widget's appearance?

Yes, you can fully customize the widget. Adjust the icon’s style, color, and size, and personalize the header and footer to match your site's branding. You can also choose its placement—position it in any corner, at a custom location, or hide it on mobile or desktop—and decide which accessibility features are visible to your users.

### Does the widget support multiple languages?

Yes, the widget automatically adapts to your website's language, ensuring a smooth and consistent experience for every visitor.

### Can website visitors hide the widget?

Yes, website visitors can temporarily hide the widget. They can choose to dismiss it for the current session, for 24 hours, or even for an entire week.

### How do I set up the widget?

Once installed and connected, the widget appears on your site with default settings. You can customize its appearance and functionality via the WordPress admin panel. Additionally, you can link your existing accessibility statement or create a custom one using our built-in generator, which automatically creates a dedicated page for your statement.

### Is the widget compatible with WordPress and Elementor?

Yes, the widget is fully integrated with Elementor and works seamlessly with any WordPress site, delivering a smooth and effective accessibility experience.

### What is an accessibility statement, and how do I generate one?

An accessibility statement is a declaration of your commitment to providing an inclusive online experience. With the widget, you can generate a custom accessibility statement and seamlessly publish it on a dedicated page. Our Accessibility Statement Generator is provided as a tool to assist you in creating a customized accessibility statement for your website. However, the generated statement should be reviewed and tailored to ensure it accurately reflects your website's specific accessibility practices and compliance efforts.


## Screenshots

### 1. Design: Customize the button's icon, size, and color and widget branding.

![Design: Customize the button's icon, size, and color and widget branding.](https://ps.w.org/pojo-accessibility/assets/screenshot-1.png)

### 2. Position Settings: Set widget placement or hide it on desktop and mobile.

![Position Settings: Set widget placement or hide it on desktop and mobile.](https://ps.w.org/pojo-accessibility/assets/screenshot-2.png)

### 3. Capabilities: Toggle accessibility features on or off as needed.

![Capabilities: Toggle accessibility features on or off as needed.](https://ps.w.org/pojo-accessibility/assets/screenshot-3.png)

### 4. Accessibility Statement: Add or create a custom accessibility statement.

![Accessibility Statement: Add or create a custom accessibility statement.](https://ps.w.org/pojo-accessibility/assets/screenshot-4.png)

### 5. Widget on Site: This is how the accessibility widget appears on a live website.

![Widget on Site: This is how the accessibility widget appears on a live website.](https://ps.w.org/pojo-accessibility/assets/screenshot-5.png)


## Changelog

### 3.3.0 - 2025-05-14

* New: Custom Icon support for the Ally widget
* New: Custom Link Gutenberg block to trigger Ally widget
* New: Elementor Dynamic Tags to trigger Ally widget
* New: Added "What's new" section in the admin panel
* Tweak: Improved accessibility statement page selector
* Fix: Notice on loading translations too early


### 3.2.0 - 2025-04-20

* New: Added border radius controls for the new icon widget
* Tweak: Added Hungarian translations to the new widget
* Fix: Improved German translations in the new widget
* Fix: Enhanced sanitization in the legacy widget to prevent potential security issues

### 3.1.0 2025-03-25

* New: Screen Reader – Improved accessibility with screen reader compatibility.
* New: Widget Usage Analytics – Track and analyze widget usage effectively.
* New: "My Account" Link – Easily access your account with a new direct link.
* New: Plan Quota Display – Admin panel now shows plan quotas.
* New: White Label capabilities
* Tweak: Various text and UI improvements.
* Tweak: The last settings tab is now remembered when navigating.
* Tweak: Sticky "Save Settings" Button
* Fix: Settings Screen Display Issue – Resolved UI inconsistencies.
* Fix: URL Mismatch Flow .
* Fix: Force referer header in widget script tag


### 3.0.3 2025-03-17

* New: Added an option to manage URL change
* New: Added Danish language support to widget
* New: Added compatibility with popular caching plugins: WP Rocket, W3 Total Cache, and LiteSpeed Cache
* Tweak: Improved connect flow
* Tweak: Admin panel UI widget preview improvements
* Tweak: Improved Admin panel UI accessibility
* Fix: PHP notice on legacy admin pages in PHP 8.2+

### 3.0.2 2025-02-25

* New: Added an option to revert to the legacy widget
* Fix: Media library not loading in some sites
* Fix: Auto upgrade for old versions with just customizer settings

### 3.0.1 2025-02-20

* Fix: Fixed favicon missing on some sites

### 3.0.0  2025-02-18

* 🚀 Introducing Ally Web Accessibility! One Click Accessibility is now Ally Web Accessibility! Discover the new experience: Learn More.
* New: Brand-New Interface – Redesigned for seamless touch-screen and mobile support.
* New: Revamped Infrastructure – Overhauled backend to support new and future capabilities.
* New: Page Structure Overview – Navigate your page’s structure for better accessibility.
* New: Image Hiding Option – Hides all images on the page to reduce distractions and make the page more readable.
* New: Pause animations option – Stops animations running on the page option, helping users focus on content.
* New: Reading Mask option- helps users focus on specific text, reducing distractions and improving readability.
* New: Accessibility Statement Generator – Easily generate an accessibility statement page for your site or link an existing one.
* New: Auto translations of the widget according to the page language

### 2.1.0 - 2022-12-18

* New: Added custom element ID for "Skip Content" link ([#35](https://github.com/pojome/one-click-accessibility/issues/35)), ([#36](https://github.com/pojome/one-click-accessibility/issues/36))
* Tweak: Added title for all SVG icons ([#30](https://github.com/pojome/one-click-accessibility/issues/30))
* Tweak: Add `role="button"` to the toggle ([#57](https://github.com/pojome/one-click-accessibility/pull/57))
* Tweak: Changed the default icon to "One Click"
* Fix: Remove extra quote ([Topic](https://wordpress.org/support/topic/bug-317/))
* Fix: High Contrast and Negative Contrast still appear after disabled from the settings ([#39](https://github.com/pojome/one-click-accessibility/issues/39))
* Fix: Added compatibility with Twenty Twenty theme

### 2.0.3 - 2018-05-28

* Fix: Toolbar settings panel empty in non-English sites
* Fix: Avoid showing Help & Feedback links if not defined ([#27](https://github.com/pojome/one-click-accessibility/pull/27))

### 2.0.2 - 2018-05-03

* Fix! - Added default settings for toolbar title
* Fix! - Print CSS rules before code to fix responsive issues
* Fix! - Added visibility CSS to fix dependency issues

### 2.0.1 - 2018-05-02

* Fix! - Increased icon size in the toolbar
* Tweak! - Restored `sr-only` class for smooth update

### 2.0.0 - 2018-05-01

* Tweak! - Renamed plugin to One Click Accessibility
* Tweak! - Added an option to select an toolbar icon
* Tweak! - Split Settings Panel to Settings and Toolbar
* Tweak! - Removed FontAwesome dependency
* Tweak! - Removed Bootstrap dependency
* Tweak! - Removed Pojo Framework dependency

### 1.1.6 - 2017-10-26

* Fix! - Border with RGBA is hidden in high contrast mode

### 1.1.5 - 2016-03-09

* Tweak! - Fix minor style issue

### 1.1.4 - 2016-02-23

* Fixed! - tabindex on custom links issue

### 1.1.3 - 2016-02-21

* Tweak! - Resolve the focus issues by another way

### 1.1.2 - 2016-02-10

* Fixed! - Triggering blur after focus to avoid auto-focus by browser on tab reactivated

### 1.1.1 - 2016-02-08

* Tweak! - Added more hebrew strings translate
* Tested up to WordPress v4.4

### 1.1.0 - 2016-02-07

* New! - Remember toolbar options

### 1.0.3 - 2016-01-27

* Fixed! - Issue with sidebar in Resize text
* Tweak! - Added more string fields for WPML/Polylang plugins

### 1.0.2 - 2015-12-08

* Tweak! - Fixed hebrew translate

### 1.0.1 - 2015-11-17

* New! - Added distance from top toolbar, in Desktop/Mobile devices
* Fixed! - Skip to content in Chrome

### 1.0.0 - 2015-10-29

* Initial Public Release!
