| 1 |
# WooCommerce Builder Guide |
| 2 |
|
| 3 |
## What it does |
| 4 |
Replaces WooCommerce templates (Single Product, Product Archive, Cart, Checkout, My Account) with Elementor templates stored in `elementor_library` and tagged by `ka_woo_template_type`. |
| 5 |
|
| 6 |
## How to use |
| 7 |
1) Create a new Elementor template from **WP Admin → WooCommerce Builder → Add {Type} template**. |
| 8 |
2) In the meta box **Woo Builder Conditions**, pick the template type and set rules. |
| 9 |
- Rule types: `all_products`, `product_in`, `product_cat_in`, `product_tag_in`, `product_type_in`, `is_shop`, `product_cat_archive_in`, `cart`, `checkout`, `my_account`, `always`. |
| 10 |
- Values are picked with AJAX select (products, categories, tags, product types). |
| 11 |
3) Set **Priority** (lower runs first). Enable the template. |
| 12 |
4) Build the layout with Woo widgets (`Woo_Products_Grid`, Archive Title, etc.). |
| 13 |
5) New widgets (builder-ready): |
| 14 |
- Cart: `Woo_Cart_Coupon_Form`, `Woo_Cart_Empty`. |
| 15 |
- Checkout: `Woo_Checkout_Steps` (Pro), `Woo_Checkout_Sticky_Sidebar` (Pro), `Woo_Checkout_ACF_Fields` (Pro). |
| 16 |
- My Account: `Woo_My_Account_Dashboard`, `Woo_My_Account_Order_Details`, `Woo_My_Account_Logout`, `Woo_My_Account_ACF_Fields` (Pro). |
| 17 |
|
| 18 |
## Pro / Free |
| 19 |
- Free applies templates only for Single Product and Product Archive. |
| 20 |
- Cart / Checkout / My Account and advanced pagination/filters in grids require Pro. Pro-only items are locked with a padlock indicator. |
| 21 |
|
| 22 |
## Faceted filters |
| 23 |
- Set a `Query ID` in `Woo_Products_Grid`. |
| 24 |
- Frontend can dispatch `kingaddons:filters:apply` with `{ queryId, filters }` to reload the grid via AJAX. |
| 25 |
- URL params `kng_filter[QUERY_ID][tax|attrs|price]` and Woo defaults (`min_price`, `filter_{taxonomy}`) are also honored (Pro). |
| 26 |
|
| 27 |
## Notes |
| 28 |
- Context = `ka_woo_template_type`; no extra context field needed. |
| 29 |
- If used outside Woo pages in the editor, widgets show an info notice instead of rendering data. |
| 30 |
|
| 31 |
|
| 32 |
|
| 33 |
|
| 34 |
|
| 35 |
|
| 36 |
|
