Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/carybriel/ceb-classic-editor-aria/archive/refs/heads/main.zipAdds an ARIA label field to the Insert/Edit Link modal in the Classic Editor (and Classic Paragraph block), allowing screen reader-friendly descriptions to be attached to links.
Description
This plugin enhances the Classic Editor experience by adding a new ARIA Label field to the Insert/Edit Link modal. The value entered is inserted as an aria-label attribute on the resulting <a> tag, improving accessibility for screen reader users.
Supports:
- The Classic Editor
- The Classic Paragraph block in Gutenberg
- Any custom
wp_editor()instance that uses the standard WordPress link modal
Features
- Adds an
ARIA Labelfield to the Insert/Edit Link modal - Automatically inserts
aria-labelinto the anchor tag after link insertion - Works in both the Classic Editor and Classic Blocks
- Non-intrusive: adds ARIA only when provided
- Does not affect modern Gutenberg
RichTextlink controls
Installation
- Upload the plugin files to the
/wp-content/plugins/ceb-classic-editor-ariadirectory, or install the plugin through the WordPress admin. - Activate the plugin through the "Plugins" menu in WordPress.
- Edit a post using the Classic Editor or Classic Paragraph block.
- Use the link modal and enter an optional ARIA Label.
Frequently Asked Questions
Does this work in the Block Editor?
Only in Classic Paragraph blocks, not in modern block-based link UIs (like Paragraph or Button blocks using RichText).
What happens if I leave the ARIA label blank?
The plugin will not add the aria-label attribute unless you enter a value.
Will the ARIA label be preserved if I edit the link again?
Yes, the plugin detects existing aria-label attributes and preloads their values into the field when the modal is reopened.
Changelog
1.0.0
- Initial release of ARIA label support in the Classic Editor link modal.
Upgrade Notice
1.0.0
Adds support for aria-label field in the Classic Editor's Insert/Edit Link modal.