Skip to main content

WooCommerce

Integrates WooCommerce with the Unyson+ framework. It makes any active theme WooCommerce-aware, adds shop page-builder elements, and centralises the catalog layout in one settings page. The extension is completely inert until WooCommerce is installed and active — enabling it on a site without WooCommerce changes nothing.

Activation

Install and activate WooCommerce, then enable WooCommerce under Unyson → Extensions. That's it — no configuration is required to get a working shop; the defaults below apply until you change them.

What it does

Theme-aware, with a universal fallback

  • With a WooCommerce-aware theme (e.g. the UnysonPlus Theme, which ships its own shop wrappers, sidebar handling and styles), the extension steps aside and feeds its settings into the theme's unysonplus_woocommerce_* filters.
  • With any other theme, the extension declares WooCommerce support itself (including the product-gallery zoom / lightbox / slider), ships a small baseline stylesheet, and drives WooCommerce's own layout filters — so the shop looks reasonable out of the box anywhere.

Page-builder elements

While WooCommerce is active, a dedicated WooCommerce Elements tab appears in the page builder with all of the elements below. See the full reference at WooCommerce Elements.

The Products grid also supports percentage / Featured / New / Out-of-stock badges, low-stock notices, a Quick View modal, and Load More (AJAX) pagination.

Settings

Unyson → Settings → WooCommerce. These control the shop / category archive and single product pages site-wide:

SettingDefaultControls
Products per Row3Columns in the shop / category product grid
Products per Page12Products shown before pagination
Shop SidebarNoneSidebar position on WooCommerce pages (with a WooCommerce-aware theme)
Gallery Thumbnail Columns4Thumbnails below the main product image
Related Products3Related products on a single product page (0 hides them)

Shop Behavior

SettingDefaultControls
Catalog ModeOffHide prices + add-to-cart store-wide (lookbook mode)
Sale Badge StyleTextNative sale flash as “Sale” or a percentage (“-25%”)
AJAX Add to CartOnAdd simple products from shop archives without a reload
Shop BreadcrumbOnShow the WooCommerce breadcrumb above shop / product content
Gallery Zoom / Lightbox / SliderOnToggle each product-gallery feature

For developers — the filter contract

A WooCommerce-aware theme exposes these filters; the extension's settings feed them, and a theme can also override them directly. (Under a non-aware theme the extension applies the same values through WooCommerce's own filters — loop_shop_columns, loop_shop_per_page, woocommerce_product_thumbnails_columns, woocommerce_output_related_products_args.)

FilterDefaultPurpose
unysonplus_woocommerce_loop_columns3Shop grid columns
unysonplus_woocommerce_products_per_page12Products per page
unysonplus_woocommerce_sidebarnoneShop sidebar (none | left | right)
unysonplus_woocommerce_thumbnail_columns4Gallery thumbnail columns
unysonplus_woocommerce_related_count3Related-products count
// Example: force a 4-column shop grid regardless of the saved setting.
add_filter( 'unysonplus_woocommerce_loop_columns', function () {
return 4;
} );
Cart & Checkout: blocks vs. classic

WooCommerce 9+ ships block-based Cart and Checkout pages by default; those blocks carry their own styling and render cleanly inside the theme. The UnysonPlus Theme also polishes the classic shortcode Cart / Checkout ([woocommerce_cart] / [woocommerce_checkout]) and single-product pages — switch those pages to the classic shortcodes if you want full theme control over their markup.