classic-woocommerce-shop-loop

Classic WooCommerce Shop Loop

Use this when building or reviewing shop archives, product category/tag/attribute archives, product grids, related product grids, and product cards in a classic WooCommerce theme.

When to Use This Skill

• Editing woocommerce/archive-product.php.
• Editing woocommerce/content-product.php.
• Changing product card markup, image size, title, price, rating, sale badge, or add-to-cart output.
• Adjusting result count, ordering, pagination, no-products state, rows, or columns.
• Reviewing custom product loops in templates.

Archive Skeleton

Keep Woo's archive loop contract.

do_action( 'woocommerce_before_main_content' );
do_action( 'woocommerce_shop_loop_header' );

if ( woocommerce_product_loop() ) {
	do_action( 'woocommerce_before_shop_loop' );

	woocommerce_product_loop_start();

	if ( wc_get_loop_prop( 'total' ) ) {
		while ( have_posts() ) {
			the_post();
			do_action( 'woocommerce_shop_loop' );
			wc_get_template_part( 'content', 'product' );
		}
	}

	woocommerce_product_loop_end();

	do_action( 'woocommerce_after_shop_loop' );
} else {
	do_action( 'woocommerce_no_products_found' );
}

do_action( 'woocommerce_after_main_content' );

Rules:

• Use woocommerce_product_loop() instead of only checking have_posts().
• Use woocommerce_product_loop_start() and woocommerce_product_loop_end() so loop wrappers and subcategories work.
• Use wc_get_loop_prop( 'total' ) before rendering products.
• Preserve woocommerce_before_shop_loop, woocommerce_after_shop_loop, and woocommerce_no_products_found.
• Do not build shop archives with a raw WP_Query unless this is a deliberate secondary product section.

Product Card Contract

content-product.php must preserve the product object guard and visibility check.

global $product;

if ( ! is_a( $product, WC_Product::class ) || ! $product->is_visible() ) {
	return;
}
?>
<li <?php wc_product_class( '', $product ); ?>>
	<?php
	do_action( 'woocommerce_before_shop_loop_item' );
	do_action( 'woocommerce_before_shop_loop_item_title' );
	do_action( 'woocommerce_shop_loop_item_title' );
	do_action( 'woocommerce_after_shop_loop_item_title' );
	do_action( 'woocommerce_after_shop_loop_item' );
	?>
</li>