Commit 83a96a2ee9b for woocommerce
commit 83a96a2ee9b9c0ed2ca460f88416f920457fca6b
Author: Karol Manijak <20098064+kmanijak@users.noreply.github.com>
Date: Thu Aug 27 09:47:30 2026 +0200
Update Mini-Cart default labels (#67469)
* Update Mini-Cart default labels
* Add changelog entry for Mini-Cart label updates
* Fix Mini-Cart E2E label assertions
* Fix grammar in FSE translation guide
* Update Mini-Cart checkout label to Go to checkout
* Improve FSE translation guide wording
diff --git a/plugins/woocommerce/changelog/update-mini-cart-default-labels b/plugins/woocommerce/changelog/update-mini-cart-default-labels
new file mode 100644
index 00000000000..3e2c7c48e58
--- /dev/null
+++ b/plugins/woocommerce/changelog/update-mini-cart-default-labels
@@ -0,0 +1,4 @@
+Significance: patch
+Type: update
+
+Update the default Mini-Cart labels.
diff --git a/plugins/woocommerce/client/blocks/assets/js/blocks/mini-cart/mini-cart-contents/inner-blocks/mini-cart-cart-button-block/constants.tsx b/plugins/woocommerce/client/blocks/assets/js/blocks/mini-cart/mini-cart-contents/inner-blocks/mini-cart-cart-button-block/constants.tsx
index c68b21f9156..dc9ebc456e0 100644
--- a/plugins/woocommerce/client/blocks/assets/js/blocks/mini-cart/mini-cart-contents/inner-blocks/mini-cart-cart-button-block/constants.tsx
+++ b/plugins/woocommerce/client/blocks/assets/js/blocks/mini-cart/mini-cart-contents/inner-blocks/mini-cart-cart-button-block/constants.tsx
@@ -3,4 +3,4 @@
*/
import { __ } from '@wordpress/i18n';
-export const defaultCartButtonLabel = __( 'View my cart', 'woocommerce' );
+export const defaultCartButtonLabel = __( 'View cart', 'woocommerce' );
diff --git a/plugins/woocommerce/client/blocks/assets/js/blocks/mini-cart/mini-cart-contents/inner-blocks/mini-cart-footer-block/constants.ts b/plugins/woocommerce/client/blocks/assets/js/blocks/mini-cart/mini-cart-contents/inner-blocks/mini-cart-footer-block/constants.ts
index 0418ea73408..a5d5ceef165 100644
--- a/plugins/woocommerce/client/blocks/assets/js/blocks/mini-cart/mini-cart-contents/inner-blocks/mini-cart-footer-block/constants.ts
+++ b/plugins/woocommerce/client/blocks/assets/js/blocks/mini-cart/mini-cart-contents/inner-blocks/mini-cart-footer-block/constants.ts
@@ -3,6 +3,6 @@
*/
import { __ } from '@wordpress/i18n';
-export const defaultCartButtonLabel = __( 'View my cart', 'woocommerce' );
+export const defaultCartButtonLabel = __( 'View cart', 'woocommerce' );
export const defaultCheckoutButtonLabel = __( 'Go to checkout', 'woocommerce' );
diff --git a/plugins/woocommerce/client/blocks/assets/js/blocks/mini-cart/mini-cart-contents/inner-blocks/mini-cart-shopping-button-block/constants.tsx b/plugins/woocommerce/client/blocks/assets/js/blocks/mini-cart/mini-cart-contents/inner-blocks/mini-cart-shopping-button-block/constants.tsx
index f4155ca4d8e..f9e59715603 100644
--- a/plugins/woocommerce/client/blocks/assets/js/blocks/mini-cart/mini-cart-contents/inner-blocks/mini-cart-shopping-button-block/constants.tsx
+++ b/plugins/woocommerce/client/blocks/assets/js/blocks/mini-cart/mini-cart-contents/inner-blocks/mini-cart-shopping-button-block/constants.tsx
@@ -4,6 +4,6 @@
import { __ } from '@wordpress/i18n';
export const defaultStartShoppingButtonLabel = __(
- 'Start shopping',
+ 'Return to shop',
'woocommerce'
);
diff --git a/plugins/woocommerce/client/blocks/docs/internal-developers/translations/translations-in-FSE-templates.md b/plugins/woocommerce/client/blocks/docs/internal-developers/translations/translations-in-FSE-templates.md
index 669bc11a03a..798641879f8 100644
--- a/plugins/woocommerce/client/blocks/docs/internal-developers/translations/translations-in-FSE-templates.md
+++ b/plugins/woocommerce/client/blocks/docs/internal-developers/translations/translations-in-FSE-templates.md
@@ -31,7 +31,7 @@ Let's take a look at `templates/parts/mini-cart.html`:
<div class="wp-block-woocommerce-empty-mini-cart-contents-block">
<!-- wp:paragraph {"align":"center"} -->
<p class="has-text-align-center">
- <strong>Your cart is currently empty!</strong>
+ <strong>Your shopping cart is empty</strong>
</p>
<!-- /wp:paragraph -->
@@ -48,21 +48,21 @@ This FSE-template contains the following part:
```html
<p class="has-text-align-center">
- <strong>Your cart is currently empty!</strong>
+ <strong>Your shopping cart is empty</strong>
</p>
```
Having this text hardcoded in a FSE-template causes two problems:
1. This string can only be edited, when a user is using an FSE-theme, such as [Twenty Twenty-Two](https://wordpress.org/themes/twentytwentytwo/). If the user is using a non-FSE-theme, such as [Twenty Twenty-One](https://wordpress.org/themes/twentytwentyone/) or older, this FSE-template cannot be edited.
-2. Even is a user is using an FSE-theme, every user that is using a site language other than the default one, has to manually change the string `Your cart is currently empty!`.
+2. Even if a user is using an FSE-theme, every user who uses a site language other than the default must manually change the string `Your shopping cart is empty`.
To handle translations within FSE-templates, we need to find the following code:
```html
<!-- wp:paragraph {"align":"center"} -->
<p class="has-text-align-center">
- <strong>Your cart is currently empty!</strong>
+ <strong>Your shopping cart is empty</strong>
</p>
<!-- /wp:paragraph -->
```
@@ -85,7 +85,7 @@ public function register_empty_cart_message_block_pattern() {
array(
'title' => __( 'Empty Mini-Cart Message', 'woocommerce' ),
'inserter' => false,
- 'content' => '<!-- wp:paragraph {"align":"center"} --><p class="has-text-align-center"><strong>' . __( 'Your cart is currently empty!', 'woocommerce' ) . '</strong></p><!-- /wp:paragraph -->',
+ 'content' => '<!-- wp:paragraph {"align":"center"} --><p class="has-text-align-center"><strong>' . __( 'Your shopping cart is empty', 'woocommerce' ) . '</strong></p><!-- /wp:paragraph -->',
)
);
}
diff --git a/plugins/woocommerce/src/Blocks/BlockTypes/MiniCart.php b/plugins/woocommerce/src/Blocks/BlockTypes/MiniCart.php
index 7fc3a35cd7b..a7e0e58a744 100644
--- a/plugins/woocommerce/src/Blocks/BlockTypes/MiniCart.php
+++ b/plugins/woocommerce/src/Blocks/BlockTypes/MiniCart.php
@@ -730,7 +730,7 @@ class MiniCart extends AbstractBlock {
array(
'title' => __( 'Empty Mini-Cart Message', 'woocommerce' ),
'inserter' => false,
- 'content' => '<!-- wp:paragraph {"align":"center"} --><p class="has-text-align-center"><strong>' . __( 'Your cart is currently empty!', 'woocommerce' ) . '</strong></p><!-- /wp:paragraph -->',
+ 'content' => '<!-- wp:paragraph {"align":"center"} --><p class="has-text-align-center"><strong>' . __( 'Your shopping cart is empty', 'woocommerce' ) . '</strong></p><!-- /wp:paragraph -->',
)
);
}
diff --git a/plugins/woocommerce/src/Blocks/BlockTypes/MiniCartCartButtonBlock.php b/plugins/woocommerce/src/Blocks/BlockTypes/MiniCartCartButtonBlock.php
index 486b79d6b79..ec369c46353 100644
--- a/plugins/woocommerce/src/Blocks/BlockTypes/MiniCartCartButtonBlock.php
+++ b/plugins/woocommerce/src/Blocks/BlockTypes/MiniCartCartButtonBlock.php
@@ -21,7 +21,7 @@ class MiniCartCartButtonBlock extends AbstractInnerBlock {
* @return string Rendered block type output.
*/
protected function render( $attributes, $content, $block ) {
- $default_view_cart_text = __( 'View my cart', 'woocommerce' );
+ $default_view_cart_text = __( 'View cart', 'woocommerce' );
$view_cart_text = $attributes['cartButtonLabel'] ? $attributes['cartButtonLabel'] : $default_view_cart_text;
$cart_page_id = wc_get_page_id( 'cart' );
$cart_page_url = get_permalink( $cart_page_id );
diff --git a/plugins/woocommerce/src/Blocks/BlockTypes/MiniCartShoppingButtonBlock.php b/plugins/woocommerce/src/Blocks/BlockTypes/MiniCartShoppingButtonBlock.php
index 53610e11a05..76740b48860 100644
--- a/plugins/woocommerce/src/Blocks/BlockTypes/MiniCartShoppingButtonBlock.php
+++ b/plugins/woocommerce/src/Blocks/BlockTypes/MiniCartShoppingButtonBlock.php
@@ -23,7 +23,7 @@ class MiniCartShoppingButtonBlock extends AbstractInnerBlock {
protected function render( $attributes, $content, $block ) {
ob_start();
$shop_url = wc_get_page_permalink( 'shop' );
- $default_start_shopping_label = __( 'Start shopping', 'woocommerce' );
+ $default_start_shopping_label = __( 'Return to shop', 'woocommerce' );
$start_shopping_label = $attributes['startShoppingButtonLabel'] ? $attributes['startShoppingButtonLabel'] : $default_start_shopping_label;
$wrapper_attributes = get_block_wrapper_attributes( array( 'class' => 'wc-block-components-button wp-element-button wc-block-mini-cart__shopping-button' ) );
?>
diff --git a/plugins/woocommerce/tests/e2e/tests/blocks/mini-cart/mini-cart.block_theme.spec.ts b/plugins/woocommerce/tests/e2e/tests/blocks/mini-cart/mini-cart.block_theme.spec.ts
index 47921c85373..dd6312ec7c1 100644
--- a/plugins/woocommerce/tests/e2e/tests/blocks/mini-cart/mini-cart.block_theme.spec.ts
+++ b/plugins/woocommerce/tests/e2e/tests/blocks/mini-cart/mini-cart.block_theme.spec.ts
@@ -103,8 +103,11 @@ test.describe( `${ blockData.name } Block`, () => {
await miniCartUtils.openMiniCart();
await expect( page.getByRole( 'dialog' ) ).toContainText(
- 'Your cart is currently empty!'
+ 'Your shopping cart is empty'
);
+ await expect(
+ page.getByRole( 'link', { name: 'Return to shop' } )
+ ).toBeVisible();
} );
test( 'should close the drawer when clicking on the close button', async ( {
@@ -116,7 +119,7 @@ test.describe( `${ blockData.name } Block`, () => {
await miniCartUtils.openMiniCart();
await expect( page.getByRole( 'dialog' ) ).toContainText(
- 'Your cart is currently empty!'
+ 'Your shopping cart is empty'
);
await page.getByRole( 'button', { name: 'Close' } ).click();
@@ -132,7 +135,7 @@ test.describe( `${ blockData.name } Block`, () => {
await miniCartUtils.openMiniCart();
await expect( page.getByRole( 'dialog' ) ).toContainText(
- 'Your cart is currently empty!'
+ 'Your shopping cart is empty'
);
await page.mouse.click( 0, 0 );
@@ -241,15 +244,18 @@ test.describe( `${ blockData.name } Block`, () => {
await frontendUtils.goToShop();
await frontendUtils.addToCart( REGULAR_PRICED_PRODUCT_NAME );
await miniCartUtils.openMiniCart();
+ const miniCartDialog = page.getByRole( 'dialog' );
await expect( page.getByText( 'Subtotal' ) ).toBeVisible();
await expect(
- page.getByRole( 'link', { name: 'View my cart' } )
+ miniCartDialog.getByRole( 'link', { name: 'View cart' } )
).toBeVisible();
await expect(
- page.getByRole( 'link', { name: 'Go to checkout' } )
+ miniCartDialog.getByRole( 'link', {
+ name: 'Go to checkout',
+ } )
).toBeVisible();
} );
@@ -312,7 +318,7 @@ test.describe( `${ blockData.name } Block`, () => {
.click();
await expect(
- page.getByText( 'Your cart is currently empty!' )
+ page.getByText( 'Your shopping cart is empty' )
).toBeVisible();
} );
@@ -324,7 +330,10 @@ test.describe( `${ blockData.name } Block`, () => {
await frontendUtils.goToShop();
await frontendUtils.addToCart( REGULAR_PRICED_PRODUCT_NAME );
await miniCartUtils.openMiniCart();
- await page.getByRole( 'link', { name: 'View my cart' } ).click();
+ await page
+ .getByRole( 'dialog' )
+ .getByRole( 'link', { name: 'View cart' } )
+ .click();
await expect( page ).toHaveURL( /\/cart\/?$/ );
} );
@@ -336,7 +345,10 @@ test.describe( `${ blockData.name } Block`, () => {
await frontendUtils.goToShop();
await frontendUtils.addToCart( REGULAR_PRICED_PRODUCT_NAME );
await miniCartUtils.openMiniCart();
- await page.getByRole( 'link', { name: 'Go to checkout' } ).click();
+ await page
+ .getByRole( 'dialog' )
+ .getByRole( 'link', { name: 'Go to checkout' } )
+ .click();
await expect( page ).toHaveURL( /\/checkout\/?$/ );
} );
diff --git a/plugins/woocommerce/tests/e2e/tests/cart/add-to-cart.spec.ts b/plugins/woocommerce/tests/e2e/tests/cart/add-to-cart.spec.ts
index 68e72014fa3..ba519a099f5 100644
--- a/plugins/woocommerce/tests/e2e/tests/cart/add-to-cart.spec.ts
+++ b/plugins/woocommerce/tests/e2e/tests/cart/add-to-cart.spec.ts
@@ -126,7 +126,7 @@ test.describe(
page.locator(
'.wc-block-mini-cart__empty-cart-wrapper'
)
- ).toContainText( 'Your cart is currently empty!' );
+ ).toContainText( 'Your shopping cart is empty' );
} );
}
);
diff --git a/plugins/woocommerce/tests/e2e/themes/blocks/storefront-child__with-block-template-part/parts/mini-cart.html b/plugins/woocommerce/tests/e2e/themes/blocks/storefront-child__with-block-template-part/parts/mini-cart.html
index 80c2e89b311..0d2280ddcf6 100644
--- a/plugins/woocommerce/tests/e2e/themes/blocks/storefront-child__with-block-template-part/parts/mini-cart.html
+++ b/plugins/woocommerce/tests/e2e/themes/blocks/storefront-child__with-block-template-part/parts/mini-cart.html
@@ -33,7 +33,7 @@
<!-- wp:woocommerce/empty-mini-cart-contents-block -->
<div class="wp-block-woocommerce-empty-mini-cart-contents-block"><!-- wp:paragraph {"align":"center"} -->
- <p class="has-text-align-center"><strong>Your cart is currently empty!</strong></p>
+ <p class="has-text-align-center"><strong>Your shopping cart is empty</strong></p>
<!-- /wp:paragraph -->
<!-- wp:woocommerce/mini-cart-shopping-button-block -->
diff --git a/plugins/woocommerce/tests/e2e/themes/blocks/theme-with-woo-templates/block-template-parts/mini-cart.html b/plugins/woocommerce/tests/e2e/themes/blocks/theme-with-woo-templates/block-template-parts/mini-cart.html
index e4982b99835..f277edf3896 100644
--- a/plugins/woocommerce/tests/e2e/themes/blocks/theme-with-woo-templates/block-template-parts/mini-cart.html
+++ b/plugins/woocommerce/tests/e2e/themes/blocks/theme-with-woo-templates/block-template-parts/mini-cart.html
@@ -33,7 +33,7 @@
<!-- wp:woocommerce/empty-mini-cart-contents-block -->
<div class="wp-block-woocommerce-empty-mini-cart-contents-block"><!-- wp:paragraph {"align":"center"} -->
- <p class="has-text-align-center"><strong>Your cart is currently empty!</strong></p>
+ <p class="has-text-align-center"><strong>Your shopping cart is empty</strong></p>
<!-- /wp:paragraph -->
<!-- wp:woocommerce/mini-cart-shopping-button-block -->