Files
wc-bootstrap/assets/css/wc-bootstrap.css
magdev 00872a6568 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>
2026-02-28 15:06:33 +01:00

505 lines
14 KiB
CSS

/**
* WooCommerce Bootstrap - Bootstrap 5 Overrides
*
* Provides Bootstrap 5 styling for any plugin CSS classes
* that may be injected by the plugin's JavaScript or inline markup.
*
* CSS dependency chain (lowest to highest priority):
* 1. wp-bootstrap (parent theme)
* 2. woocommerce (plugin styles)
* 3. wc-bootstrap-style (child theme style.css)
* 4. wc-bootstrap-overrides (this file)
*
* @package WcBootstrap
* @since 0.1.0
*/
/* ==========================================================================
Button Overrides
Map plugin button classes to Bootstrap button styles.
========================================================================== */
/* Example: Map plugin .my-button to Bootstrap styling
.my-button {
display: inline-block;
font-weight: 400;
line-height: 1.5;
text-align: center;
text-decoration: none;
vertical-align: middle;
cursor: pointer;
border: 1px solid transparent;
padding: 0.375rem 0.75rem;
font-size: 1rem;
border-radius: var(--bs-border-radius);
transition: color 0.15s ease-in-out, background-color 0.15s ease-in-out, border-color 0.15s ease-in-out;
}
*/
/* ==========================================================================
WooCommerce Notice Overrides
Map WooCommerce notice classes to Bootstrap alert styles as fallback
when notices are rendered outside our Twig templates.
========================================================================== */
.woocommerce-info,
.woocommerce-message,
.woocommerce-error {
position: relative;
padding: 1rem 3rem 1rem 1rem;
margin-bottom: 1rem;
border: 1px solid transparent;
border-radius: var(--bs-border-radius);
}
.woocommerce-info {
color: var(--bs-info-text-emphasis);
background-color: var(--bs-info-bg-subtle);
border-color: var(--bs-info-border-subtle);
}
.woocommerce-message {
color: var(--bs-success-text-emphasis);
background-color: var(--bs-success-bg-subtle);
border-color: var(--bs-success-border-subtle);
}
.woocommerce-error {
color: var(--bs-danger-text-emphasis);
background-color: var(--bs-danger-bg-subtle);
border-color: var(--bs-danger-border-subtle);
list-style: none;
padding-left: 1rem;
}
/* ==========================================================================
Quantity Input
Sizing for the Bootstrap input-group quantity widget.
========================================================================== */
.quantity.input-group .form-control {
/* Remove number input spinners (browser default) */
-moz-appearance: textfield;
}
.quantity.input-group .form-control::-webkit-outer-spin-button,
.quantity.input-group .form-control::-webkit-inner-spin-button {
-webkit-appearance: none;
margin: 0;
}
/* ==========================================================================
Product Cards
Hover effects and layout for product loop cards.
========================================================================== */
.product.card {
transition: transform 0.15s ease, box-shadow 0.15s ease;
}
.product.card:hover {
transform: translateY(-2px);
box-shadow: var(--bs-box-shadow) !important;
}
/* Product image in card */
.product.card img {
object-fit: cover;
aspect-ratio: 1 / 1;
width: 100%;
}
/* Product link wrapping card content — remove underline, inherit text color */
.product.card a.woocommerce-LoopProduct-link {
text-decoration: none;
color: inherit;
}
/* Product title in card body */
.product.card .woocommerce-loop-product__title {
font-size: 1rem;
font-weight: 600;
margin-bottom: 0.5rem;
}
/* Push price to bottom of card body for even card heights */
.product.card .card-body .price {
margin-top: auto;
}
/* Add-to-cart button — Bootstrap btn-outline-primary style */
.product.card .button {
display: inline-block;
width: 100%;
font-weight: 400;
line-height: 1.5;
text-align: center;
text-decoration: none;
vertical-align: middle;
cursor: pointer;
padding: 0.375rem 0.75rem;
font-size: 0.875rem;
border-radius: var(--bs-border-radius);
color: var(--bs-primary);
border: var(--bs-border-width) solid var(--bs-primary);
background-color: transparent;
transition: color 0.15s ease-in-out, background-color 0.15s ease-in-out, border-color 0.15s ease-in-out;
}
.product.card .button:hover {
color: #fff;
background-color: var(--bs-primary);
border-color: var(--bs-primary);
}
/* "View options" button for variable products */
.product.card .button.product_type_variable {
color: var(--bs-secondary);
border-color: var(--bs-secondary);
}
.product.card .button.product_type_variable:hover {
color: #fff;
background-color: var(--bs-secondary);
border-color: var(--bs-secondary);
}
/* "Read more" button for external/non-purchasable products */
.product.card .button.product_type_external {
color: var(--bs-info);
border-color: var(--bs-info);
}
.product.card .button.product_type_external:hover {
color: #fff;
background-color: var(--bs-info);
border-color: var(--bs-info);
}
/* Added-to-cart visual feedback */
.product.card .added_to_cart {
display: inline-block;
width: 100%;
text-align: center;
font-size: 0.875rem;
margin-top: 0.5rem;
color: var(--bs-success);
text-decoration: none;
}
/* WooCommerce result count and ordering bar */
.woocommerce-result-count {
margin-bottom: 0;
line-height: 2.5;
}
.woocommerce-ordering select {
display: inline-block;
padding: 0.375rem 2.25rem 0.375rem 0.75rem;
font-size: 0.875rem;
font-weight: 400;
line-height: 1.5;
color: var(--bs-body-color);
background-color: var(--bs-body-bg);
border: var(--bs-border-width) solid var(--bs-border-color);
border-radius: var(--bs-border-radius);
transition: border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out;
appearance: auto;
}
/* ==========================================================================
Sale Badge
Positioning for the sale overlay badge on product cards.
========================================================================== */
.onsale {
z-index: 1;
}
/* ==========================================================================
Star Rating
Consistent sizing for Bootstrap Icon star ratings.
========================================================================== */
.wc-star-rating .bi {
font-size: 0.875rem;
}
/* ==========================================================================
Price Styling
Override WooCommerce default price markup with Bootstrap-aligned styles.
========================================================================== */
.price del {
text-decoration: line-through;
color: var(--bs-secondary-color);
font-weight: 400;
}
.price ins {
text-decoration: none;
color: var(--bs-danger);
font-weight: 600;
}
/* ==========================================================================
Product Gallery
Thumbnail grid and cursor for single product image gallery.
========================================================================== */
.wc-gallery-thumb {
cursor: pointer;
opacity: 0.7;
transition: opacity 0.15s ease;
}
.wc-gallery-thumb:hover {
opacity: 1;
}
.woocommerce-product-gallery__image img {
width: 100%;
height: auto;
border-radius: var(--bs-border-radius);
}
/* ==========================================================================
Variation Selectors
Spacing for variable product attribute dropdowns.
========================================================================== */
.variations_form .reset_variations {
font-size: 0.875rem;
}
.single_variation_wrap .woocommerce-variation {
margin-bottom: 1rem;
}
/* ==========================================================================
Shop / Archive Layout
Reset WooCommerce's default float grid to let Bootstrap handle layout.
Override woocommerce-layout.css float-based widths and clearfixes.
========================================================================== */
/* Reset float-based result count / ordering bar — use flexbox instead */
.post-type-archive-product .woocommerce-result-count,
.tax-product_cat .woocommerce-result-count,
.tax-product_tag .woocommerce-result-count,
.post-type-archive-product .woocommerce-ordering,
.tax-product_cat .woocommerce-ordering,
.tax-product_tag .woocommerce-ordering {
float: none;
}
/* Reset WooCommerce's product grid floats and widths */
.woocommerce ul.products,
.woocommerce .products {
list-style: none;
padding: 0;
margin: 0;
width: 100%;
clear: both;
}
.woocommerce ul.products li.product,
.woocommerce .products .product {
float: none;
width: auto;
margin: 0;
padding: 0;
}
/* ==========================================================================
Cart Table
Responsive cart item layout and thumbnail sizing.
========================================================================== */
.woocommerce-cart-form .product-thumbnail img {
width: 60px;
height: 60px;
object-fit: cover;
border-radius: var(--bs-border-radius);
}
/* ==========================================================================
Checkout
Sticky order review sidebar and payment method toggle.
========================================================================== */
.payment_box {
transition: all 0.2s ease;
}
.woocommerce-checkout .form-row label {
font-weight: 500;
}
/* Override WooCommerce form fields to use Bootstrap styles */
.woocommerce-checkout .form-row input.input-text,
.woocommerce-checkout .form-row textarea,
.woocommerce-checkout .form-row select {
display: block;
width: 100%;
padding: 0.375rem 0.75rem;
font-size: 1rem;
font-weight: 400;
line-height: 1.5;
color: var(--bs-body-color);
background-color: var(--bs-body-bg);
border: var(--bs-border-width) solid var(--bs-border-color);
border-radius: var(--bs-border-radius);
transition: border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out;
}
.woocommerce-checkout .form-row input.input-text:focus,
.woocommerce-checkout .form-row textarea:focus,
.woocommerce-checkout .form-row select:focus {
border-color: #86b7fe;
outline: 0;
box-shadow: 0 0 0 0.25rem rgba(13, 110, 253, 0.25);
}
/* ==========================================================================
Dark Mode Overrides
Fix any plugin elements that don't adapt to Bootstrap's dark mode.
========================================================================== */
/* Bootstrap 5 dark mode uses data-bs-theme="dark" attribute on <html> */
[data-bs-theme="dark"] {
/* Checkout form focus color for dark mode */
}
[data-bs-theme="dark"] .woocommerce-checkout .form-row input.input-text:focus,
[data-bs-theme="dark"] .woocommerce-checkout .form-row textarea:focus,
[data-bs-theme="dark"] .woocommerce-checkout .form-row select:focus {
border-color: #6ea8fe;
box-shadow: 0 0 0 0.25rem rgba(13, 110, 253, 0.25);
}
/* ==========================================================================
Sticky Header
Shadow effect when header is in stuck position.
========================================================================== */
header.sticky-top.is-stuck {
box-shadow: 0 2px 8px rgba(0, 0, 0, 0.1);
transition: box-shadow 0.2s ease;
}
[data-bs-theme="dark"] header.sticky-top.is-stuck {
box-shadow: 0 2px 8px rgba(0, 0, 0, 0.3);
}
/* ==========================================================================
Block Navigation Fix
Required for dropdown menus inside WordPress block navigation.
========================================================================== */
.wp-block-navigation__container {
overflow: visible !important;
}
/* ==========================================================================
My Account
Navigation and layout for the My Account area.
Reset WooCommerce's float-based layout to let Bootstrap flex grid handle it.
========================================================================== */
.woocommerce-account main .woocommerce,
.woocommerce-cart main .woocommerce,
.woocommerce-checkout main .woocommerce,
.post-type-archive-product main .woocommerce,
.tax-product_cat main .woocommerce,
.tax-product_tag main .woocommerce {
max-width: none;
}
.woocommerce-account .woocommerce-MyAccount-navigation {
float: none;
width: auto;
}
.woocommerce-account .woocommerce-MyAccount-content {
float: none;
width: 100%;
}
.woocommerce-MyAccount-navigation .list-group-item {
white-space: nowrap;
}
.woocommerce-MyAccount-navigation .list-group-item.active {
font-weight: 600;
}
/* Dashboard: avatar rounding */
.woocommerce-MyAccount-content .avatar {
border-radius: 50%;
}
/* Dashboard: quick action card hover lift */
.woocommerce-MyAccount-content a.card {
transition: transform 0.15s ease, box-shadow 0.15s ease;
color: inherit;
}
.woocommerce-MyAccount-content a.card:hover {
transform: translateY(-2px);
box-shadow: var(--bs-box-shadow) !important;
}
/* View-order notes */
.woocommerce-OrderUpdate-description p:last-child {
margin-bottom: 0;
}
/* Address cards */
.woocommerce-Address address {
font-style: normal;
line-height: 1.6;
}
/* My Account forms — apply Bootstrap form-control styles */
.woocommerce-MyAccount-content .form-row input.input-text,
.woocommerce-MyAccount-content .form-row textarea,
.woocommerce-MyAccount-content .form-row select {
display: block;
width: 100%;
padding: 0.375rem 0.75rem;
font-size: 1rem;
font-weight: 400;
line-height: 1.5;
color: var(--bs-body-color);
background-color: var(--bs-body-bg);
border: var(--bs-border-width) solid var(--bs-border-color);
border-radius: var(--bs-border-radius);
transition: border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out;
}
.woocommerce-MyAccount-content .form-row input.input-text:focus,
.woocommerce-MyAccount-content .form-row textarea:focus,
.woocommerce-MyAccount-content .form-row select:focus {
border-color: #86b7fe;
outline: 0;
box-shadow: 0 0 0 0.25rem rgba(13, 110, 253, 0.25);
}
/* ==========================================================================
Order Details
Styling for the order details and tracking pages.
========================================================================== */
.woocommerce-order-details .table tfoot th {
font-weight: 500;
}
.woocommerce-order-details .table tfoot tr:last-child th,
.woocommerce-order-details .table tfoot tr:last-child td {
font-weight: 700;
}
.product-quantity {
white-space: nowrap;
}