From d4e3247ec07bda51c51d8c1e0ca4216e7ff4d4a0 Mon Sep 17 00:00:00 2001 From: Lucio Giannotta Date: Mon, 12 Sep 2022 10:39:26 +0200 Subject: [PATCH] Improve public-facing texts and labels (#7045) We noticed that oftentimes our labels and text tend to be overly technical or unclear. We decided to do a bulk pass to improve the readability to non-technical users. --- .../category-list/constants.tsx | 2 +- .../blocks/product-elements/image/edit.js | 2 +- .../product-elements/tag-list/constants.js | 2 +- .../add-to-cart-form/form-state/index.js | 2 +- .../add-to-cart-form/form/submit/index.js | 2 +- .../cart-checkout/checkout-processor.js | 2 +- .../cart-checkout/checkout-state/index.tsx | 2 +- .../cart-checkout/checkout-state/utils.ts | 2 +- .../active-attribute-filters.tsx | 2 +- assets/js/blocks/active-filters/block.json | 2 +- assets/js/blocks/active-filters/index.tsx | 2 +- assets/js/blocks/attribute-filter/block.json | 4 +- assets/js/blocks/attribute-filter/block.tsx | 2 +- assets/js/blocks/attribute-filter/edit.tsx | 21 ++----- assets/js/blocks/attribute-filter/index.tsx | 2 +- .../express-payment/cart-express-payment.js | 2 +- .../no-payment-methods/index.js | 2 +- .../payment-method-error-boundary.js | 2 +- assets/js/blocks/cart/block.js | 5 +- .../cart-express-payment-block/edit.tsx | 2 +- assets/js/blocks/checkout/block.tsx | 2 +- .../attributes.tsx | 2 +- .../checkout-express-payment-block/edit.tsx | 2 +- .../checkout-shipping-methods-block/edit.tsx | 2 +- .../checkout-terms-block/block.json | 2 +- .../checkout-terms-block/edit.tsx | 2 +- .../checkout-terms-block/test/edit.js | 2 +- assets/js/blocks/classic-template/index.tsx | 6 +- .../featured-product/block.json | 11 +--- .../featured-items/featured-product/block.tsx | 2 +- .../featured-items/inspector-controls.tsx | 4 +- .../blocks/handpicked-products/edit-mode.tsx | 2 +- assets/js/blocks/mini-cart/edit.tsx | 2 +- .../empty-mini-cart-contents-block/block.json | 4 +- .../block.json | 4 +- .../block.json | 2 +- assets/js/blocks/price-filter/block.json | 2 +- assets/js/blocks/price-filter/edit.tsx | 4 +- assets/js/blocks/product-categories/block.js | 35 +----------- .../js/blocks/product-category/edit-mode.tsx | 4 +- assets/js/blocks/product-search/edit.js | 11 ---- assets/js/blocks/product-tag/block.js | 2 +- .../js/blocks/products/all-products/edit.js | 4 +- .../reviews/reviews-by-category/edit.js | 2 +- .../reviews/reviews-by-product/index.js | 2 +- assets/js/blocks/stock-filter/edit.tsx | 17 +----- assets/js/blocks/stock-filter/index.tsx | 2 +- .../error-placeholder/error-message.tsx | 2 +- .../grid-content-control/index.js | 55 ------------------- .../grid-layout-control/index.js | 4 +- .../product-tag-control/index.js | 2 +- .../testing/releases/790.md | 30 ++++------ .../translations/translation-loading.md | 3 +- .../translations-in-FSE-templates.md | 3 +- readme.txt | 4 +- src/BlockTypes/MiniCart.php | 2 +- src/Domain/Bootstrap.php | 2 +- .../Services/Email/CustomerNewAccount.php | 2 +- .../Routes/V1/ProductCollectionData.php | 2 +- 59 files changed, 90 insertions(+), 221 deletions(-) diff --git a/assets/js/atomic/blocks/product-elements/category-list/constants.tsx b/assets/js/atomic/blocks/product-elements/category-list/constants.tsx index f47e5355e5a..d72577a54b2 100644 --- a/assets/js/atomic/blocks/product-elements/category-list/constants.tsx +++ b/assets/js/atomic/blocks/product-elements/category-list/constants.tsx @@ -12,6 +12,6 @@ export const BLOCK_ICON: JSX.Element = ( ); export const BLOCK_DESCRIPTION: string = __( - 'Display a list of categories belonging to a product.', + 'Display the list of categories that are assigned to a product.', 'woo-gutenberg-products-block' ); diff --git a/assets/js/atomic/blocks/product-elements/image/edit.js b/assets/js/atomic/blocks/product-elements/image/edit.js index efa43b7f216..7d18c6461cf 100644 --- a/assets/js/atomic/blocks/product-elements/image/edit.js +++ b/assets/js/atomic/blocks/product-elements/image/edit.js @@ -74,7 +74,7 @@ const Edit = ( { attributes, setAttributes, context } ) => { 'woo-gutenberg-products-block' ) } help={ __( - 'Overlay a "sale" badge if the product is on-sale.', + 'Display a “sale” badge if the product is on-sale.', 'woo-gutenberg-products-block' ) } checked={ showSaleBadge } diff --git a/assets/js/atomic/blocks/product-elements/tag-list/constants.js b/assets/js/atomic/blocks/product-elements/tag-list/constants.js index 296e2168566..31322124467 100644 --- a/assets/js/atomic/blocks/product-elements/tag-list/constants.js +++ b/assets/js/atomic/blocks/product-elements/tag-list/constants.js @@ -12,6 +12,6 @@ export const BLOCK_ICON = ( ); export const BLOCK_DESCRIPTION = __( - 'Display a list of tags belonging to a product.', + 'Display the list of tags that are assigned to a product.', 'woo-gutenberg-products-block' ); diff --git a/assets/js/base/context/providers/add-to-cart-form/form-state/index.js b/assets/js/base/context/providers/add-to-cart-form/form-state/index.js index 83f181ee4a0..4f53876d59d 100644 --- a/assets/js/base/context/providers/add-to-cart-form/form-state/index.js +++ b/assets/js/base/context/providers/add-to-cart-form/form-state/index.js @@ -245,7 +245,7 @@ export const AddToCartFormStateContextProvider = ( { const message = data.processingResponse?.message || __( - 'Something went wrong. Please contact us to get assistance.', + 'Something went wrong. Please contact us for assistance.', 'woo-gutenberg-products-block' ); createErrorNotice( message, { diff --git a/assets/js/base/context/providers/add-to-cart-form/form/submit/index.js b/assets/js/base/context/providers/add-to-cart-form/form/submit/index.js index 9f0b3d6071b..ba0c0736af9 100644 --- a/assets/js/base/context/providers/add-to-cart-form/form/submit/index.js +++ b/assets/js/base/context/providers/add-to-cart-form/form/submit/index.js @@ -101,7 +101,7 @@ const FormSubmit = () => { } else { createErrorNotice( __( - 'Something went wrong. Please contact us to get assistance.', + 'Something went wrong. Please contact us for assistance.', 'woo-gutenberg-products-block' ), { diff --git a/assets/js/base/context/providers/cart-checkout/checkout-processor.js b/assets/js/base/context/providers/cart-checkout/checkout-processor.js index 585bc4dedc2..46ab6c46862 100644 --- a/assets/js/base/context/providers/cart-checkout/checkout-processor.js +++ b/assets/js/base/context/providers/cart-checkout/checkout-processor.js @@ -257,7 +257,7 @@ const CheckoutProcessor = () => { ), errorResponse?.message ?? __( - 'Something went wrong.', + 'Something went wrong. Please contact us for assistance.', 'woo-gutenberg-products-block' ) ), diff --git a/assets/js/base/context/providers/cart-checkout/checkout-state/index.tsx b/assets/js/base/context/providers/cart-checkout/checkout-state/index.tsx index 54317b23bc6..b516c1d4cd9 100644 --- a/assets/js/base/context/providers/cart-checkout/checkout-state/index.tsx +++ b/assets/js/base/context/providers/cart-checkout/checkout-state/index.tsx @@ -265,7 +265,7 @@ export const CheckoutStateProvider = ( { const message = data.processingResponse?.message || __( - 'Something went wrong. Please contact us to get assistance.', + 'Something went wrong. Please contact us for assistance.', 'woo-gutenberg-products-block' ); createErrorNotice( message, { diff --git a/assets/js/base/context/providers/cart-checkout/checkout-state/utils.ts b/assets/js/base/context/providers/cart-checkout/checkout-state/utils.ts index 5e93314a7a8..f6402578b29 100644 --- a/assets/js/base/context/providers/cart-checkout/checkout-state/utils.ts +++ b/assets/js/base/context/providers/cart-checkout/checkout-state/utils.ts @@ -53,7 +53,7 @@ export const getPaymentResultFromCheckoutResponse = ( response.data.status > 299 ) { paymentResult.message = __( - 'Something went wrong. Please contact us to get assistance.', + 'Something went wrong. Please contact us for assistance.', 'woo-gutenberg-products-block' ); } diff --git a/assets/js/blocks/active-filters/active-attribute-filters.tsx b/assets/js/blocks/active-filters/active-attribute-filters.tsx index 5519d4e053e..3f25106983b 100644 --- a/assets/js/blocks/active-filters/active-attribute-filters.tsx +++ b/assets/js/blocks/active-filters/active-attribute-filters.tsx @@ -98,7 +98,7 @@ const ActiveAttributeFilters = ( { if ( index > 0 && operator === 'and' ) { prefix = ( - { __( 'and', 'woo-gutenberg-products-block' ) } + { __( 'All', 'woo-gutenberg-products-block' ) } ); } diff --git a/assets/js/blocks/active-filters/block.json b/assets/js/blocks/active-filters/block.json index 83b791c35eb..c011201f401 100644 --- a/assets/js/blocks/active-filters/block.json +++ b/assets/js/blocks/active-filters/block.json @@ -2,7 +2,7 @@ "name": "woocommerce/active-filters", "version": "1.0.0", "title": "Active Product Filters", - "description": "Show the currently active product filters. Works in combination with the All Products and filters blocks.", + "description": "Display the currently active product filters.", "category": "woocommerce", "keywords": [ "WooCommerce" ], "supports": { diff --git a/assets/js/blocks/active-filters/index.tsx b/assets/js/blocks/active-filters/index.tsx index b1cb933b8c0..3f3e35a6ecb 100644 --- a/assets/js/blocks/active-filters/index.tsx +++ b/assets/js/blocks/active-filters/index.tsx @@ -19,7 +19,7 @@ import { Attributes } from './types'; registerBlockType( metadata, { title: __( 'Active Product Filters', 'woo-gutenberg-products-block' ), description: __( - 'Show the currently active product filters. Works in combination with the All Products and filters blocks.', + 'Display the currently active product filters.', 'woo-gutenberg-products-block' ), icon: { diff --git a/assets/js/blocks/attribute-filter/block.json b/assets/js/blocks/attribute-filter/block.json index 6cfea2f66eb..38625f3021e 100644 --- a/assets/js/blocks/attribute-filter/block.json +++ b/assets/js/blocks/attribute-filter/block.json @@ -2,7 +2,7 @@ "name": "woocommerce/attribute-filter", "version": "1.0.0", "title": "Filter by Attribute", - "description": "Allow customers to filter the grid by product attribute, such as color.", + "description": "Enable customers to filter the product grid by selecting one or more attributes, such as color.", "category": "woocommerce", "keywords": [ "WooCommerce" ], "supports": { @@ -48,7 +48,7 @@ }, "selectType": { "type": "string", - "default": "multiple" + "default": "multiple" }, "isPreview": { "type": "boolean", diff --git a/assets/js/blocks/attribute-filter/block.tsx b/assets/js/blocks/attribute-filter/block.tsx index 641270ec545..a7b2a13d266 100644 --- a/assets/js/blocks/attribute-filter/block.tsx +++ b/assets/js/blocks/attribute-filter/block.tsx @@ -495,7 +495,7 @@ const AttributeFilterBlock = ( {

{ __( - 'The selected attribute does not have any term assigned to products.', + 'There are no products with the selected attributes.', 'woo-gutenberg-products-block' ) }

diff --git a/assets/js/blocks/attribute-filter/edit.tsx b/assets/js/blocks/attribute-filter/edit.tsx index 83459e582e2..5c44864cf43 100644 --- a/assets/js/blocks/attribute-filter/edit.tsx +++ b/assets/js/blocks/attribute-filter/edit.tsx @@ -176,17 +176,6 @@ const Edit = ( { attributes, setAttributes, debouncedSpeak }: EditProps ) => { 'Include product count', 'woo-gutenberg-products-block' ) } - help={ - showCounts - ? __( - 'Show the product count with results.', - 'woo-gutenberg-products-block' - ) - : __( - 'Product count is hidden.', - 'woo-gutenberg-products-block' - ) - } checked={ showCounts } onChange={ () => setAttributes( { @@ -314,11 +303,11 @@ const Edit = ( { attributes, setAttributes, debouncedSpeak }: EditProps ) => { help={ showFilterButton ? __( - 'Products will only update when the button is pressed.', + 'Products will only update when the button is clicked.', 'woo-gutenberg-products-block' ) : __( - 'Products will update as options are selected.', + 'Products will update as soon as attributes are selected.', 'woo-gutenberg-products-block' ) } @@ -352,7 +341,7 @@ const Edit = ( { attributes, setAttributes, debouncedSpeak }: EditProps ) => { 'woo-gutenberg-products-block' ) } instructions={ __( - 'Display a list of filters based on a chosen attribute.', + 'Display a list of filters based on the selected attributes.', 'woo-gutenberg-products-block' ) } > @@ -387,7 +376,7 @@ const Edit = ( { attributes, setAttributes, debouncedSpeak }: EditProps ) => { setIsEditing( false ); debouncedSpeak( __( - 'Showing Filter by Attribute block preview.', + 'Now displaying a preview of the Filter Products by Attribute block.', 'woo-gutenberg-products-block' ) ); @@ -403,7 +392,7 @@ const Edit = ( { attributes, setAttributes, debouncedSpeak }: EditProps ) => { 'woo-gutenberg-products-block' ) } instructions={ __( - 'Display a list of filters based on a chosen attribute.', + 'Display a list of filters based on the selected attributes.', 'woo-gutenberg-products-block' ) } > diff --git a/assets/js/blocks/attribute-filter/index.tsx b/assets/js/blocks/attribute-filter/index.tsx index f1ff8908d2d..7081fd2b230 100644 --- a/assets/js/blocks/attribute-filter/index.tsx +++ b/assets/js/blocks/attribute-filter/index.tsx @@ -19,7 +19,7 @@ import metadata from './block.json'; registerBlockType( metadata, { title: __( 'Filter by Attribute', 'woo-gutenberg-products-block' ), description: __( - 'Allow customers to filter the grid by product attribute, such as color.', + 'Enable customers to filter the product grid by selecting one or more attributes, such as color.', 'woo-gutenberg-products-block' ), icon: { diff --git a/assets/js/blocks/cart-checkout-shared/payment-methods/express-payment/cart-express-payment.js b/assets/js/blocks/cart-checkout-shared/payment-methods/express-payment/cart-express-payment.js index 760a03f042e..aa3509613fb 100644 --- a/assets/js/blocks/cart-checkout-shared/payment-methods/express-payment/cart-express-payment.js +++ b/assets/js/blocks/cart-checkout-shared/payment-methods/express-payment/cart-express-payment.js @@ -66,7 +66,7 @@ const CartExpressPayment = () => {
{ /* translators: Shown in the Cart block between the express payment methods and the Proceed to Checkout button */ } - { __( 'Or', 'woo-gutenberg-products-block' ) } + { __( 'Any', 'woo-gutenberg-products-block' ) }
); diff --git a/assets/js/blocks/cart-checkout-shared/payment-methods/no-payment-methods/index.js b/assets/js/blocks/cart-checkout-shared/payment-methods/no-payment-methods/index.js index 92500e8823a..f6677acaaf4 100644 --- a/assets/js/blocks/cart-checkout-shared/payment-methods/no-payment-methods/index.js +++ b/assets/js/blocks/cart-checkout-shared/payment-methods/no-payment-methods/index.js @@ -38,7 +38,7 @@ const NoPaymentMethodsPlaceholder = () => { > { __( - 'Your store does not have any payment methods configured that support the checkout block. Once you have configured a compatible payment method it will be shown here.', + 'Your store does not have any payment methods that support the Checkout block. Once you have configured a compatible payment method it will be displayed here.', 'woo-gutenberg-products-block' ) } diff --git a/assets/js/blocks/cart-checkout-shared/payment-methods/payment-method-error-boundary.js b/assets/js/blocks/cart-checkout-shared/payment-methods/payment-method-error-boundary.js index 3cf7013c1fc..aef36cc8a55 100644 --- a/assets/js/blocks/cart-checkout-shared/payment-methods/payment-method-error-boundary.js +++ b/assets/js/blocks/cart-checkout-shared/payment-methods/payment-method-error-boundary.js @@ -24,7 +24,7 @@ class PaymentMethodErrorBoundary extends Component { if ( hasError ) { let errorText = __( - 'This site is experiencing difficulties with this payment method. Please contact the owner of the site for assistance.', + 'We are experiencing difficulties with this payment method. Please contact us for assistance.', 'woo-gutenberg-products-block' ); if ( isEditor || CURRENT_USER_IS_ADMIN ) { diff --git a/assets/js/blocks/cart/block.js b/assets/js/blocks/cart/block.js index 17e869010d6..98f1767f129 100644 --- a/assets/js/blocks/cart/block.js +++ b/assets/js/blocks/cart/block.js @@ -74,7 +74,10 @@ const ScrollOnError = ( { scrollToTop } ) => { }; const Block = ( { attributes, children, scrollToTop } ) => ( { > { __( - "Your store doesn't have any Payment Methods that support the Express Checkout Block. If they are added, they will be shown here.", + 'Your store does not have any payment methods that support the Express Checkout block. Once you have configured a compatible payment method, it will be displayed here.', 'woo-gutenberg-products-block' ) } diff --git a/assets/js/blocks/checkout/block.tsx b/assets/js/blocks/checkout/block.tsx index 17204ba34c0..cb4471b6665 100644 --- a/assets/js/blocks/checkout/block.tsx +++ b/assets/js/blocks/checkout/block.tsx @@ -145,7 +145,7 @@ const Block = ( { return ( { > { __( - "Your store doesn't have any Payment Methods that support the Express Checkout Block. If they are added, they will be shown here.", + 'Your store does not have any payment methods that support the Express Checkout block. Once you have configured a compatible payment method, it will be displayed here.', 'woo-gutenberg-products-block' ) } diff --git a/assets/js/blocks/checkout/inner-blocks/checkout-shipping-methods-block/edit.tsx b/assets/js/blocks/checkout/inner-blocks/checkout-shipping-methods-block/edit.tsx index 2c003a4c19d..c28fc32ea5e 100644 --- a/assets/js/blocks/checkout/inner-blocks/checkout-shipping-methods-block/edit.tsx +++ b/assets/js/blocks/checkout/inner-blocks/checkout-shipping-methods-block/edit.tsx @@ -65,7 +65,7 @@ export const Edit = ( { >

{ __( - 'You currently have the following shipping integrations active.', + 'The following shipping integrations are active on your store.', 'woo-gutenberg-products-block' ) }

diff --git a/assets/js/blocks/checkout/inner-blocks/checkout-terms-block/block.json b/assets/js/blocks/checkout/inner-blocks/checkout-terms-block/block.json index a189a8ebfd9..92a00488c72 100644 --- a/assets/js/blocks/checkout/inner-blocks/checkout-terms-block/block.json +++ b/assets/js/blocks/checkout/inner-blocks/checkout-terms-block/block.json @@ -2,7 +2,7 @@ "name": "woocommerce/checkout-terms-block", "version": "1.0.0", "title": "Terms and Conditions", - "description": "Ensure customers agree to your terms and conditions and privacy policy.", + "description": "Ensure that customers agree to your Terms & Conditions and Privacy Policy.", "category": "woocommerce", "supports": { "align": false, diff --git a/assets/js/blocks/checkout/inner-blocks/checkout-terms-block/edit.tsx b/assets/js/blocks/checkout/inner-blocks/checkout-terms-block/edit.tsx index d7752894cf9..005d5ee36e9 100644 --- a/assets/js/blocks/checkout/inner-blocks/checkout-terms-block/edit.tsx +++ b/assets/js/blocks/checkout/inner-blocks/checkout-terms-block/edit.tsx @@ -134,7 +134,7 @@ export const Edit = ( { >

{ __( - "You don't seem to have a Terms and Conditions and/or a Privacy Policy pages setup.", + "You don't have any Terms and Conditions and/or Privacy Policy pages set up.", 'woo-gutenberg-products-block' ) }

diff --git a/assets/js/blocks/checkout/inner-blocks/checkout-terms-block/test/edit.js b/assets/js/blocks/checkout/inner-blocks/checkout-terms-block/test/edit.js index 1523f7003cb..481ec50a6cf 100644 --- a/assets/js/blocks/checkout/inner-blocks/checkout-terms-block/test/edit.js +++ b/assets/js/blocks/checkout/inner-blocks/checkout-terms-block/test/edit.js @@ -59,7 +59,7 @@ describe( 'Edit', () => { expect( queryByText( container, - "You don't seem to have a Terms and Conditions and/or a Privacy Policy pages setup." + "You don't have any Terms and Conditions and/or Privacy Policy pages set up." ) ).toBeInTheDocument(); } ); diff --git a/assets/js/blocks/classic-template/index.tsx b/assets/js/blocks/classic-template/index.tsx index 18bf8237ed2..a6df1fecc3d 100644 --- a/assets/js/blocks/classic-template/index.tsx +++ b/assets/js/blocks/classic-template/index.tsx @@ -71,12 +71,12 @@ const Edit = ( {

{ __( - 'Attention: Do not remove this block!', + 'Do not remove this block!', 'woo-gutenberg-products-block' ) } { ' ' } { __( - 'Removal will cause unintended effects on your store.', + 'Removing this will cause unintended effects on your store.', 'woo-gutenberg-products-block' ) }

@@ -84,7 +84,7 @@ const Edit = ( { { sprintf( /* translators: %s is the template title */ __( - 'This is an editor placeholder for the %s. On your store this will be replaced by the template and display with your product image(s), title, price, etc. You can move this placeholder around and add further blocks around it to extend the template.', + 'This is a placeholder for the %s. In your store it will display the actual product image, title, price, etc. You can move this placeholder around and add more blocks around it to customize the template.', 'woo-gutenberg-products-block' ), templateTitle diff --git a/assets/js/blocks/featured-items/featured-product/block.json b/assets/js/blocks/featured-items/featured-product/block.json index 515de7a4878..cde0cdac48f 100644 --- a/assets/js/blocks/featured-items/featured-product/block.json +++ b/assets/js/blocks/featured-items/featured-product/block.json @@ -2,16 +2,11 @@ "name": "woocommerce/featured-product", "version": "1.0.0", "title": "Featured Product", - "description": "Visually highlight a product or variation and encourage prompt action.", + "description": "Highlight a product or variation.", "category": "woocommerce", - "keywords": [ - "WooCommerce" - ], + "keywords": [ "WooCommerce" ], "supports": { - "align": [ - "wide", - "full" - ], + "align": [ "wide", "full" ], "html": false, "color": { "background": true, diff --git a/assets/js/blocks/featured-items/featured-product/block.tsx b/assets/js/blocks/featured-items/featured-product/block.tsx index 29d9f80a2b0..7978c8456db 100644 --- a/assets/js/blocks/featured-items/featured-product/block.tsx +++ b/assets/js/blocks/featured-items/featured-product/block.tsx @@ -41,7 +41,7 @@ const CONTENT_CONFIG = { const EDIT_MODE_CONFIG = { ...GENERIC_CONFIG, description: __( - 'Visually highlight a product or variation and encourage prompt action', + 'Highlight a product or variation.', 'woo-gutenberg-products-block' ), editLabel: __( diff --git a/assets/js/blocks/featured-items/inspector-controls.tsx b/assets/js/blocks/featured-items/inspector-controls.tsx index 0daaaf72c0f..51663867f3d 100644 --- a/assets/js/blocks/featured-items/inspector-controls.tsx +++ b/assets/js/blocks/featured-items/inspector-controls.tsx @@ -162,13 +162,13 @@ export const InspectorControls = ( { } } > { __( - 'Choose “Cover” if you want the image to scale automatically to always fit its container.', + 'Select “Cover” to have the image automatically fit its container.', 'woo-gutenberg-products-block' ) } { __( - 'Note: by choosing “Cover” you will lose the ability to freely move the focal point precisely.', + 'This may affect your ability to freely move the focal point of the image.', 'woo-gutenberg-products-block' ) } diff --git a/assets/js/blocks/handpicked-products/edit-mode.tsx b/assets/js/blocks/handpicked-products/edit-mode.tsx index 111fe4e76ca..3a36e0708f8 100644 --- a/assets/js/blocks/handpicked-products/edit-mode.tsx +++ b/assets/js/blocks/handpicked-products/edit-mode.tsx @@ -30,7 +30,7 @@ export const HandpickedProductsEditMode = ( setIsEditing( ! isEditing ); debouncedSpeak( __( - 'Showing Hand-picked Products block preview.', + 'Now displaying a preview of the Hand-picked Products block.', 'woo-gutenberg-products-block' ) ); diff --git a/assets/js/blocks/mini-cart/edit.tsx b/assets/js/blocks/mini-cart/edit.tsx index d37968ae719..b8b51e42b21 100644 --- a/assets/js/blocks/mini-cart/edit.tsx +++ b/assets/js/blocks/mini-cart/edit.tsx @@ -111,7 +111,7 @@ const Edit = ( { attributes, setAttributes }: Props ): ReactElement => { >

{ __( - 'Edit the appearance of your empty and filled mini cart contents.', + 'Edit the appearance of the Mini Cart.', 'woo-gutenberg-products-block' ) }

diff --git a/assets/js/blocks/mini-cart/mini-cart-contents/inner-blocks/empty-mini-cart-contents-block/block.json b/assets/js/blocks/mini-cart/mini-cart-contents/inner-blocks/empty-mini-cart-contents-block/block.json index b8017ef7c29..7b32de681db 100644 --- a/assets/js/blocks/mini-cart/mini-cart-contents/inner-blocks/empty-mini-cart-contents-block/block.json +++ b/assets/js/blocks/mini-cart/mini-cart-contents/inner-blocks/empty-mini-cart-contents-block/block.json @@ -1,8 +1,8 @@ { "name": "woocommerce/empty-mini-cart-contents-block", "version": "1.0.0", - "title": "Empty Mini Cart Contents", - "description": "Contains blocks that are displayed when the mini cart is empty.", + "title": "Empty Mini Cart view.", + "description": "Blocks that are displayed when the Mini Cart is empty.", "category": "woocommerce", "supports": { "align": false, diff --git a/assets/js/blocks/mini-cart/mini-cart-contents/inner-blocks/filled-mini-cart-contents-block/block.json b/assets/js/blocks/mini-cart/mini-cart-contents/inner-blocks/filled-mini-cart-contents-block/block.json index 2f529ee2052..f40d4d3004c 100644 --- a/assets/js/blocks/mini-cart/mini-cart-contents/inner-blocks/filled-mini-cart-contents-block/block.json +++ b/assets/js/blocks/mini-cart/mini-cart-contents/inner-blocks/filled-mini-cart-contents-block/block.json @@ -1,8 +1,8 @@ { "name": "woocommerce/filled-mini-cart-contents-block", "version": "1.0.0", - "title": "Filled Mini Cart Contents", - "description": "Contains blocks that are displayed when the mini cart has products.", + "title": "Filled Mini Cart view", + "description": "Contains blocks that display the content of the Mini Cart.", "category": "woocommerce", "supports": { "align": false, diff --git a/assets/js/blocks/mini-cart/mini-cart-contents/inner-blocks/mini-cart-shopping-button-block/block.json b/assets/js/blocks/mini-cart/mini-cart-contents/inner-blocks/mini-cart-shopping-button-block/block.json index 397a99d9515..c81b1c38c2d 100644 --- a/assets/js/blocks/mini-cart/mini-cart-contents/inner-blocks/mini-cart-shopping-button-block/block.json +++ b/assets/js/blocks/mini-cart/mini-cart-contents/inner-blocks/mini-cart-shopping-button-block/block.json @@ -2,7 +2,7 @@ "name": "woocommerce/mini-cart-shopping-button-block", "version": "1.0.0", "title": "Mini Cart Shopping Button", - "description": "Block that displays the shopping button for the Mini Cart block.", + "description": "Block that displays the shopping button when the Mini Cart is empty.", "category": "woocommerce", "supports": { "align": false, diff --git a/assets/js/blocks/price-filter/block.json b/assets/js/blocks/price-filter/block.json index 2bfd91e8580..8142a609a42 100644 --- a/assets/js/blocks/price-filter/block.json +++ b/assets/js/blocks/price-filter/block.json @@ -2,7 +2,7 @@ "name": "woocommerce/price-filter", "version": "1.0.0", "title": "Filter by Price", - "description": "Allow customers to filter products by price range.", + "description": "Enable customers to filter the product grid by choosing a price range.", "category": "woocommerce", "keywords": [ "WooCommerce" ], "supports": { diff --git a/assets/js/blocks/price-filter/edit.tsx b/assets/js/blocks/price-filter/edit.tsx index 4e2fbbb7187..fca50c6d97a 100644 --- a/assets/js/blocks/price-filter/edit.tsx +++ b/assets/js/blocks/price-filter/edit.tsx @@ -102,7 +102,7 @@ export default function ( { help={ showFilterButton ? __( - 'Products will only update when the button is pressed.', + 'Products will only update when the button is clicked.', 'woo-gutenberg-products-block' ) : __( @@ -149,7 +149,7 @@ export default function ( { >

{ __( - "Products with prices are needed for filtering by price. You haven't created any products yet.", + 'To filter your products by price you first need to assign prices to your products.', 'woo-gutenberg-products-block' ) }

diff --git a/assets/js/blocks/product-categories/block.js b/assets/js/blocks/product-categories/block.js index 854d1565734..fdcc604d73d 100644 --- a/assets/js/blocks/product-categories/block.js +++ b/assets/js/blocks/product-categories/block.js @@ -27,7 +27,7 @@ const EmptyPlaceholder = () => ( className="wc-block-product-categories" > { __( - "This block shows product categories for your store. To use it, you'll first need to create a product and assign it to a category.", + 'This block displays the product categories for your store. To use it you first need to create a product and assign it to a category.', 'woo-gutenberg-products-block' ) } @@ -92,17 +92,6 @@ const ProductCategoriesBlock = ( { attributes, setAttributes, name } ) => { 'Show product count', 'woo-gutenberg-products-block' ) } - help={ - hasCount - ? __( - 'Product count is visible.', - 'woo-gutenberg-products-block' - ) - : __( - 'Product count is hidden.', - 'woo-gutenberg-products-block' - ) - } checked={ hasCount } onChange={ () => setAttributes( { hasCount: ! hasCount } ) @@ -136,17 +125,6 @@ const ProductCategoriesBlock = ( { attributes, setAttributes, name } ) => { 'Show hierarchy', 'woo-gutenberg-products-block' ) } - help={ - isHierarchical - ? __( - 'Hierarchy is visible.', - 'woo-gutenberg-products-block' - ) - : __( - 'Hierarchy is hidden.', - 'woo-gutenberg-products-block' - ) - } checked={ isHierarchical } onChange={ () => setAttributes( { @@ -159,17 +137,6 @@ const ProductCategoriesBlock = ( { attributes, setAttributes, name } ) => { 'Show empty categories', 'woo-gutenberg-products-block' ) } - help={ - hasEmpty - ? __( - 'Empty categories are visible.', - 'woo-gutenberg-products-block' - ) - : __( - 'Empty categories are hidden.', - 'woo-gutenberg-products-block' - ) - } checked={ hasEmpty } onChange={ () => setAttributes( { hasEmpty: ! hasEmpty } ) diff --git a/assets/js/blocks/product-category/edit-mode.tsx b/assets/js/blocks/product-category/edit-mode.tsx index e2de7e09069..fa2cef2976b 100644 --- a/assets/js/blocks/product-category/edit-mode.tsx +++ b/assets/js/blocks/product-category/edit-mode.tsx @@ -47,7 +47,7 @@ export const ProductsByCategoryEditMode = ( save(); debouncedSpeak( __( - 'Showing Products by Category block preview.', + 'Now displaying a preview of the reviews for the products in the selected categories.', 'woo-gutenberg-products-block' ) ); @@ -57,7 +57,7 @@ export const ProductsByCategoryEditMode = ( stopEditing(); debouncedSpeak( __( - 'Showing Products by Category block preview.', + 'Now displaying a preview of the reviews for the products in the selected categories.', 'woo-gutenberg-products-block' ) ); diff --git a/assets/js/blocks/product-search/edit.js b/assets/js/blocks/product-search/edit.js index 8d22a426305..c881d261b50 100644 --- a/assets/js/blocks/product-search/edit.js +++ b/assets/js/blocks/product-search/edit.js @@ -60,17 +60,6 @@ const Edit = ( { 'Show search field label', 'woo-gutenberg-products-block' ) } - help={ - hasLabel - ? __( - 'Label is visible.', - 'woo-gutenberg-products-block' - ) - : __( - 'Label is hidden.', - 'woo-gutenberg-products-block' - ) - } checked={ hasLabel } onChange={ () => setAttributes( { hasLabel: ! hasLabel } ) diff --git a/assets/js/blocks/product-tag/block.js b/assets/js/blocks/product-tag/block.js index 5c869dc565e..3c19c41fb2d 100644 --- a/assets/js/blocks/product-tag/block.js +++ b/assets/js/blocks/product-tag/block.js @@ -311,7 +311,7 @@ class ProductsByTagBlock extends Component { className="wc-block-products-grid wc-block-product-tag" > { __( - "This block displays products from selected tags. In order to preview this you'll first need to create a product and assign it some tags.", + 'This block displays products from selected tags. To use it you first need to create products and assign tags to them.', 'woo-gutenberg-products-block' ) } diff --git a/assets/js/blocks/products/all-products/edit.js b/assets/js/blocks/products/all-products/edit.js index ae026929492..e7ba049b5e5 100644 --- a/assets/js/blocks/products/all-products/edit.js +++ b/assets/js/blocks/products/all-products/edit.js @@ -149,7 +149,7 @@ class Editor extends Component { { icon: 'edit', title: __( - 'Edit inner product layout', + 'Edit the layout of each product', 'woo-gutenberg-products-block' ), onClick: () => this.togglePreview(), @@ -208,7 +208,7 @@ class Editor extends Component {
{ __( - 'Edit the blocks inside the preview below to change the content displayed for each product within the product grid.', + 'Edit the blocks inside the example below to change the content displayed for all products within the product grid.', 'woo-gutenberg-products-block' ) } diff --git a/assets/js/blocks/reviews/reviews-by-category/edit.js b/assets/js/blocks/reviews/reviews-by-category/edit.js index 3169484914d..29d5b12414d 100644 --- a/assets/js/blocks/reviews/reviews-by-category/edit.js +++ b/assets/js/blocks/reviews/reviews-by-category/edit.js @@ -94,7 +94,7 @@ const ReviewsByCategoryEditor = ( { setAttributes( { editMode: false } ); debouncedSpeak( __( - 'Showing Reviews by Category block preview.', + 'Now displaying a preview of the reviews for the products in the selected categories.', 'woo-gutenberg-products-block' ) ); diff --git a/assets/js/blocks/reviews/reviews-by-product/index.js b/assets/js/blocks/reviews/reviews-by-product/index.js index 32b3531ffe9..ff6d152d41b 100644 --- a/assets/js/blocks/reviews/reviews-by-product/index.js +++ b/assets/js/blocks/reviews/reviews-by-product/index.js @@ -30,7 +30,7 @@ registerBlockType( 'woocommerce/reviews-by-product', { category: 'woocommerce', keywords: [ __( 'WooCommerce', 'woo-gutenberg-products-block' ) ], description: __( - 'Show reviews of your products to build trust.', + 'Display reviews for your products.', 'woo-gutenberg-products-block' ), supports: { diff --git a/assets/js/blocks/stock-filter/edit.tsx b/assets/js/blocks/stock-filter/edit.tsx index d3f079471b1..7d7d9103b57 100644 --- a/assets/js/blocks/stock-filter/edit.tsx +++ b/assets/js/blocks/stock-filter/edit.tsx @@ -40,20 +40,9 @@ const Edit = ( { > setAttributes( { @@ -73,11 +62,11 @@ const Edit = ( { help={ showFilterButton ? __( - 'Products will only update when the button is pressed.', + 'Products will only update when the button is clicked.', 'woo-gutenberg-products-block' ) : __( - 'Products will update as options are selected.', + 'Products will update as soon as attributes are selected.', 'woo-gutenberg-products-block' ) } diff --git a/assets/js/blocks/stock-filter/index.tsx b/assets/js/blocks/stock-filter/index.tsx index 9bb0b96af94..80477ae79b6 100644 --- a/assets/js/blocks/stock-filter/index.tsx +++ b/assets/js/blocks/stock-filter/index.tsx @@ -18,7 +18,7 @@ import type { Attributes } from './types'; registerBlockType( metadata, { title: __( 'Filter Products by Stock', 'woo-gutenberg-products-block' ), description: __( - 'Allow customers to filter the grid by products stock status. Works in combination with the All Products block.', + 'Enable customers to filter the product grid by stock status.', 'woo-gutenberg-products-block' ), icon: { diff --git a/assets/js/editor-components/error-placeholder/error-message.tsx b/assets/js/editor-components/error-placeholder/error-message.tsx index 2f0c113a183..7f7d111e587 100644 --- a/assets/js/editor-components/error-placeholder/error-message.tsx +++ b/assets/js/editor-components/error-placeholder/error-message.tsx @@ -19,7 +19,7 @@ export interface ErrorMessageProps { const getErrorMessage = ( { message, type }: ErrorObject ) => { if ( ! message ) { return __( - 'An unknown error occurred which prevented the block from being updated.', + 'An error has prevented the block from being updated.', 'woo-gutenberg-products-block' ); } diff --git a/assets/js/editor-components/grid-content-control/index.js b/assets/js/editor-components/grid-content-control/index.js index 9f7d83e4e66..ab90b83e64d 100644 --- a/assets/js/editor-components/grid-content-control/index.js +++ b/assets/js/editor-components/grid-content-control/index.js @@ -21,17 +21,6 @@ const GridContentControl = ( { onChange, settings } ) => { <> onChange( { ...settings, image: ! imageIsVisible } ) @@ -39,49 +28,16 @@ const GridContentControl = ( { onChange, settings } ) => { /> onChange( { ...settings, title: ! title } ) } /> onChange( { ...settings, price: ! price } ) } /> onChange( { ...settings, rating: ! rating } ) } /> @@ -90,17 +46,6 @@ const GridContentControl = ( { onChange, settings } ) => { 'Add to Cart button', 'woo-gutenberg-products-block' ) } - help={ - button - ? __( - 'Add to Cart button is visible.', - 'woo-gutenberg-products-block' - ) - : __( - 'Add to Cart button is hidden.', - 'woo-gutenberg-products-block' - ) - } checked={ button } onChange={ () => onChange( { ...settings, button: ! button } ) } /> diff --git a/assets/js/editor-components/grid-layout-control/index.js b/assets/js/editor-components/grid-layout-control/index.js index ff269f75ccb..87c6820d37f 100644 --- a/assets/js/editor-components/grid-layout-control/index.js +++ b/assets/js/editor-components/grid-layout-control/index.js @@ -57,13 +57,13 @@ const GridLayoutControl = ( { />