From 34e706fc11bc0ad3ec704d5152cdfc85d4a4f00d Mon Sep 17 00:00:00 2001
From: Adam Wood <1017872+adamwoodnz@users.noreply.github.com>
Date: Wed, 24 Jul 2024 15:05:08 +1200
Subject: [PATCH] 2024 Theme: add context to learning pathway 'See all' links
 for screenreaders

See https://github.com/WordPress/Learn/issues/2482
---
 wp-content/themes/pub/wporg-learn-2024/functions.php |  6 ++++++
 .../taxonomy-learning-pathway-content-sections.php   | 12 +++++++++---
 2 files changed, 15 insertions(+), 3 deletions(-)

diff --git a/wp-content/themes/pub/wporg-learn-2024/functions.php b/wp-content/themes/pub/wporg-learn-2024/functions.php
index f7c56fe7d..c4ba32e31 100644
--- a/wp-content/themes/pub/wporg-learn-2024/functions.php
+++ b/wp-content/themes/pub/wporg-learn-2024/functions.php
@@ -202,28 +202,34 @@ function get_learning_pathway_level_content( $learning_pathway ) {
 			'beginner' => array(
 				'title' => __( 'Beginner WordPress users', 'wporg-learn' ),
 				'description' => __( 'You’re new to WordPress, or building websites, and want the essentials.', 'wporg-learn' ),
+				'see_all_aria_label' => 'Beginner WordPress users: See all learning pathways',
 			),
 			'intermediate' => array(
 				'title' => __( 'Intermediate WordPress users', 'wporg-learn' ),
 				'description' => __( 'You’re comfortable setting up your site and making small changes or you’ve already completed the Beginner course.', 'wporg-learn' ),
+				'see_all_aria_label' => 'Intermediate WordPress users: See all learning pathways',
 			),
 			'advanced' => array(
 				'title' => __( 'Advanced WordPress users', 'wporg-learn' ),
 				'description' => __( 'You’re confident using multiple plugins and know how to customize a Block theme, or you’ve already completed the Intermediate course.', 'wporg-learn' ),
+				'see_all_aria_label' => 'Advanced WordPress users: See all learning pathways',
 			),
 		),
 		'developer' => array(
 			'beginner' => array(
 				'title' => __( 'Beginner development concepts', 'wporg-learn' ),
 				'description' => __( 'You’re new to development or have experience using WordPress’s no-code features and want to do more.', 'wporg-learn' ),
+				'see_all_aria_label' => 'Beginner development concepts: See all learning pathways',
 			),
 			'intermediate' => array(
 				'title' => __( 'Intermediate development concepts', 'wporg-learn' ),
 				'description' => __( 'You’re comfortable writing code and want to extend WordPress with your own plugin or theme.', 'wporg-learn' ),
+				'see_all_aria_label' => 'Intermediate development concepts: See all learning pathways',
 			),
 			'advanced' => array(
 				'title' => __( 'Advanced development concepts', 'wporg-learn' ),
 				'description' => __( 'You’re confident in the WordPress development environment or have already built your own plugin or theme.', 'wporg-learn' ),
+				'see_all_aria_label' => 'Advanced development concepts: See all learning pathways',
 			),
 		),
 	);
diff --git a/wp-content/themes/pub/wporg-learn-2024/patterns/taxonomy-learning-pathway-content-sections.php b/wp-content/themes/pub/wporg-learn-2024/patterns/taxonomy-learning-pathway-content-sections.php
index 22b969364..54ce921ca 100644
--- a/wp-content/themes/pub/wporg-learn-2024/patterns/taxonomy-learning-pathway-content-sections.php
+++ b/wp-content/themes/pub/wporg-learn-2024/patterns/taxonomy-learning-pathway-content-sections.php
@@ -40,7 +40,9 @@
 	<!-- /wp:paragraph -->
 
 	<!-- wp:paragraph {"style":{"elements":{"link":{"color":{"text":"var:preset|color|blueberry-1"}}}},"textColor":"charcoal-4"} -->
-	<p class="has-charcoal-4-color has-text-color has-link-color"><a href="<?php echo esc_url( $learning_pathway_url . '?wporg_lesson_level=beginner' ); ?>"><?php esc_html_e( 'See all', 'wporg-learn' ); ?></a></p>
+	<p class="has-charcoal-4-color has-text-color has-link-color">
+		<a href="<?php echo esc_url( $learning_pathway_url . '?wporg_lesson_level=beginner' ); ?>" aria-label="<?php echo esc_attr( $content['beginner']['see_all_aria_label'] ); ?>"><?php esc_html_e( 'See all', 'wporg-learn' ); ?></a>
+	</p>
 	<!-- /wp:paragraph -->
 
 </div>
@@ -76,7 +78,9 @@
 	<!-- /wp:paragraph -->
 
 	<!-- wp:paragraph {"style":{"elements":{"link":{"color":{"text":"var:preset|color|blueberry-1"}}}},"textColor":"charcoal-4"} -->
-	<p class="has-charcoal-4-color has-text-color has-link-color"><a href="<?php echo esc_url( $learning_pathway_url . '?wporg_lesson_level=intermediate' ); ?>"><?php esc_html_e( 'See all', 'wporg-learn' ); ?></a></p>
+	<p class="has-charcoal-4-color has-text-color has-link-color">
+		<a href="<?php echo esc_url( $learning_pathway_url . '?wporg_lesson_level=intermediate' ); ?>" aria-label="<?php echo esc_attr( $content['intermediate']['see_all_aria_label'] ); ?>"><?php esc_html_e( 'See all', 'wporg-learn' ); ?></a>
+	</p>
 	<!-- /wp:paragraph -->
 
 </div>
@@ -112,7 +116,9 @@
 	<!-- /wp:paragraph -->
 
 	<!-- wp:paragraph {"style":{"elements":{"link":{"color":{"text":"var:preset|color|blueberry-1"}}}},"textColor":"charcoal-4"} -->
-	<p class="has-charcoal-4-color has-text-color has-link-color"><a href="<?php echo esc_url( $learning_pathway_url . '?wporg_lesson_level=advanced' ); ?>"><?php esc_html_e( 'See all', 'wporg-learn' ); ?></a></p>
+	<p class="has-charcoal-4-color has-text-color has-link-color">
+		<a href="<?php echo esc_url( $learning_pathway_url . '?wporg_lesson_level=advanced' ); ?>" aria-label="<?php echo esc_attr( $content['advanced']['see_all_aria_label'] ); ?>"><?php esc_html_e( 'See all', 'wporg-learn' ); ?></a>
+	</p>
 	<!-- /wp:paragraph -->
 
 </div>