Web Accessibility Errors for Download Buttons

Viewing 10 posts - 1 through 10 (of 10 total)
#201648

Jonathan Dwinell
Participant

Getting hundreds of Ambiguous Anchor Text errors when remediating for web accessibility issues on pages using this plugin. When using the Default Link Template, it shows a button next to each file with the ambiguous/generic text “Download” for all of them. Recommend fixing this by adding an Aria Label to these buttons that also includes the file name/title so each download button is unique and contains the proper context for screen readers (i.e. “Download Sample.pdf file”). Maybe handled better elsewhere, but I hard-coded this temporary fix to download-manager/src/Package/PackageController.php:312. Please advise. Thank you!

#201650

Nayeem Riddhi
Moderator

Hello Jonathan Dwinell,

Hope you are well. And sorry for the inconvenience. Please share the related URLs. if possible, please, give your temporary wp-admin login details in a private reply to check the issue.

Thank you and regards

#201704

Jonathan Dwinell
Participant

This is not a unique or custom problem with our installation specifically, but an overall accessibility issue within your own plugin. Please see your own Demo pages as an example: https://try.wpdownloadmanager.com/list-packages/. Any time there is a button on the frontend from your plugin (“View More”, “Download”, “Add to Cart”, “Details”, etc.), you need to apply a unique, contextual “aria-label” attribute to it with more context for screen readers. Otherwise, it fails basic WCAG compliance (https://www.w3.org/TR/UNDERSTANDING-WCAG20/navigation-mechanisms-refs.html). Having a long list of files with the exact same “Download” labeled button one after the other does not provide enough context to users and screen readers on what that link/button will actually do or which file it will download. I’ve just manually added an aria-label=’Download {$post_vars[‘title’]} file’ to your code mentioned to remedy this and fix this accessibility issue temporarily. The preference would be the plugin actually gets fixed and updated throughout for this specific accessibility issue though. Thank you!

#201712

Nayeem Riddhi
Moderator
This reply has been marked as private.
#201786

Jonathan Dwinell
Participant

Thank you. Yes, the Link Label would work for a small number of items to make them unique and add context. However, we currently have 700+ documents, so manually adding a custom label or copy/paste the title individually is not a great option. Ideally, the default plugin settings without a custom Link Label should be accessible out of the box. Please add to your future release.

#201792

Nayeem Riddhi
Moderator

For applying bulk renaming to download link label, you can check our this default valu add-on, https://www.wpdownloadmanager.com/download/wpdm-default-values/. Please kindly check.

Thank you and kind regards

#201807

Jonathan Dwinell
Participant

That add-on looks interesting for initial default settings for new or copied downloads, but I already have 700+ documents input so isn’t helpful in this case. This also still does not fix the WCAG accessibility issue (2.4.4 Link Purpose (In Context): The purpose of each link can be determined from the link text alone or from the link text together with its programmatically determined link context, except where the purpose of the link would be ambiguous to users in general. (Level A) ). Each download link/label needs to be contextual and different from the others around it. You would need to be able to apply the document title dynamically for this to be a manual solution. Why not just take this as a future suggestion to make your plugin web accessible by default?

#201808

Nayeem Riddhi
Moderator

No with the default value add-on you can bulk apply to download link label to all of your existing 700+ documents. Please kindly check.

Thank you and kind regards

#201809

Jonathan Dwinell
Participant

Thanks for clarifying. Please understand the actual accessibility issue though. It is not good enough to just apply the exact same link label text on all of my links either. They have to all be different from each other to comply. This is not accomplished with a single bulk update unless I can use some dynamic shortcode or way to use the document’s title within the label (like “Download {{Post_Title}} file”). Understand?

#201810

Nayeem Riddhi
Moderator

For it you may need to take custom upgrade service from here, https://www.wpdownloadmanager.com/download/custom-upgrade-service/. Please kindly check.

Thank you again and regards

Viewing 10 posts - 1 through 10 (of 10 total)

You must be logged in to reply to this topic.