Skip to content

WooCommerce Integration

Alex de Borba edited this page Jun 21, 2026 · 1 revision

WooCommerce Integration

Aegis provides deep integration with WooCommerce, including dedicated templates, block patterns, and a multi-step checkout experience. The theme is designed to work with WooCommerce out of the box without additional configuration.

Requirements

  • WooCommerce 8.0 or later.
  • WordPress 7.0 or later.
  • WooCommerce block-based templates enabled (default in current versions).

WooCommerce Templates

Aegis includes 11 dedicated WooCommerce templates that replace the default WooCommerce page layouts:

Template Filename Purpose
Product Archive archive-product.html The main shop page showing all products.
Single Product single-product.html Individual product detail pages.
Product Search Results product-search-results.html Results from product-specific searches.
Product Category taxonomy-product_cat.html Products filtered by category.
Product Tag taxonomy-product_tag.html Products filtered by tag.
Cart page-cart.html Shopping cart page.
Checkout page-checkout.html Standard single-page checkout.
Multi-Step Checkout page-checkout-multi-step.html Enhanced multi-step checkout flow.
Order Confirmation order-confirmation.html Thank-you page after purchase.
My Account page-my-account.html Customer account dashboard.
Wishlist page-wishlist.html Customer product wishlist.

Multi-Step Checkout

The multi-step checkout template splits the checkout process into distinct, manageable steps that reduce cognitive load and improve completion rates.

Steps

  1. Shipping — Customer enters shipping address and selects a shipping method.
  2. Payment — Customer provides payment details and billing information.
  3. Review — Customer reviews the complete order before confirming.

Enabling Multi-Step Checkout

  1. Open the Site Editor (Appearance → Editor).
  2. Navigate to Templates.
  3. Locate the Multi-Step Checkout template.
  4. Ensure it is assigned to your checkout page (or create a new page and assign the template).

Alternatively, edit your checkout page and select the Multi-Step Checkout template from the page template selector.

Multi-Step Checkout Features

  • Visual progress indicator showing current step.
  • Form validation at each step before advancing.
  • Back navigation to previous steps without data loss.
  • Order summary sidebar visible throughout.
  • Responsive layout — steps stack vertically on mobile.
  • Accessible step navigation with ARIA landmarks.

Product Archive (Shop Page)

The product archive template includes:

  • Configurable product grid (2, 3, or 4 columns).
  • Product filtering by category and attributes.
  • Sorting options (price, popularity, date, rating).
  • Pagination or load-more button.
  • Sidebar for product filters (optional).

Customizing the Shop Layout

  1. Open the Site Editor.
  2. Navigate to Templates → Product Archive.
  3. Edit the product grid layout, filters, and sorting blocks.
  4. Save your changes.

Single Product Page

The single product template provides a complete product detail experience:

  • Product image gallery with zoom.
  • Product title, price, and description.
  • Add-to-cart button with quantity selector.
  • Product meta (SKU, categories, tags).
  • Product tabs (description, additional information, reviews).
  • Related products section.
  • Upsell products section.

WooCommerce Block Patterns

Aegis includes product-focused patterns in the Commerce and Product categories:

Pattern Type Description
Product grids Showcase featured products in various layouts.
Product hero Large featured product with CTA.
Sale banners Promotional banners for discounts.
Category navigation Visual category browsing grids.
Trust signals Shipping info, return policy, guarantee badges.
Cart cross-sell Recommended products for cart page.

WooCommerce Styling

All WooCommerce elements are styled to match the active style variation:

  • Buttons — Add-to-cart and checkout buttons use the primary color.
  • Forms — Input fields, selects, and labels use theme typography and spacing.
  • Notifications — Success, error, and info messages use the status color tokens.
  • Badges — Sale badges, out-of-stock indicators follow the design system.
  • Tables — Cart and order tables use the theme table styling.

Price Display

Prices are styled with:

  • Regular price in standard body text.
  • Sale price emphasized with the Error (red) color token.
  • Original price shown with strikethrough.

WooCommerce and Dark Mode

WooCommerce templates and elements fully support dark mode:

  • Product cards adapt backgrounds and borders.
  • Form inputs switch to dark-appropriate styling.
  • Notification colors adjust for dark backgrounds.
  • Images maintain their appearance while surrounding UI adapts.

See dark-mode for dark mode configuration.

Performance

WooCommerce pages use the same conditional asset loading as the rest of Aegis:

  • WooCommerce-specific styles load only on WooCommerce pages.
  • Cart and checkout scripts load only when needed.
  • Product images use lazy loading.
  • The facade pattern applies to product videos.

See performance for the full performance strategy.

Customization Tips

Customizing the Cart Page

  1. Edit the Cart template in the Site Editor.
  2. Add cross-sell patterns above or below the cart block.
  3. Include trust signal patterns (shipping info, guarantees).

Customizing the Checkout Page

  1. Edit the Checkout or Multi-Step Checkout template.
  2. Add a progress bar if not already present.
  3. Include trust badges near the payment form.

Adding a Mini Cart

Include the WooCommerce Mini Cart block in your header template part:

  1. Edit the Header template part.
  2. Insert the Mini Cart block.
  3. Position it near the navigation.
  4. Save.

Troubleshooting

WooCommerce Templates Not Appearing

  • Ensure WooCommerce is activated.
  • Clear any page caches.
  • Check that WooCommerce block templates are enabled (not legacy PHP templates).

Checkout Not Working

  • Verify that WooCommerce pages (Cart, Checkout, My Account) are assigned in WooCommerce → Settings → Advanced.
  • Ensure the correct template is assigned to each page.

Next Steps

Clone this wiki locally