Commit 2ab3a3380bb for woocommerce
commit 2ab3a3380bbf697a74b2d29aff757e7d3801f72d
Author: Tom Cafferkey <tjcafferkey@gmail.com>
Date: Tue Nov 17 12:33:58 2026 +0000
Preserve product-grid quantity filter compatibility (#71037)
* Preserve product-grid quantity filter compatibility
* Add changelog entry for product-grid quantity compatibility
diff --git a/plugins/woocommerce/changelog/fix-product-grid-quantity-filter-type b/plugins/woocommerce/changelog/fix-product-grid-quantity-filter-type
new file mode 100644
index 00000000000..142cd993505
--- /dev/null
+++ b/plugins/woocommerce/changelog/fix-product-grid-quantity-filter-type
@@ -0,0 +1,4 @@
+Significance: patch
+Type: fix
+
+Preserve compatibility with extensions that expect product-grid button quantities as strings.
diff --git a/plugins/woocommerce/src/Blocks/BlockTypes/AbstractProductGrid.php b/plugins/woocommerce/src/Blocks/BlockTypes/AbstractProductGrid.php
index 09f6a87fec1..07b01f6ca48 100644
--- a/plugins/woocommerce/src/Blocks/BlockTypes/AbstractProductGrid.php
+++ b/plugins/woocommerce/src/Blocks/BlockTypes/AbstractProductGrid.php
@@ -655,7 +655,7 @@ abstract class AbstractProductGrid extends AbstractDynamicBlock {
protected function get_add_to_cart( $product ) {
$attributes = array(
'aria-label' => $product->add_to_cart_description(),
- 'data-quantity' => wc_get_container()->get( ProductUtil::class )->get_catalog_add_to_cart_quantity( $product ),
+ 'data-quantity' => (string) wc_get_container()->get( ProductUtil::class )->get_catalog_add_to_cart_quantity( $product ),
'data-product_id' => $product->get_id(),
'data-product_sku' => $product->get_sku(),
'data-price' => wc_get_price_to_display( $product ),
diff --git a/plugins/woocommerce/tests/php/src/Blocks/BlockTypes/ProductButton.php b/plugins/woocommerce/tests/php/src/Blocks/BlockTypes/ProductButton.php
index 37f75c65a1d..03885a1ed4b 100644
--- a/plugins/woocommerce/tests/php/src/Blocks/BlockTypes/ProductButton.php
+++ b/plugins/woocommerce/tests/php/src/Blocks/BlockTypes/ProductButton.php
@@ -390,6 +390,33 @@ class ProductButton extends \WP_UnitTestCase {
$this->assertStringNotContainsString( 'Add 10 to cart', $markup );
}
+ /**
+ * @testdox Legacy grid attribute filters receive the calculated quantity as a string.
+ * @testWith [1]
+ * [10]
+ * @param int $quantity Minimum purchase quantity.
+ */
+ public function test_legacy_grid_filter_quantity_is_string( int $quantity ): void {
+ $product = WC_Helper_Product::create_simple_product();
+ $minimum = static fn() => $quantity;
+ $filtered_quantity = null;
+ $filter = static function ( $attributes ) use ( &$filtered_quantity ) {
+ $filtered_quantity = $attributes['data-quantity'];
+ return $attributes;
+ };
+ add_filter( 'woocommerce_quantity_input_min', $minimum );
+ add_filter( 'woocommerce_blocks_product_grid_add_to_cart_attributes', $filter );
+ try {
+ $markup = do_blocks( '<!-- wp:woocommerce/handpicked-products {"products":[' . $product->get_id() . ']} /-->' );
+ } finally {
+ remove_filter( 'woocommerce_quantity_input_min', $minimum );
+ remove_filter( 'woocommerce_blocks_product_grid_add_to_cart_attributes', $filter );
+ }
+
+ $this->assertSame( (string) $quantity, $filtered_quantity, 'The public grid attribute filter must receive a string quantity.' );
+ $this->assertStringContainsString( 'data-quantity="' . $quantity . '"', $markup );
+ }
+
/**
* @testdox Legacy grids use their final quantity in both AJAX data and the button label and link.
* @testWith [10]