Release v1.44.0

.eslintrc

@@ -13,7 +13,15 @@
 	},
 	"overrides": [
 		{
-			"files": [ "src/sidebar/**/*.js", "src/sidebar/**/*.jsx", "src/issueModal/**/*.js", "src/issueModal/**/*.jsx" ],
+			"files": [
+				"src/sidebar/**/*.js",
+				"src/sidebar/**/*.jsx",
+				"src/issueModal/**/*.js",
+				"src/issueModal/**/*.jsx",
+				"src/sharedComponents/**/*.js",
+				"tests/jest/**/*.js",
+				"tests/jest/**/*.jsx"
+			],
 			"plugins": [ "react" ],
 			"parserOptions": {
 				"ecmaVersion": 2021,
@@ -23,7 +31,27 @@
 				}
 			},
 			"rules": {
-				"react/jsx-uses-vars": "error"
+				"react/jsx-uses-vars": "error",
+				"jsdoc/check-tag-names": "off"
+			}
+		},
+		{
+			"files": [
+				"tests/jest/setupTests.js",
+				"tests/jest/styleMock.js",
+				"tests/jest/jest.config.js",
+				"tests/jest/babel.config.js"
+			],
+			"env": {
+				"node": true,
+				"browser": true
+			},
+			"globals": {
+				"Buffer": "readonly",
+				"globalThis": "readonly"
+			},
+			"rules": {
+				"no-redeclare": "off"
 			}
 		}
 	]

.github/ISSUE_TEMPLATE/Accessibility_Issue.yml

@@ -0,0 +1,201 @@
+name: Accessibility Report
+description: Let us know if you encounter an accessibility issue so we can fix it.
+title: "[Accessibility]: "
+labels:
+  - a11y
+  - needs-triage
+assignees:
+  - amberhinds
+
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Please use this template when creating an accessibility issue.
+
+        - Please use the latest version of Accessibility Checker.
+        - Search for existing issues before creating a new one.
+
+  - type: checkboxes
+    id: prerequisites
+    attributes:
+      label: Before submitting
+      options:
+        - label: I've read and understood the [contribution guidelines](https://github.com/equalizedigital/accessibility-checker/blob/develop/.github/CONTRIBUTING.md).
+          required: true
+        - label: I've searched for [related issues](https://github.com/equalizedigital/accessibility-checker/issues) and confirmed this is not a duplicate.
+          required: true
+
+  - type: textarea
+    id: impacted-element
+    attributes:
+      label: Impacted element or component
+      description: What part of the plugin or interface is affected?
+    validations:
+      required: true
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Description of the issue
+    validations:
+      required: true
+
+  - type: textarea
+    id: screenshots
+    attributes:
+      label: Screenshot(s) or video
+      description: Attach screenshots or paste links to videos demonstrating the issue.
+
+  - type: textarea
+    id: recommended-fix
+    attributes:
+      label: Recommended fix or expected behavior
+
+  - type: dropdown
+    id: severity
+    attributes:
+      label: Is this a critical blocker?
+      options:
+        - Yes - there is no workaround for this issue.
+        - No - this is an accessibility problem, but it is minor or not a blocker.
+        - Unsure
+
+  - type: dropdown
+    id: wcag-sc
+    attributes:
+      label: Related WCAG Success Criterion
+      description: Select the WCAG Success Criterion that is most closely related to this issue.
+      options:
+        - Not sure
+        - 1.1.1 Non-text Content
+        - 1.2.1 Audio-only and Video-only (Prerecorded)
+        - 1.2.2 Captions (Prerecorded)
+        - 1.2.3 Audio Description or Media Alternative (Prerecorded)
+        - 1.2.4 Captions (Live)
+        - 1.2.5 Audio Description (Prerecorded)
+        - 1.3.1 Info and Relationships
+        - 1.3.2 Meaningful Sequence
+        - 1.3.3 Sensory Characteristics
+        - 1.3.4 Orientation
+        - 1.3.5 Identify Input Purpose
+        - 1.4.1 Use of Color
+        - 1.4.2 Audio Control
+        - 1.4.3 Contrast (Minimum)
+        - 1.4.4 Resize Text
+        - 1.4.5 Images of Text
+        - 1.4.10 Reflow
+        - 1.4.11 Non-text Contrast
+        - 1.4.12 Text Spacing
+        - 1.4.13 Content on Hover or Focus
+        - 2.1.1 Keyboard
+        - 2.1.2 No Keyboard Trap
+        - 2.1.4 Character Key Shortcuts
+        - 2.2.1 Timing Adjustable
+        - 2.2.2 Pause, Stop, Hide
+        - 2.3.1 Three Flashes or Below Threshold
+        - 2.4.1 Bypass Blocks
+        - 2.4.2 Page Titled
+        - 2.4.3 Focus Order
+        - 2.4.4 Link Purpose (In Context)
+        - 2.4.5 Multiple Ways
+        - 2.4.6 Headings and Labels
+        - 2.4.7 Focus Visible
+        - 2.4.11 Focus Not Obscured (Minimum)
+        - 2.5.1 Pointer Gestures
+        - 2.5.2 Pointer Cancellation
+        - 2.5.3 Label in Name
+        - 2.5.4 Motion Actuation
+        - 2.5.7 Dragging Movements
+        - 2.5.8 Target Size (Minimum)
+        - 3.1.1 Language of Page
+        - 3.2.1 On Focus
+        - 3.2.2 On Input
+        - 3.2.3 Consistent Navigation
+        - 3.2.4 Consistent Identification
+        - 3.2.6 Consistent Help
+        - 3.3.1 Error Identification
+        - 3.3.2 Labels or Instructions
+        - 3.3.3 Error Suggestion
+        - 3.3.4 Error Prevention (Legal, Financial, Data)
+        - 3.3.7 Redundant Entry
+        - 3.3.8 Accessible Authentication (Minimum)
+        - 4.1.1 Parsing
+        - 4.1.2 Name, Role, Value
+        - 4.1.3 Status Messages
+
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: How can we reproduce this behavior?
+      placeholder: |
+        1. Go to...
+        2. Click...
+        3. Observe...
+    validations:
+      required: true
+
+  - type: input
+    id: wordpress-version
+    attributes:
+      label: WordPress version
+      placeholder: e.g. 7.0
+
+  - type: input
+    id: accessibility-checker-version
+    attributes:
+      label: Accessibility Checker version
+      placeholder: e.g. 1.43.0
+    validations:
+      required: true
+
+  - type: input
+    id: active-theme
+    attributes:
+      label: Active theme
+      placeholder: e.g. Twenty Twenty-Six
+
+  - type: checkboxes
+    id: screen-reader
+    attributes:
+      label: Which screen reader are you using? (if applicable)
+      options:
+        - label: NVDA
+        - label: VoiceOver
+        - label: JAWS
+        - label: Other
+
+  - type: input
+    id: other-screen-reader
+    attributes:
+      label: Other screen reader
+      placeholder: Specify if you selected Other
+
+  - type: checkboxes
+    id: browser
+    attributes:
+      label: Which browser is affected?
+      options:
+        - label: Internet Explorer
+        - label: Edge
+        - label: Chrome
+        - label: Firefox
+        - label: Safari
+        - label: Brave
+
+  - type: checkboxes
+    id: editor
+    attributes:
+      label: Which editor is affected? (if relevant)
+      options:
+        - label: Classic Editor
+        - label: Gutenberg
+        - label: Classic Editor Plugin
+        - label: Page Builder
+
+  - type: input
+    id: page-builder
+    attributes:
+      label: Page Builder name
+      placeholder: Elementor, Beaver Builder, Divi, etc.
+

accessibility-checker.php

@@ -10,7 +10,7 @@
  * Plugin Name:       Accessibility Checker
  * Plugin URI:        https://a11ychecker.com
  * Description:       Audit and check your website for accessibility before you hit publish. In-post accessibility scanner and guidance.
- * Version:           1.43.0
+ * Version:           1.44.0
  * Requires PHP:      7.4
  * Author:            Equalize Digital
  * Author URI:        https://equalizedigital.com
@@ -36,7 +36,7 @@
 
 // Current plugin version.
 if ( ! defined( 'EDAC_VERSION' ) ) {
-	define( 'EDAC_VERSION', '1.43.0' );
+	define( 'EDAC_VERSION', '1.44.0' );
 }
 
 // Current database version.

admin/AdminPage/AccessibilityReportsPage.php

@@ -98,7 +98,7 @@ public function render_page() {
 			]
 		);
 
-		$dashboard_url       = edac_link_wrapper( 'https://my.equalizedigital.com/', 'accessibility-reports', 'account', false );
+		$dashboard_url       = edac_link_wrapper( 'https://my.equalizedigital.com/license-keys/', 'accessibility-reports', 'account', false );
 		$signup_url          = edac_link_wrapper( 'https://my.equalizedigital.com/sign-up/', 'accessibility-reports', 'signup', false );
 		$privacy_url         = edac_link_wrapper( 'https://equalizedigital.com/privacy-policy/', 'accessibility-reports', 'privacy', false );
 		$data_processing_url = edac_link_wrapper( 'https://equalizedigital.com/data-terms/', 'accessibility-reports', 'dpa', false );
@@ -237,7 +237,8 @@ public function render_page() {
 									<h3><?php esc_html_e( 'Reports Enabled', 'accessibility-checker' ); ?></h3>
 									<span class="edac-reports-card__status edac-reports-card__status--success" aria-hidden="true"><?php echo wp_kses( $this->get_status_icon( 'check' ), $allowed_icon_html ); ?></span>
 								</div>
-								<p><?php esc_html_e( 'You’ll receive weekly accessibility reports for this site.', 'accessibility-checker' ); ?></p>
+								<p><?php esc_html_e( 'Weekly accessibility reports for this site are being emailed to the account owner of the license key.', 'accessibility-checker' ); ?></p>
+
 								<p class="edac-reports-card__meta">
 									<?php if ( $next_send_date ) : ?>
 										<?php /* translators: %s: next report date. */ ?>

admin/class-enqueue-admin.php

@@ -87,7 +87,8 @@ public static function maybe_enqueue_admin_and_editor_app_scripts() {
 				[
 					'postID'                   => $post_id,
 					'nonce'                    => wp_create_nonce( 'ajax-nonce' ),
-					'edacApiUrl'               => esc_url_raw( rest_url() . 'accessibility-checker/v1' ),
+					'edacApiUrl'               => esc_url_raw( rest_url( 'accessibility-checker/v1' ) ),
+					'fixesRestUrl'             => esc_url_raw( rest_url( 'edac/v1' ) ),
 					'restNonce'                => wp_create_nonce( 'wp_rest' ),
 					'proUrl'                   => esc_url_raw( edac_generate_link_type( [ 'utm_content' => '__name__' ] ) ),
 					'hasDismissEndpoint'       => method_exists( \EDAC\Inc\REST_Api::class, 'dismiss_issue' ),
@@ -133,18 +134,19 @@ public static function maybe_enqueue_admin_and_editor_app_scripts() {
 					'edac-editor-app',
 					'edac_editor_app',
 					[
-						'postID'       => $post_id,
-						'edacUrl'      => esc_url_raw( get_site_url() ),
-						'edacApiUrl'   => esc_url_raw( rest_url() . 'accessibility-checker/v1' ),
-						'baseurl'      => plugin_dir_url( __DIR__ ),
-						'active'       => $active,
-						'pro'          => $pro,
-						'debug'        => $debug,
-						'scanUrl'      => $scan_url,
-						'maxAltLength' => max( 1, absint( apply_filters( 'edac_max_alt_length', 300 ) ) ),
-						'version'      => EDAC_VERSION,
-						'postStatus'   => get_post_status( $post_id ),
-						'restNonce'    => wp_create_nonce( 'wp_rest' ),
+						'postID'        => $post_id,
+						'edacUrl'       => esc_url_raw( get_site_url() ),
+						'edacApiUrl'    => esc_url_raw( rest_url() . 'accessibility-checker/v1' ),
+						'baseurl'       => plugin_dir_url( __DIR__ ),
+						'active'        => $active,
+						'pro'           => $pro,
+						'debug'         => $debug,
+						'scanUrl'       => $scan_url,
+						'maxAltLength'  => max( 1, absint( apply_filters( 'edac_max_alt_length', 300 ) ) ),
+						'landmarkTypes' => edac_get_landmark_types(),
+						'version'       => EDAC_VERSION,
+						'postStatus'    => get_post_status( $post_id ),
+						'restNonce'     => wp_create_nonce( 'wp_rest' ),
 					]
 				);
 

docs/hooks.md

@@ -47,7 +47,7 @@ This document is auto-generated by `tools/generate-hooks-docs.php`. It lists onl
 | `edac_mydot_api_endpoint` | filter | [includes/classes/MyDot/Connector.php](https://github.com/equalizedigital/accessibility-checker/blob/develop/includes/classes/MyDot/Connector.php#L528) | 528 | Filters the MyDot API endpoint URL. | 1.xx.x |
 | `edac_mydot_product_id` | filter | [includes/classes/MyDot/Connector.php](https://github.com/equalizedigital/accessibility-checker/blob/develop/includes/classes/MyDot/Connector.php#L548) | 548 | Filters the MyDot product ID. | 1.xx.x |
 | `edac_pro_product_id` | filter | [includes/classes/MyDot/Connector.php](https://github.com/equalizedigital/accessibility-checker/blob/develop/includes/classes/MyDot/Connector.php#L1302) | 1302 | Infer license metadata from an EDD response. | 1.xx.x |
-| `edac_pro_setting_saving_checkbox` | action | [includes/options-page.php](https://github.com/equalizedigital/accessibility-checker/blob/develop/includes/options-page.php#L882) | 882 | Filter to run before saving a pro checkbox setting. | 1.31.0 |
+| `edac_pro_setting_saving_checkbox` | action | [includes/options-page.php](https://github.com/equalizedigital/accessibility-checker/blob/develop/includes/options-page.php#L881) | 881 | Filter to run before saving a pro checkbox setting. | 1.31.0 |
 | `edac_scannable_post_statuses` | filter | [admin/class-settings.php](https://github.com/equalizedigital/accessibility-checker/blob/develop/admin/class-settings.php#L28) | 28 | Filters the list of post statuses that are scannable. | 1.29.0 |
 | `edac_settings_tab_content` | action | [partials/settings-page.php](https://github.com/equalizedigital/accessibility-checker/blob/develop/partials/settings-page.php#L175) | 175 | Fires after the settings tab content has maybe been displayed. | 1.4.0 |
 | `edac_validate_before_sending_rest_response` | action | [includes/classes/class-rest-api.php](https://github.com/equalizedigital/accessibility-checker/blob/develop/includes/classes/class-rest-api.php#L617) | 617 | Fires before sending the REST response ending the validation process. | 1.14.0 |

includes/classes/Rules/Rule/AriaHiddenRule.php

@@ -38,7 +38,7 @@ public static function get_rule(): array {
 			'why_it_matters'        => esc_html__( 'The aria-hidden attribute is used to hide content from assistive technologies. While this is useful for decorative or redundant elements, it can cause accessibility issues if applied to important content that screen reader users need to access.', 'accessibility-checker' ),
 			'how_to_fix'            => sprintf(
 			// translators: %s is <code>aria-hidden="true"</code.
-				esc_html__( 'Check whether the element should truly be hidden from screen reader users. If it contains important content or functionality, remove %s. If it\'s decorative or redundant, leave the element alone and dismiss this warning using the "Ignore" feature in Accessibility Checker.', 'accessibility-checker' ),
+				esc_html__( 'Check whether the element should truly be hidden from screen reader users. If it contains important content or functionality, remove %s. If it\'s decorative or redundant, leave the element alone and dismiss this warning in Accessibility Checker.', 'accessibility-checker' ),
 				'<code>aria-hidden="true"</code>'
 			),
 			'references'            => [

includes/classes/Rules/Rule/ImgAltEmptyRule.php

@@ -38,7 +38,7 @@ public static function get_rule(): array {
 			'why_it_matters'        => esc_html__( 'Screen readers rely on alternative text to describe images to users who cannot see them. If the alt attribute is empty, it signals that the image is decorative and should be skipped. However, if a meaningful image has an empty alt attribute, users with visual impairments will miss important information. Proper use of alternative text improves accessibility and ensures all users can understand the content.', 'accessibility-checker' ),
 			'how_to_fix'            => sprintf(
 			// translators: %1$s is <code>alt=""</code>, %2$s is <code>role="presentation"</code>, and %3$s is <code>role="none"</code>.
-				esc_html__( 'Review the image to determine if it is decorative. If it is decorative, it is correct to use an empty %1$s attribute and you can dismiss this warning by using the "Ignore" feature in Accessibility Checker or adding %2$s or %3$s to the image and rescanning the page. If the image conveys information, add descriptive alt text that communicates the image\'s purpose or meaning.', 'accessibility-checker' ),
+				esc_html__( 'Review the image to determine if it is decorative. If it is decorative, it is correct to use an empty %1$s attribute and you can dismiss this warning in Accessibility Checker or by adding %2$s or %3$s to the image and rescanning the page. If the image conveys information, add descriptive alt text that communicates the image\'s purpose or meaning.', 'accessibility-checker' ),
 				'<code>alt=""</code>',
 				'<code>role="presentation"</code>',
 				'<code>role="none"</code>',

includes/classes/Rules/Rule/ImgAltLongRule.php

@@ -38,7 +38,7 @@ public static function get_rule(): array {
 			'why_it_matters'        => esc_html__( 'Alternative text should be concise and focused on describing the purpose or meaning of the image. Overly long alt text may overwhelm screen reader users, reduce readability, and distract from other content on the page.', 'accessibility-checker' ),
 			'how_to_fix'            => sprintf(
 			// translators: %s is the maximum character count for alt text.
-				esc_html__( 'Shorten the alt text to fewer than %s characters while still describing the image\'s function or purpose. Keep descriptions simple and avoid repeating surrounding content. If the image\'s alt text does not need to be changed, dismiss this warning using the "Ignore" feature in Accessibility Checker.', 'accessibility-checker' ),
+				esc_html__( 'Shorten the alt text to fewer than %s characters while still describing the image\'s function or purpose. Keep descriptions simple and avoid repeating surrounding content. If the image\'s alt text does not need to be changed, dismiss this warning in Accessibility Checker.', 'accessibility-checker' ),
 				'300'
 			),
 			'references'            => [

includes/classes/Rules/Rule/ImgAnimatedGifRule.php

@@ -28,7 +28,7 @@ public static function get_rule(): array {
 			'summary'               => esc_html__( 'This element is an animated image file (e.g., GIF or animated WebP).', 'accessibility-checker' ),
 			'summary_plural'        => esc_html__( 'These elements are animated image files (e.g., GIFs or animated WebPs).', 'accessibility-checker' ),
 			'why_it_matters'        => esc_html__( 'Animated images can be distracting, induce seizures in some individuals, or create cognitive load. WCAG guidelines require that animations that flash or loop continuously provide a mechanism to pause, stop, or hide them.', 'accessibility-checker' ),
-			'how_to_fix'            => esc_html__( 'Replace the animated image with a static image or a video that includes controls. If you must use an animated image, ensure it does not flash more than three times per second and provide pause or stop controls if it plays for more than 5 seconds. If you have confirmed the image is accessible and pauseable, you can dismiss this warning by using the "Ignore" feature in Accessibility Checker.', 'accessibility-checker' ),
+			'how_to_fix'            => esc_html__( 'Replace the animated image with a static image or a video that includes controls. If you must use an animated image, ensure it does not flash more than three times per second and provide pause or stop controls if it plays for more than 5 seconds. If you have confirmed the image is accessible and pauseable, you can dismiss this warning in Accessibility Checker.', 'accessibility-checker' ),
 			'references'            => [
 				[
 					'text' => __( 'Should you use animated GIFs?', 'accessibility-checker' ),