From b47af94e861e98122d369b57a83de93500e024d2 Mon Sep 17 00:00:00 2001
From: Khokan Sardar <itzmekhokan@gmail.com>
Date: Sun, 10 May 2026 17:41:02 +0530
Subject: [PATCH] I18N: Add translator context to all 'Preview' strings.

Adds translator context to all in-tree occurrences of the 'Preview' string
using a simplified `_x( 'Preview', 'noun' )` or `_x( 'Preview', 'verb' )`,
so translators can correctly disambiguate it across languages
(e.g. German) where the noun and verb forms differ.

* Buttons and action links use `'verb'`.
* Preview pane labels, table row headers, and the iframe title use `'noun'`.

Affected files:
* src/wp-admin/customize.php
* src/wp-admin/includes/class-custom-background.php
* src/wp-admin/includes/class-custom-image-header.php
* src/wp-admin/includes/class-wp-posts-list-table.php
* src/wp-admin/includes/class-wp-theme-install-list-table.php
* src/wp-admin/includes/meta-boxes.php
* src/wp-admin/includes/post.php
* src/wp-admin/theme-install.php
* src/wp-includes/class-wp-customize-manager.php
* src/wp-includes/class-wp-editor.php

Props motylanogha, wildworks, jorbin, sergeybiryukov, audrasjb,
anupkankale, mohamedahamed, rafaeldella, t-hamano.

See #64986.

Co-authored-by: Cursor <cursoragent@cursor.com>
---
 src/wp-admin/customize.php                             |  2 +-
 src/wp-admin/includes/class-custom-background.php      |  2 +-
 src/wp-admin/includes/class-custom-image-header.php    |  2 +-
 src/wp-admin/includes/class-wp-posts-list-table.php    |  2 +-
 .../includes/class-wp-theme-install-list-table.php     |  2 +-
 src/wp-admin/includes/meta-boxes.php                   |  2 +-
 src/wp-admin/includes/post.php                         |  2 +-
 src/wp-admin/theme-install.php                         | 10 +++++-----
 src/wp-includes/class-wp-customize-manager.php         |  2 +-
 src/wp-includes/class-wp-editor.php                    |  2 +-
 10 files changed, 14 insertions(+), 14 deletions(-)

diff --git a/src/wp-admin/customize.php b/src/wp-admin/customize.php
index 9be47136a9b3b..257dbbe0d60a8 100644
--- a/src/wp-admin/customize.php
+++ b/src/wp-admin/customize.php
@@ -210,7 +210,7 @@
 			<span class="spinner"></span>
 			<button type="button" class="customize-controls-preview-toggle">
 				<span class="controls"><?php _e( 'Customize' ); ?></span>
-				<span class="preview"><?php _e( 'Preview' ); ?></span>
+				<span class="preview"><?php echo esc_html_x( 'Preview', 'noun' ); ?></span>
 			</button>
 			<a class="customize-controls-close" href="<?php echo esc_url( $wp_customize->get_return_url() ); ?>">
 				<span class="screen-reader-text">
diff --git a/src/wp-admin/includes/class-custom-background.php b/src/wp-admin/includes/class-custom-background.php
index e42a38f4eb689..75aa75d968fa2 100644
--- a/src/wp-admin/includes/class-custom-background.php
+++ b/src/wp-admin/includes/class-custom-background.php
@@ -279,7 +279,7 @@ public function admin_page() {
 <table class="form-table" role="presentation">
 <tbody>
 <tr>
-<th scope="row"><?php _e( 'Preview' ); ?></th>
+<th scope="row"><?php echo esc_html_x( 'Preview', 'noun' ); ?></th>
 <td>
 		<?php
 		if ( $this->admin_image_div_callback ) {
diff --git a/src/wp-admin/includes/class-custom-image-header.php b/src/wp-admin/includes/class-custom-image-header.php
index eb65605728062..82c1aca0ed152 100644
--- a/src/wp-admin/includes/class-custom-image-header.php
+++ b/src/wp-admin/includes/class-custom-image-header.php
@@ -550,7 +550,7 @@ public function step_1() {
 
 		<?php if ( get_custom_header() || display_header_text() ) : ?>
 <tr>
-<th scope="row"><?php _e( 'Preview' ); ?></th>
+<th scope="row"><?php echo esc_html_x( 'Preview', 'noun' ); ?></th>
 <td>
 			<?php
 			if ( $this->admin_image_div_callback ) {
diff --git a/src/wp-admin/includes/class-wp-posts-list-table.php b/src/wp-admin/includes/class-wp-posts-list-table.php
index 75d084e55aa4c..8e09bbeb0b4ff 100644
--- a/src/wp-admin/includes/class-wp-posts-list-table.php
+++ b/src/wp-admin/includes/class-wp-posts-list-table.php
@@ -1548,7 +1548,7 @@ protected function handle_row_actions( $item, $column_name, $primary ) {
 						esc_url( $preview_link ),
 						/* translators: %s: Post title. */
 						esc_attr( sprintf( __( 'Preview &#8220;%s&#8221;' ), $title ) ),
-						__( 'Preview' )
+						_x( 'Preview', 'verb' )
 					);
 				}
 			} elseif ( 'trash' !== $post->post_status ) {
diff --git a/src/wp-admin/includes/class-wp-theme-install-list-table.php b/src/wp-admin/includes/class-wp-theme-install-list-table.php
index 696b088d1d716..6e7b9d9279015 100644
--- a/src/wp-admin/includes/class-wp-theme-install-list-table.php
+++ b/src/wp-admin/includes/class-wp-theme-install-list-table.php
@@ -345,7 +345,7 @@ public function single_row( $theme ) {
 			'<a class="install-theme-preview" href="%s" aria-label="%s">%s</a>',
 			esc_url( $preview_url ),
 			esc_attr( $preview_title ),
-			__( 'Preview' )
+			_x( 'Preview', 'verb' )
 		);
 
 		/**
diff --git a/src/wp-admin/includes/meta-boxes.php b/src/wp-admin/includes/meta-boxes.php
index 0884c110b65bd..535a00cd3fe94 100644
--- a/src/wp-admin/includes/meta-boxes.php
+++ b/src/wp-admin/includes/meta-boxes.php
@@ -70,7 +70,7 @@ function post_submit_meta_box( $post, $args = array() ) {
 				if ( 'publish' === $post->post_status ) {
 					$preview_button_text = __( 'Preview Changes' );
 				} else {
-					$preview_button_text = __( 'Preview' );
+					$preview_button_text = _x( 'Preview', 'verb' );
 				}
 
 				$preview_button = sprintf(
diff --git a/src/wp-admin/includes/post.php b/src/wp-admin/includes/post.php
index 8d52c1487a7a5..d32f5d6889e58 100644
--- a/src/wp-admin/includes/post.php
+++ b/src/wp-admin/includes/post.php
@@ -1900,7 +1900,7 @@ function _admin_notice_post_locked() {
 		<p>
 		<a class="button" href="<?php echo esc_url( $sendback ); ?>"><?php echo $sendback_text; ?></a>
 		<?php if ( $preview_link ) { ?>
-		<a class="button<?php echo $tab_last; ?>" href="<?php echo esc_url( $preview_link ); ?>"><?php _e( 'Preview' ); ?></a>
+		<a class="button<?php echo $tab_last; ?>" href="<?php echo esc_url( $preview_link ); ?>"><?php echo esc_html_x( 'Preview', 'verb' ); ?></a>
 			<?php
 		}
 
diff --git a/src/wp-admin/theme-install.php b/src/wp-admin/theme-install.php
index 861eb87050814..5723f8e6244cc 100644
--- a/src/wp-admin/theme-install.php
+++ b/src/wp-admin/theme-install.php
@@ -422,7 +422,7 @@
 							<a class="button load-customize" href="{{ data.customize_url }}"><?php _e( 'Customize' ); ?></a>
 						<# } #>
 					<# } else { #>
-						<button class="button preview install-theme-preview"><?php _e( 'Preview' ); ?></button>
+						<button class="button preview install-theme-preview"><?php echo esc_html_x( 'Preview', 'verb' ); ?></button>
 					<# } #>
 				<# } else { #>
 					<?php
@@ -435,7 +435,7 @@
 					<# if ( data.customize_url ) { #>
 						<a class="button disabled"><?php _e( 'Live Preview' ); ?></a>
 					<# } else { #>
-						<button class="button disabled"><?php _e( 'Preview' ); ?></button>
+						<button class="button disabled"><?php echo esc_html_x( 'Preview', 'verb' ); ?></button>
 					<# } #>
 				<# } #>
 			<# } else { #>
@@ -445,14 +445,14 @@
 					$aria_label = sprintf( _x( 'Install %s', 'theme' ), '{{ data.name }}' );
 					?>
 					<a class="button button-primary theme-install" data-name="{{ data.name }}" data-slug="{{ data.id }}" href="{{ data.install_url }}" aria-label="<?php echo esc_attr( $aria_label ); ?>"><?php _e( 'Install' ); ?></a>
-					<button class="button preview install-theme-preview"><?php _e( 'Preview' ); ?></button>
+					<button class="button preview install-theme-preview"><?php echo esc_html_x( 'Preview', 'verb' ); ?></button>
 				<# } else { #>
 					<?php
 					/* translators: %s: Theme name. */
 					$aria_label = sprintf( _x( 'Cannot Install %s', 'theme' ), '{{ data.name }}' );
 					?>
 					<a class="button button-primary disabled" data-name="{{ data.name }}" aria-label="<?php echo esc_attr( $aria_label ); ?>"><?php _ex( 'Cannot Install', 'theme' ); ?></a>
-					<button class="button disabled"><?php _e( 'Preview' ); ?></button>
+					<button class="button disabled"><?php echo esc_html_x( 'Preview', 'verb' ); ?></button>
 				<# } #>
 			<# } #>
 		</div>
@@ -605,7 +605,7 @@
 			</div>
 		</div>
 		<div class="wp-full-overlay-main">
-		<iframe src="{{ data.preview_url }}" title="<?php esc_attr_e( 'Preview' ); ?>"></iframe>
+		<iframe src="{{ data.preview_url }}" title="<?php echo esc_attr_x( 'Preview', 'noun' ); ?>"></iframe>
 	</div>
 </script>
 
diff --git a/src/wp-includes/class-wp-customize-manager.php b/src/wp-includes/class-wp-customize-manager.php
index 961910e011d12..381d1db600c0e 100644
--- a/src/wp-includes/class-wp-customize-manager.php
+++ b/src/wp-includes/class-wp-customize-manager.php
@@ -4333,7 +4333,7 @@ public function render_control_templates() {
 						<# if ( data.returnUrl !== data.previewUrl ) { #>
 							<a class="button customize-notice-go-back-button" href="{{ data.returnUrl }}"><?php _e( 'Go back' ); ?></a>
 						<# } #>
-						<a class="button customize-notice-preview-button" href="{{ data.frontendPreviewUrl }}"><?php _e( 'Preview' ); ?></a>
+						<a class="button customize-notice-preview-button" href="{{ data.frontendPreviewUrl }}"><?php echo esc_html_x( 'Preview', 'verb' ); ?></a>
 						<# if ( data.allowOverride ) { #>
 							<button class="button button-primary wp-tab-last customize-notice-take-over-button"><?php _e( 'Take over' ); ?></button>
 						<# } #>
diff --git a/src/wp-includes/class-wp-editor.php b/src/wp-includes/class-wp-editor.php
index 7ddd60fe871b4..16884bdd4b02a 100644
--- a/src/wp-includes/class-wp-editor.php
+++ b/src/wp-includes/class-wp-editor.php
@@ -1252,7 +1252,7 @@ private static function get_translation() {
 				'Nonbreaking space'                    => __( 'Nonbreaking space' ),
 				'Page break'                           => __( 'Page break' ),
 				'Paste as text'                        => __( 'Paste as text' ),
-				'Preview'                              => __( 'Preview' ),
+				'Preview'                              => _x( 'Preview', 'verb' ),
 				'Print'                                => __( 'Print' ),
 				'Save'                                 => __( 'Save' ),
 				'Fullscreen'                           => __( 'Fullscreen' ),