WC Craft Supply Bundles

A WooCommerce plugin that adds automatic tiered bundle discounts, a CSV product importer for variable products, UK-only shipping enforcement, and a dark storefront theme to craft and art supply stores.

Features

Automatic Tiered Bundle Discounts

Customers are rewarded for buying more. Once a cart reaches a configured quantity threshold, a percentage discount is applied automatically as a WooCommerce cart fee — no coupon codes needed.

Default tiers (configurable from WooCommerce → Settings → Craft Bundles):

Store owners can add, remove, or modify tiers at any time from the admin settings page. The highest qualifying tier always wins.

CSV Product Importer

A dedicated WooCommerce → Import Craft CSV tool lets store managers bulk-import craft and art supply products without writing code.

Each CSV row creates a WooCommerce variable product with three size-based variations:

• Small Pack
• Medium Pack
• Large Pack

Every variation carries its own price, optional stock quantity, and a unique SKU derived from the parent SKU.

Expected CSV columns:

A CSV template containing 15 craft supply products is included in the repository.

UK-Only Shipping

All shipping rates are suppressed automatically for any destination outside the United Kingdom (ISO 3166-1 GB). A server-side checkout guard prevents order submission even if a custom shipping plugin bypasses the rate filter.

Free shipping threshold: when a cart's subtotal meets or exceeds the configured threshold (default £50), flat-rate methods are hidden and only free shipping is offered. The threshold is configurable from the settings page.

Dark Storefront Theme

An optional dark colour scheme built entirely with CSS custom properties. Typography uses DM Sans (headings) and Inter (body) loaded from Google Fonts. All contrast ratios meet WCAG 2.1 AA.

To override brand colours from a child theme without editing plugin files:

:root {
    --wccb-accent:       #e85d4a;   /* swap violet for terracotta */
    --wccb-bg-primary:   #0f1014;
    --wccb-bg-secondary: #1a1c22;
}

The dark theme can be toggled off from WooCommerce → Settings → Craft Bundles → Dark Theme.

Requirements

• WordPress 6.0 or later
• WooCommerce 7.0 or later
• PHP 8.0 or later

Installation

1. Upload the wc-craft-bundles folder to wp-content/plugins/.
2. Activate the plugin from Plugins → Installed Plugins.
3. Navigate to WooCommerce → Settings → Craft Bundles to review the default configuration.
4. Optionally import products via WooCommerce → Import Craft CSV.

Configuration

All settings live under WooCommerce → Settings → Craft Bundles:

• Dark Theme — enable or disable the dark storefront stylesheet.
• Free shipping threshold — set the cart subtotal (£) at which free shipping activates.
• Bundle Discount Tiers — add, edit, or remove quantity/percentage tiers using the tier table.

File Structure

wc-craft-bundles/
├── wc-craft-bundles.php          Main plugin file — bootstraps everything
├── includes/
│   ├── class-bundle-discounts.php     Tiered discount engine (woocommerce_cart_calculate_fees)
│   ├── class-csv-importer.php         CSV product importer — creates variable products
│   ├── class-shipping-restrictor.php  UK-only shipping + free-shipping threshold
│   └── class-admin-settings.php       WooCommerce settings tab + tier manager
├── assets/
│   └── css/
│       └── dark-theme.css             Dark storefront stylesheet (CSS custom properties)
├── templates/
│   └── admin-settings.php             Discount tier table rendered in the settings tab
└── import-templates/
    └── craft-supplies.csv             15-product import file for testing

Hooks Reference

License

GPL-2.0-or-later. See LICENSE.