CEB Classic Editor ARIA
Adds an ARIA label field to the Insert/Edit Link modal in the Wordpress Classic Editor (and Classic Paragraph block), allowing screen reader-friendly descriptions to be attached to links.
by Cary Briel · github.com/carybriel/ceb-classic-editor-aria · website
Install
No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:
wp plugin install https://github.com/carybriel/ceb-classic-editor-aria/archive/refs/heads/main.zipReadme
=== CEB Classic Editor ARIA ===
Contributors: Cary Briel
Tags: classic editor, accessibility, aria, links, editor
Requires at least: 5.0
Tested up to: 6.5
Requires PHP: 7.2
Stable tag: 1.0.0
Adds 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.