Skip to main content

WooCommerce Customisations

The Suma Elementor theme extends WooCommerce significantly to support the dealer-specific purchase workflow.

Custom Order Statuses​

Four additional order statuses are registered (see Theme Modules for details):

  • wc-pending-approval
  • wc-pending-ach
  • wc-shipped-not-paid
  • wc-partially-paid

These statuses appear in the WooCommerce admin order list, in status-based email triggers, and on the dealer's My Account order page.

Cart Customisations​

The WooCommerce\Cart module modifies cart behaviour for wholesale dealers:

  • Enforces minimum order quantities per product (set via product meta)
  • Optionally applies per-customer flat shipping rates
  • Handles cart limits by day of week (e.g., prevent orders above a threshold on Fridays for wire-transfer orders)

Checkout​

  • Hides irrelevant checkout fields for B2B accounts
  • Adds company-specific fields (PO number, account manager reference)
  • Integrates with the iTransact payment gateway (plugin: woocommerce-itransact-payment-gateway)

Product Display​

The WooCommerce\Product module:

  • Reads live pricing from WooCommerce postmeta (updated by the Middleware pricing sync)
  • Applies per-customer markup overrides from the dealer's pricing catalog
  • Renders volume pricing tiers from _volume_pricing meta
  • Supports multiple pricing modes: each_fixed and weight_percent

My Account Dashboard​

The account dashboard is built with Elementor but uses custom WooCommerce endpoints registered by the theme:

  • Orders — filtered to show only the current user's (and optionally sub-accounts') orders
  • Preferences — custom WooCommerce preference page (/my-account/preferences/)
  • Purchase Stats — rendered via WooCommerce\UserStats above the orders table

Email Customisations​

The WooCommerce\Email module (class-woocommerce-email.php) and inc/emails/ directory customise transactional emails:

  • Custom email templates for dealer-specific order statuses
  • Company name substituted for personal name in email salutations
  • Enhanced order detail formatting to include product metal purity and custom descriptions