Overview
Dprime Woo Filters provides three REST endpoints that return rendered shop layout HTML: a product grid, sidebar with filters, results toolbar, and pagination. The filters are configurable from a dedicated admin page: pick which taxonomies appear, drag to reorder, choose which start collapsed, restrict the category list, and set page title and subtitle.
Designed to be consumed by a Breakdance front end or any AJAX caller. The plugin focuses on rendering correctness, performance, and configurability. Theme styling is left to your front end.
This plugin requires an active Dprime subscription.
Before you start
- WordPress 6.4 or newer
- PHP 8.2 or newer
- WooCommerce must be active
Installation
- Upload the plugin folder to /wp-content/plugins/.
- Activate Dprime Woo Filters through the Plugins screen.
- Make sure Dprime Core is installed and your site is connected.
- Open the Woo Filters admin page under Dprime to configure.
- Wire your front end (or Breakdance template) to call the REST endpoints.
Interface guide
Use these screens with the steps below. Select an image to open it at full size.
Using the plugin
- Three public REST endpoints: shop, search, category
- Configurable filter taxonomies, drag and drop reorder, collapsed by default flag
- Category source mode: all categories or a hand picked subset
- Top level only mode for the category filter
- Price range filter toggle
- Hide empty terms toggle
- Sort orders: featured, price ascending, price descending, newest, best selling, top rated
- WooCommerce aware product action buttons for simple, variable, grouped, external, unavailable, and other product types
- Stable cart wrapper and button classes, including an in-place View cart state when plugin CSS is disabled
Shortcodes
Use these in the WordPress editor, a shortcode block, or a compatible page builder.
[dprime_category][dprime_search][dprime_shop]Styling and CSS classes
These public-facing class hooks are present in the plugin styles. Add custom CSS only after checking the result on a staging site.
.dprime-no-products.dprime-product-thumb.dprime-vh-filters-form.dprime-wf-app.dprime-wf-cols-2.dprime-wf-cols-3.dprime-wf-cols-4.dprime-wf-condition.dprime-wf-content.dprime-wf-filters-hidden.dprime-wf-grid.dprime-wf-layout.dprime-wf-sidebar.dprime-wf-sidebar-right.dprime-wf-warranty.dprime-wf-warranty-icon.dprime-wf-wishlist--image.dprime-wf-wishlist--inline.dpwf-added-flash.dpwf-cart-action.dpwf-cart-action--overlay.dpwf-cart-button.dpwf-hidden.dpwf-rangeWorks with
These connections are covered by the release contract tests.
- Woo Wishlist: Wishlist buttons in filtered product results
- Woo Product Condition: Condition filtering and result metadata
- Woo Product Warranty: Warranty filtering and result metadata
Data and cleanup
- 1 WordPress setting
- Content metadata: _wp_attachment_image_alt
Retention: kept until the plugin is uninstalled. Uninstall policy: delete the plugin-owned data declared above.
Troubleshooting
- Confirm the required WordPress, PHP, and companion-plugin versions above.
- Save the plugin settings again, then repeat the exact action that failed.
- Clear page, object, and browser caches when the issue affects front-end output.
- Temporarily test with unrelated plugins disabled on a staging site to identify a conflict.
- If the problem remains, record the steps, visible error, and relevant logs before contacting support.
Frequently asked questions
How do I call the REST endpoints?
GET /wp-json/dprime-wc-filters/v1/shop, /search, or /category. See the Help tab in the admin page for the full parameter reference.
Can I filter by multiple taxonomies at once?
Yes. Pass each taxonomy slug as an array: product_cat[]=shoes&product_cat[]=hats&pa_color[]=blue.
Can I change the response format?
Use the dpwft_query_args filter to alter the underlying WP_Query. The response shape (title, subtitle, sidebar, toolbar, products, pagination) is fixed for consumer compatibility.
How do I style the View cart link when plugin CSS is disabled?
Target .dpwf-cart-action for the cart action wrapper and .dpwf-cart-button for the action link. After a successful AJAX addition, that same link becomes .dpwf-view-cart and the wrapper receives .is-added; no second button is retained.
Updates and access
An active individual or portfolio entitlement provides updates and support. After expiry, the installed local version remains, while update access, support, new activations, domain moves, and protected remote services stop.