Docs Build Your Own Box

Requirements, privacy and FAQ

Requirements: WordPress 6.2, PHP 7.4 and WooCommerce 8.0 or newer. Works with High Performance Order Storage and legacy order storage, and with the Cart and Checkout blocks and the classic pages. WooCommerce Subscriptions only for boxes that renew.

Privacy: Neither plugin contacts any outside service. The free plugin stores no personal data of its own. Gift messages are saved on the order line and removed when WooCommerce anonymizes the order.

Which products can go in a box?

Published simple products and variations that can be bought. Grouped and external products, other boxes and products set to Sold individually are left out. A variation with an attribute set to Any is left out too, because the box needs an exact variation, so create one variation per option.

Can a sum of items box be sorted by price?

It shows a From price, but it has no price of its own, so the price sorting and the price filter of WooCommerce do not see it.

Do coupons work?

Yes, on the box line and the item lines the normal way. In a fixed price box the item lines cost nothing, so a coupon applies to the box price.

How many items can a pool hold?

Category and tag pools are limited to 500 products. The wfbb_pool_limit filter changes that.

For developers

Filters: wfbb_box_config, wfbb_pool_groups, wfbb_pool_cards, wfbb_item_usable, wfbb_validate_selection, wfbb_child_price, wfbb_box_discount, wfbb_box_fee, wfbb_box_children, wfbb_request_extras, wfbb_builder_data, wfbb_builder_submit, wfbb_store_api_box_row, wfbbp_builder_data, wfbbp_picking_statuses. Actions: wfbb_loaded, wfbb_builder_top, wfbb_builder_before_progress, wfbb_builder_before_buy, wfbb_builder_form_end, wfbb_order_line, wfbb_product_panel_end, wfbb_product_save. Store API cart items carry extensions.wfbb. WFBB_Cart::add_box() adds a box in code with the same checks. Shortcode: [wfbb_box id="123"].