Repository navigation
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.
- WooCommerce 8.0 or later.
- WordPress 7.0 or later.
- WooCommerce block-based templates enabled (default in current versions).
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. |
The multi-step checkout template splits the checkout process into distinct, manageable steps that reduce cognitive load and improve completion rates.
- Shipping — Customer enters shipping address and selects a shipping method.
- Payment — Customer provides payment details and billing information.
- Review — Customer reviews the complete order before confirming.
- Open the Site Editor (Appearance → Editor).
- Navigate to Templates.
- Locate the Multi-Step Checkout template.
- 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.
- 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.
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).
- Open the Site Editor.
- Navigate to Templates → Product Archive.
- Edit the product grid layout, filters, and sorting blocks.
- Save your changes.
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.
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. |
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.
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 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.
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.
- Edit the Cart template in the Site Editor.
- Add cross-sell patterns above or below the cart block.
- Include trust signal patterns (shipping info, guarantees).
- Edit the Checkout or Multi-Step Checkout template.
- Add a progress bar if not already present.
- Include trust badges near the payment form.
Include the WooCommerce Mini Cart block in your header template part:
- Edit the Header template part.
- Insert the Mini Cart block.
- Position it near the navigation.
- Save.
- Ensure WooCommerce is activated.
- Clear any page caches.
- Check that WooCommerce block templates are enabled (not legacy PHP templates).
- Verify that WooCommerce pages (Cart, Checkout, My Account) are assigned in WooCommerce → Settings → Advanced.
- Ensure the correct template is assigned to each page.
- templates — See all available templates including WooCommerce.
- plugin-integrations — Other supported plugin integrations.
- performance — Performance optimizations for WooCommerce.
- block-patterns — Browse the Commerce and Product pattern categories.
Aegis version 1.0.0 | GitHub Repository | Report an Issue | Atmostfear Entertainment
License: GPL-2.0-or-later