Add Bootstrap 5 product archive with card grid and sidebar

Replace WooCommerce's default shop/category page rendering with a
Bootstrap 5 card grid layout featuring responsive columns, sale badges,
star ratings, and an offcanvas sidebar for filters on mobile.

Key implementation details:

- Bypass parent theme's TemplateController for product archives via
  wp_bootstrap_should_render_template filter, render at template_redirect
  priority 11 using the same page shell injection pattern as plugin pages

- Add archive-product.php (Bootstrap layout with optional sidebar) and
  content-product.php (PHP bridge for wc_get_template_part interception)

- Inject global $product into Twig context in TemplateOverride to fix
  empty price/add-to-cart/rating/sale-flash in loop sub-templates — Twig
  has isolated variable scopes and cannot access PHP globals directly

- Fix pagination URLs: use get_pagenum_link() instead of ?page= query
  param (WordPress uses 'paged' for archive pagination, not 'page')

- Fix double-escaped – in result count by adding |raw filter

- Reset WooCommerce float-based layout CSS (woocommerce-layout.css) for
  shop pages to prevent conflicts with Bootstrap flex grid

- Register shop-sidebar widget area with Bootstrap-styled markup

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-02-28 15:06:33 +01:00
parent 7034134678
commit 00872a6568
9 changed files with 416 additions and 23 deletions

View File

@@ -2,17 +2,17 @@
# Product Content in Loop (Bootstrap 5 Override)
#
# Renders a single product card within the shop loop grid.
# Uses Bootstrap 5 card component with stretched-link.
# Uses Bootstrap 5 card component with WooCommerce hook output.
#
# Expected context:
# product - WC_Product object with:
# .name - Product name
# .permalink - Product URL
# .image - Product thumbnail HTML
# .price_html - Formatted price HTML
# .rating_html - Star rating HTML
# .is_on_sale - Whether product is on sale
# .add_to_cart - Add-to-cart button context
# Rendered via the content-product.php bridge file (not TemplateOverride)
# because wc_get_template_part() does not fire the template_part hooks.
#
# Hook output structure:
# woocommerce_before_shop_loop_item → <a> link open
# woocommerce_before_shop_loop_item_title → sale badge, product image
# woocommerce_shop_loop_item_title → <h2> product title
# woocommerce_after_shop_loop_item_title → star rating, price
# woocommerce_after_shop_loop_item → </a> link close, add-to-cart button
#
# WooCommerce PHP equivalent: content-product.php
#