From 67d404eec1da08602d54525bab8607f061c4aa5d Mon Sep 17 00:00:00 2001
From: Khokan Sardar <itzmekhokan@gmail.com>
Date: Tue, 12 May 2026 18:37:54 +0530
Subject: [PATCH 1/3] I18N: Replace 'toggle' with clearer alternatives in
 wp-admin strings.
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Replace user-facing uses of 'toggle' in wp-admin translatable strings
with clearer alternatives per style guide recommendations from Microsoft,
Apple, and IBM.

- template.php: 'Toggle panel: %s' → 'Show or hide panel: %s'
- site-health.php: 'Toggle extra menu items' → 'Show or hide extra menu items'
- network.php: 'toggle between' → 'switch between'

These changes improve clarity for screen reader users and align with
established writing style guidelines that recommend avoiding 'toggle'
as a verb in user-facing materials.

See #34753.
---
 src/wp-admin/includes/template.php | 2 +-
 src/wp-admin/network.php           | 2 +-
 src/wp-admin/site-health.php       | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/wp-admin/includes/template.php b/src/wp-admin/includes/template.php
index 6680bca89691a..3ab94ccf3af1c 100644
--- a/src/wp-admin/includes/template.php
+++ b/src/wp-admin/includes/template.php
@@ -1426,7 +1426,7 @@ function do_meta_boxes( $screen, $context, $data_object ) {
 						echo '<button type="button" class="handlediv" aria-expanded="true">';
 						echo '<span class="screen-reader-text">' . sprintf(
 							/* translators: %s: Hidden accessibility text. Meta box title. */
-							__( 'Toggle panel: %s' ),
+							__( 'Show or hide panel: %s' ),
 							$widget_title
 						) . '</span>';
 						echo '<span class="toggle-indicator" aria-hidden="true"></span>';
diff --git a/src/wp-admin/network.php b/src/wp-admin/network.php
index 99638dabc3ab6..3e5641ceaf6fe 100644
--- a/src/wp-admin/network.php
+++ b/src/wp-admin/network.php
@@ -62,7 +62,7 @@
 	'<p>' . __( 'Choose subdomains or subdirectories; this can only be switched afterwards by reconfiguring your installation. Fill out the network details, and click Install. If this does not work, you may have to add a wildcard DNS record (for subdomains) or change to another setting in Permalinks (for subdirectories).' ) . '</p>' .
 	'<p>' . __( 'The next screen for Network Setup will give you individually-generated lines of code to add to your wp-config.php and .htaccess files. Make sure the settings of your FTP client make files starting with a dot visible, so that you can find .htaccess; you may have to create this file if it really is not there. Make backup copies of those two files.' ) . '</p>' .
 	'<p>' . __( 'Add the designated lines of code to wp-config.php (just before <code>/*...stop editing...*/</code>) and <code>.htaccess</code> (replacing the existing WordPress rules).' ) . '</p>' .
-	'<p>' . __( 'Once you add this code and refresh your browser, multisite should be enabled. This screen, now in the Network Admin navigation menu, will keep an archive of the added code. You can toggle between Network Admin and Site Admin by clicking on the Network Admin or an individual site name under the My Sites dropdown in the Toolbar.' ) . '</p>' .
+	'<p>' . __( 'Once you add this code and refresh your browser, multisite should be enabled. This screen, now in the Network Admin navigation menu, will keep an archive of the added code. You can switch between Network Admin and Site Admin by clicking on the Network Admin or an individual site name under the My Sites dropdown in the Toolbar.' ) . '</p>' .
 	'<p>' . __( 'The choice of subdirectory sites is disabled if this setup is more than a month old because of permalink problems with &#8220;/blog/&#8221; from the main site. This disabling will be addressed in a future version.' ) . '</p>' .
 	'<p><strong>' . __( 'For more information:' ) . '</strong></p>' .
 	'<p>' . __( '<a href="https://developer.wordpress.org/advanced-administration/multisite/create-network/">Documentation on Creating a Network</a>' ) . '</p>' .
diff --git a/src/wp-admin/site-health.php b/src/wp-admin/site-health.php
index ac6dd1523e7ca..1a70e2e1dd8f1 100644
--- a/src/wp-admin/site-health.php
+++ b/src/wp-admin/site-health.php
@@ -173,7 +173,7 @@
 				<span class="screen-reader-text">
 					<?php
 					/* translators: Hidden accessibility text. */
-					_e( 'Toggle extra menu items' );
+					_e( 'Show or hide extra menu items' );
 					?>
 				</span>
 

From 54fee7a3d8da4b555f733d5b330b9baca3133360 Mon Sep 17 00:00:00 2001
From: Khokan Sardar <itzmekhokan@gmail.com>
Date: Tue, 12 May 2026 18:39:15 +0530
Subject: [PATCH 2/3] I18N: Replace 'toggle' with clearer alternatives in
 wp-includes strings.
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Replace user-facing uses of 'toggle' in wp-includes translatable strings
with clearer alternatives per style guide recommendations.

- class-wp-editor.php: 'toggle this option off' → 'turn this option off'
- script-loader.php: 'Toggle Editor Text Direction' → 'Switch Editor Text Direction'

Note: The TinyMCE array key 'Toolbar Toggle' (used as a mapping key for
the TinyMCE translation system) is preserved as-is, since changing the
key would break the TinyMCE translation mapping. The 'Toolbar Toggle'
label refers to a specific TinyMCE button name.

See #34753.
---
 src/wp-includes/class-wp-editor.php | 2 +-
 src/wp-includes/script-loader.php   | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/wp-includes/class-wp-editor.php b/src/wp-includes/class-wp-editor.php
index 7ddd60fe871b4..b8d7d7b7c090f 100644
--- a/src/wp-includes/class-wp-editor.php
+++ b/src/wp-includes/class-wp-editor.php
@@ -1364,7 +1364,7 @@ private static function get_translation() {
 				/* translators: Word count. */
 				'Words: {0}'                           => sprintf( __( 'Words: %s' ), '{0}' ),
 				'Paste is now in plain text mode. Contents will now be pasted as plain text until you toggle this option off.' =>
-					__( 'Paste is now in plain text mode. Contents will now be pasted as plain text until you toggle this option off.' ) . "\n\n" .
+					__( 'Paste is now in plain text mode. Contents will now be pasted as plain text until you turn this option off.' ) . "\n\n" .
 					__( 'If you are looking to paste rich content from Microsoft Word, try turning this option off. The editor will clean up text pasted from Word automatically.' ),
 				'Rich Text Area. Press ALT-F9 for menu. Press ALT-F10 for toolbar. Press ALT-0 for help' =>
 					__( 'Rich Text Area. Press Alt-Shift-H for help.' ),
diff --git a/src/wp-includes/script-loader.php b/src/wp-includes/script-loader.php
index 42d42b3f8781d..94561de8931b9 100644
--- a/src/wp-includes/script-loader.php
+++ b/src/wp-includes/script-loader.php
@@ -803,7 +803,7 @@ function wp_default_scripts( $scripts ) {
 			'enterImageURL'         => __( 'Enter the URL of the image' ),
 			'enterImageDescription' => __( 'Enter a description of the image' ),
 			'textdirection'         => __( 'text direction' ),
-			'toggleTextdirection'   => __( 'Toggle Editor Text Direction' ),
+			'toggleTextdirection'   => __( 'Switch Editor Text Direction' ),
 			'dfw'                   => __( 'Distraction-free writing mode' ),
 			'strong'                => __( 'Bold' ),
 			'strongClose'           => __( 'Close bold tag' ),

From b125532a2a20a341379a42555f2fbe7f857ad25a Mon Sep 17 00:00:00 2001
From: Khokan Sardar <itzmekhokan@gmail.com>
Date: Tue, 12 May 2026 18:41:42 +0530
Subject: [PATCH 3/3] I18N: Replace 'Toolbar Toggle' label and related help
 text.

Update the TinyMCE 'Toolbar Toggle' button tooltip from 'Toolbar Toggle'
to 'Show or hide the toolbar' for better clarity. The TinyMCE array key
remains unchanged to maintain compatibility with the TinyMCE translation
mapping system.

Also update the corresponding help text in edit-form-advanced.php to
match the new button description and avoid using 'toggle'.

See #34753.
---
 src/wp-admin/edit-form-advanced.php | 2 +-
 src/wp-includes/class-wp-editor.php | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/wp-admin/edit-form-advanced.php b/src/wp-admin/edit-form-advanced.php
index c5092029543db..2b113c7eb9a3f 100644
--- a/src/wp-admin/edit-form-advanced.php
+++ b/src/wp-admin/edit-form-advanced.php
@@ -284,7 +284,7 @@
 
 	$title_and_editor  = '<p>' . __( '<strong>Title</strong> &mdash; Enter a title for your post. After you enter a title, you&#8217;ll see the permalink below, which you can edit.' ) . '</p>';
 	$title_and_editor .= '<p>' . __( '<strong>Post editor</strong> &mdash; Enter the text for your post. There are two modes of editing: Visual and Code. Choose the mode by clicking on the appropriate tab.' ) . '</p>';
-	$title_and_editor .= '<p>' . __( 'Visual mode gives you an editor that is similar to a word processor. Click the Toolbar Toggle button to get a second row of controls.' ) . '</p>';
+	$title_and_editor .= '<p>' . __( 'Visual mode gives you an editor that is similar to a word processor. Use the toolbar button to show or hide a second row of controls.' ) . '</p>';
 	$title_and_editor .= '<p>' . __( 'The Code mode allows you to enter HTML along with your post text. Note that &lt;p&gt; and &lt;br&gt; tags are converted to line breaks when switching to the Code editor to make it less cluttered. When you type, a single line break can be used instead of typing &lt;br&gt;, and two line breaks instead of paragraph tags. The line breaks are converted back to tags automatically.' ) . '</p>';
 	$title_and_editor .= '<p>' . __( 'You can insert media files by clicking the button above the post editor and following the directions. You can align or edit images using the inline formatting toolbar available in Visual mode.' ) . '</p>';
 	$title_and_editor .= '<p>' . __( 'You can enable distraction-free writing mode using the icon to the right. This feature is not available for old browsers or devices with small screens, and requires that the full-height editor be enabled in Screen Options.' ) . '</p>';
diff --git a/src/wp-includes/class-wp-editor.php b/src/wp-includes/class-wp-editor.php
index b8d7d7b7c090f..799dab0cfbd84 100644
--- a/src/wp-includes/class-wp-editor.php
+++ b/src/wp-includes/class-wp-editor.php
@@ -1384,7 +1384,7 @@ private static function get_translation() {
 				'Format'                               => _x( 'Format', 'TinyMCE menu' ),
 
 				// WordPress strings.
-				'Toolbar Toggle'                       => array( __( 'Toolbar Toggle' ), 'accessZ' ),
+				'Toolbar Toggle'                       => array( __( 'Show or hide the toolbar' ), 'accessZ' ),
 				'Insert Read More tag'                 => array( __( 'Insert Read More tag' ), 'accessT' ),
 				'Insert Page Break tag'                => array( __( 'Insert Page Break tag' ), 'accessP' ),
 				'Read more...'                         => __( 'Read more...' ), // Title on the placeholder inside the editor (no ellipsis).