Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/ryansallen98/woo-build-your-own-product/archive/refs/heads/main.zipNo built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Woo Build Your Own Product adds a custom WooCommerce product type that allows customers to build their own box (e.g. “Build Your Own Munchy Box”) by selecting quantities of predefined items. It’s perfect for catering boxes, snack boxes, gift boxes, meal kits, and custom bundles.
✨ Features
- ✅ Custom product type: Build Your Own
- ✅ Admin UI to define:
- Max items per box
- List of selectable components (e.g. chicken wings, sausages, snacks)
- ✅ Frontend “Build Your Box” builder with live remaining counter
- ✅ Server-side validation (customers must select exactly the allowed number of items)
- ✅ Stores box contents in cart, checkout, and order
- ✅ Clean, formatted order summary (human readable)
- ✅ WooCommerce template overrides supported
- ✅ Theme-friendly (no hardcoded markup)
- ✅ Cart/checkout UX clean (no product description spam)
⚙️ Installation
- Upload the plugin to:
/wp-content/plugins/woo-build-your-own-product/ - Activate the plugin from WordPress Admin → Plugins
- Make sure WooCommerce is installed and active.
🛠 Usage (Admin)
- Go to Products → Add New
- Choose product type: Build Your Own
- Configure:
- Price (as normal)
- Max items in the box
- Available items (components)
- Publish the product
🛍 Usage (Customer)
On the product page, customers will see:
- A table of available items
- Quantity selectors
- A live “Remaining items” counter
- Add to cart button only works when the exact number of items is selected
📦 Cart & Orders
-
Cart and checkout display selected items clearly.
-
Order confirmation shows:
Contents: Sausage × 3
Chicken × 2 -
Admin can see box contents in the order view.
🎨 Template Overrides
You can override frontend templates in your theme:
yourtheme/
└── woocommerce/
└── woo-build-your-own/
└── single-product/
└── add-to-cart/
├── build-your-own.php
└── build-your-own-add-to-cart.php
🧠 Known Limitations
- Component items are not individual WooCommerce products (currently).
- Pricing is per product, not per component.
- Stock is managed at the product level.
📜 License
MIT