BoxCraft for WooCommerce

Description

๐Ÿ“ฆ Build-your-own-box, done right

BoxCraft lets your customers create their own box from your WooCommerce catalogue: Pack of 6, Pack of 12, or any size you define. You decide which products are eligible and how the box is priced. Customers pick items with a fast, mobile-friendly picker, watch a live progress bar fill up, and add the finished box to the cart.

Perfect for chocolate and snack boxes, coffee and tea samplers, bakery boxes, skincare sets, wine and craft-beer packs, gift hampers, plant bundles and anything else sold in fixed quantities.

โœจ Highlights

  • ๐Ÿ“ Fixed item count: a Pack of 6 must contain exactly six items. The Add to cart button stays disabled until the box is complete.
  • ๐Ÿ’ฐ Two pricing modes per pack size:
    • Fixed pack price: for example, any six items cost $30.
    • Sum of selected items: the box costs the total of the chosen products’ WooCommerce prices, sale prices included.
  • ๐ŸŽฏ Flexible eligibility: choose products by search, by category (sub-categories included), exclude specific products, and set optional per-product limits.
  • ๐Ÿ” Repeat selections: allow several units of the same product, or restrict each product to one per box.
  • ๐ŸŽจ Variable products supported: the customer must choose a variation (size, flavour, colour) before it counts.
  • ๐Ÿ“Š Live progress and total: “4 of 6 items selected”, with the price updating instantly.
  • ๐Ÿ›’ Works in your cart: the box appears as one clear line with its contents listed underneath. Customers can edit it from the cart.
  • ๐Ÿ”’ Server-side validation: price, item count, variations and stock are re-checked on the server. Nothing the browser sends is trusted.

๐Ÿงฉ Everything you get

For shoppers ๐Ÿ›๏ธ

  • Responsive product picker with grid or list layout and touch-friendly controls
  • Search, category filter and sorting by name or price
  • Product images, descriptions, prices and stock status (“In stock”, “Only 3 left”, “Out of stock”)
  • Quantity steppers and add/remove buttons
  • Live progress bar and price summary: sticky bar, side panel or above the products
  • Clear messages such as “Select 2 more items to complete your box”
  • Edit a box from the cart with the previous selection restored and re-validated
  • Box contents visible in the cart, checkout, order confirmation, My Account and emails

For store owners ๐Ÿง‘โ€๐Ÿ’ผ

  • Create as many boxes as you like, each with several pack sizes
  • Collapsible pack-size sections with a one-line summary, plus Expand all / Collapse all
  • Pricing summary preview for every pack size
  • Availability dates: start and end date for seasonal boxes
  • Coupon control: allow or block coupons per box
  • Tax class and shipping class per box, following your WooCommerce tax settings
  • Show or hide product images, descriptions and prices in the picker
  • Custom button label, accent colour, error messages and layout settings
  • Basic reports: orders by pack size, by pricing mode, and your most-selected products

Inventory ๐Ÿ“ฆ

  • Stock is validated whenever a box is added, edited, or its quantity changes
  • Component stock is reduced when an order is placed, restored on cancellation, and restocked on refunds when “Restock refunded items” is ticked
  • Hide out-of-stock products or show them as unavailable. Out-of-stock items can never be added to a box.
  • Works for fixed-price boxes too: the selected products’ stock is still tracked

Placement ๐Ÿ“

  • Automatic product page for every box
  • Show a box on other product pages, on chosen category pages or on the shop page
  • [byob_box id="123"] shortcode
  • “BoxCraft box” Gutenberg block

Built to be trusted ๐Ÿ›ก๏ธ

  • HPOS (High-Performance Order Storage) compatible
  • Works with the classic and block-based Cart and Checkout
  • Accessible: keyboard navigation, screen-reader announcements, text labels (not colour alone)
  • Translation-ready, and follows your site’s language, currency and decimal settings
  • Capability checks and nonces on admin actions; sanitised, escaped and prepared throughout
  • Uninstalling never deletes WooCommerce orders

๐Ÿš€ Want more? BoxCraft Pro

Go beyond a single fixed-count box with BoxCraft Pro:

  • ๐Ÿชœ Multi-step boxes: “Choose 2 snacks, 2 drinks, 2 extras”
  • ๐Ÿ“ Selection rules: minimums, maximums, required and incompatible items
  • ๐Ÿ’Ž Advanced pricing: tiers, surcharges, discounts, paid add-ons and free gifts
  • ๐Ÿงฌ Templates, duplicate boxes and JSON export / import
  • ๐Ÿ’Œ Gift messages, personalisation, saved and shared boxes
  • ๐Ÿ“ˆ Richer reports with CSV export

Learn more about BoxCraft Pro

How it works

Each box owns a hidden WooCommerce product (the “box product”). The cart and order line is that product with a name like “Snack Box โ€” Pack of 6”. The selected items are stored on the line and re-validated on the server whenever the cart changes and again at checkout. The price is always calculated on the server, and nothing sent by the browser is trusted. Do not delete the box product: cart and order lines use it.

Deactivation and uninstall

  • Deactivating the plugin keeps all boxes, settings and orders. Existing orders keep their box contents as order item meta, so they stay readable.
  • Disabling a box (untick “Enabled”, change it to draft, or trash it) hides it on the storefront and makes its box product private. Existing orders are unaffected; carts that still contain it are asked to remove it.
  • Deleting the plugin never deletes WooCommerce orders or their box data. Box configurations and settings are removed only if “Delete box configurations when the plugin is deleted” is ticked in Settings. Box products are always kept because past orders refer to them.

Known limitations

  • Fixed-amount (whole cart) coupons cannot be blocked for a single line item by WooCommerce. “Allow coupons: off” stops WooCommerce applying coupons to the box line (percentage and fixed-product discounts, and the box’s share of fixed-cart discounts).
  • The “Edit box” link in the Cart block is shown as a link only in themes and versions that allow HTML in item data. The classic cart and the cart notices always show a clickable link.
  • Block themes do not run classic product hooks. The box is injected in place of the Add to Cart block on its own product page, and other placements need the block or shortcode.
  • All pack sizes of one box share the tax class and shipping class set on the box.

Screenshots

Blocks

This plugin provides 1 block.

  • BoxCraft box Let customers fill a box with a fixed number of products.

Installation

  1. Install and activate WooCommerce.
  2. Upload the boxcraft-for-woocommerce folder to /wp-content/plugins/, or install it from Plugins Add New.
  3. Activate BoxCraft for WooCommerce through the Plugins screen.
  4. Open the BoxCraft menu (below Products) and click Add box.
  5. Give the box a name (shown in the cart as “Name โ€” Pack of 6”), then add a description and featured image.
  6. On the Pack sizes & pricing tab add your sizes (for example 6 and 12), choose the pricing mode and pick the eligible products or categories.
  7. Click Publish. The box gets its own product page automatically. Use the shortcode or block to show it anywhere else.
  8. Visit BoxCraft Settings to adjust labels, messages, accent colour, emails and reports.

FAQ

๐Ÿค” How does a customer build a box?

They choose a pack size, pick products in the picker until the progress bar is full (for example “6 of 6 items selected”), then click Add box to cart. The button stays disabled until the box is complete.

๐Ÿ’ฒ What is the difference between the two pricing modes?

With Fixed pack price the customer always pays the price you set (for example $30 for six items), whatever they choose. With Sum of selected items the price is the total of the chosen products’ current WooCommerce prices, sale prices included. You can choose a different mode for each pack size.

๐Ÿ” Can a customer pick the same product more than once?

Yes, if you leave Allow repeat selections on (the default). They can add several units, up to the product’s available stock. Turn it off to allow each product or variation only once per box.

๐ŸŽจ How do variable products work?

The customer must choose a variation (for example flavour or size) before the item counts toward the box. The variation’s own price and stock are used.

๐Ÿ“ฆ Is stock reduced for the products inside the box?

Yes. When the order is placed the stock of every selected product or variation is reduced, using WooCommerce’s normal stock rules. It is restored if the order is cancelled, and restocked on refunds when you tick “Restock refunded items”. This also applies to fixed-price boxes. You can switch it off per box in the Inventory tab.

๐Ÿšซ What happens if a product sells out or is unpublished while it is in someone’s cart?

Nothing is silently charged. The cart and checkout re-validate every box. If something is no longer available the customer sees a clear message with an Edit your box link and must pick a replacement before checking out.

๐Ÿ” Can customers cheat the price by editing the page?

No. The price, item count, variations and stock are all calculated and checked on the server. The browser’s numbers are only for display.

๐Ÿงพ Where do customers and I see the box contents?

In the cart, checkout, order confirmation page, My Account, the admin order screen and, if you leave Include box contents in order emails on, in order emails.

๐ŸŽŸ๏ธ Can I stop coupons applying to boxes?

Yes. Untick Allow coupons in the box’s General tab.

๐Ÿงฎ How are tax and shipping handled?

Totals follow your WooCommerce tax and currency settings. Choose a tax class and a shipping class for each box in the General tab. The box ships as a single item.

๐Ÿ“ Where can I show a box?

On its own automatically created product page, on other product pages, on category pages or the shop page (set in the Placement tab), or anywhere with the [byob_box id="123"] shortcode or the BoxCraft box block. In block themes, add the block or shortcode to the template or page where you want it.

โฐ Can I run a box only for a limited time?

Yes. Set optional start and end dates in the General tab. Outside those dates the box is hidden.

๐Ÿ›‘ What happens if I disable or delete a box?

Disabling a box hides it on the storefront and makes its product private. Existing orders are not affected and keep their contents. Please do not delete the hidden box product, because cart and order lines use it.

๐Ÿงน What happens if I deactivate or delete the plugin?

Deactivating keeps everything. Deleting the plugin never deletes WooCommerce orders or their box data. Box configurations and settings are removed only if you tick Delete box configurations when the plugin is deleted in Settings.

๐Ÿงฑ Does it work with block themes and the block Cart and Checkout?

Yes. BoxCraft supports the classic and block-based Cart and Checkout, and is compatible with HPOS.

โ™ฟ Is it accessible?

The picker supports keyboard navigation, labelled controls, screen-reader progress announcements, and text labels instead of relying on colour alone.

๐ŸŒ Can I translate it?

Yes. All strings are translation-ready and use the boxcraft-for-woocommerce text domain.

๐Ÿ’Ž What does BoxCraft Pro add?

Multi-step boxes, selection rules, advanced pricing and discounts, templates, gift messages and personalisation, saved and shared boxes, and richer reports. See BoxCraft Pro.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“BoxCraft for WooCommerce” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

1.0.0

  • ๐ŸŽ‰ Initial release: pack sizes, fixed and sum pricing, product picker, cart editing, stock handling, shortcode, block and reports.