WPCE - WooCommerce Parts Compatibility Editor

Note: Always take a full backup of your website and database before updating to the latest version.

WPCE – WOOCOMMERCE PARTS COMPATIBILITY EDITOR

Customers leave when they cannot tell whether a product fits. WPCE solves that. It lets you build unlimited product compatibility finders, each with its own cascading dropdowns, terms and product associations, so shoppers narrow your catalogue by the thing they already own and see only the products that fit.

Auto parts, printer supplies, industrial machinery, furniture fittings, clothing sizes: you name the levels, import your data, and WPCE handles the rest. Fewer wrong orders, fewer returns, more completed checkouts.

FEATURES / HIGHLIGHTS

• Build unlimited product finders, each fully independent with its own settings
• Unlimited dropdown levels per finder (Make, Model, Year, Engine or any custom labels)
• Well optimized for large volume data, tested with 50,000+ terms and products
• Two dropdown loading methods: JSON (instant) and AJAX (best for large datasets)
• Sorting options per level: ascending and descending
• Range support for numeric levels, so you can import and display terms like 2005-2018
• Widget and Shortcode support
• Two layouts: Horizontal and Vertical
• Multiple finders on the same page
• Limit finder results to selected categories only
• Universal Products support, showing certain products regardless of selection
• Custom destination URL for search results
• Required field validation before search
• User-friendly select dropdowns as a replacement for default HTML selects
• Disable dependent dropdowns until parent selection is made
• Auto-redirect when search returns a single result
• Show or hide empty terms from dropdowns
• Hide the Submit button
• Auto-submit on last dropdown selection
• Reset Search link
• Remember Search across pages
• Search History and Saved Searches per user
• Product Validator on product details page
• Custom compatibility tab on product details page
• Every label, title, heading and description is editable from the backend
• Translation ready

BUILT FOR ANY INDUSTRY, NOT JUST VEHICLES

A finder is simply a set of dropdowns you name yourself. Nothing in WPCE is tied to cars, so the same plugin works wherever compatibility matters.

• Vehicle parts: Type > Make > Model > Year > Engine
• Printer supplies: Series > Model > Type
• Industrial machinery: Manufacturer > Machine > Component
• Furniture fittings, clothing sizes, appliance filters, and anything else you sell

UNLIMITED PRODUCT FINDERS

Running a store with several product categories? Create a completely separate finder for each one, with its own levels, terms and settings. Run them side by side on the same site, or even on the same page.

• Auto / Vehicle Parts Finder
• Clothing Finder
• Printer Finder
• And any other type you need

UNLIMITED DROPDOWN LEVELS PER FINDER

Every finder can have as many or as few dropdown levels as your products require. Simple or complex, you decide the structure, and you write the labels your customers actually recognise.

TWO TERM LOADING METHODS: JSON AND AJAX

Choose how dropdown options load when a user makes a selection. JSON mode loads terms instantly without any network request, which suits small to medium datasets. AJAX mode fetches terms on demand, making it the right choice for large datasets where loading everything upfront would slow the page. Both are a single setting, so you can try each one on your own data and keep whichever performs better.

LIMIT RESULTS TO SELECTED CATEGORIES

Selling multiple product types across different categories? Assign specific categories to each finder so your Auto Parts finder never surfaces clothing products, and your Clothing finder never surfaces brake discs.

CSV IMPORTER

Entering thousands of terms by hand is not realistic. The built-in CSV importer uploads all your compatibility data at once and links it straight to your products.

• Handles large volume imports with a progress bar
• Range support for numeric values (e.g. 1990-2012)
• Multiple product SKUs per cell for bulk associations
• Choose to keep or delete existing data before each import

UNIVERSAL PRODUCTS

Some products fit everything, whatever the customer selects. Mark those as Universal Products and they will always appear in search results. Each finder keeps its own set, and a separate CSV importer handles long lists.

PRODUCT VALIDATOR

Give customers confidence before they add to cart. The Product Validator lets shoppers check whether a product is compatible with their specific selection, right on the product page. You can automatically hide the Add to Cart button when it does not fit, and the validated selection carries through to Cart, Checkout, Order Details and email notifications for your own reference.

SEARCH HISTORY AND SAVED SEARCHES

Help returning customers find what they need faster. The plugin stores each user’s recent searches and lets them move the ones they use often into a Saved Searches list, so a repeat visit takes one click instead of four dropdowns.

REMEMBER SEARCH

Let customers browse freely without losing their search. With Remember Search enabled, their selection is retained as they move between pages, filtering shop and category pages to matching products only until they choose to reset.

CUSTOM COMPATIBILITY TAB ON PRODUCT PAGE

Adds a dedicated tab to the WooCommerce product page listing every compatible term for that product, the “which models does this fit” table your customers look for. Position and content are fully configurable, and the list can load via AJAX so long compatibility tables never slow the product page.

REQUIREMENTS

• WordPress with WooCommerce installed and active
• Your products already created in WooCommerce
• Product SKUs filled in, if you plan to import associations by SKU

DEMO / LIVE PREVIEW

• HORIZONTAL / VERTICAL FINDERS
• AUTO / VEHICLE PARTS FINDER
• AUTO / VEHICLE PARTS SEARCHES
• CLOTHES FINDER
• CLOTHES SEARCHES
• FINDER WITH CATEGORY FILTER

DOCUMENTATION

• DOCUMENTATION

CHANGELOG

= 4.1 =
* Improved: Security across searches and admin actions
* Improved: Descending sort order now works in dropdowns
* Improved: Faster page loads on large finders
* Improved: Product compatibility tab loads more reliably
* Improved: Upgrade tools limited to store administrators
* Fixed: Rare blank page from invalid search data
* Note: Search history resets once. Saved searches unaffected.

= 4.0 =
* Performance: Major improvements to overall page load speed
* Performance: Significant reduction in database queries
* Performance: Large CSV files now import considerably faster
* Performance: Increased import batch size for faster completion
* Improved: Product compatibility tab now follows sort order configured in finder settings
* Added: Year ranges in product compatibility tab (e.g. 2010-2015)
* Improved: Security improvements across requests
* Improved: Database structure optimized for large datasets
* Added: Automatic database upgrade system with admin notification
* Fixed: Universal Products import no longer removes previously imported products when adding new ones

= 3.6 =
* Tested: Compatibility with latest versions of PHP, WordPress and WooCommerce
* Fixed: Terms count issue with import when product does not exist

= 3.5 =
* Fixed: Terms Importer stuck at the end
* Added: Fallback handling when importer fails mid-process
* Fixed: Terms association issue with WooCommerce products in some cases

= 3.4 =
* Improved: Terms Importer speed significantly
* Fixed: Issue with term titles containing double quotes

= 3.3 =
* Tested: Compatibility with latest versions of PHP, WordPress and WooCommerce
* Fixed: Reset functionality conflict with Current Searches

= 3.2 =
* Fixed: PHP 8.x warning on term deletion

= 3.1 =
* Fixed: Compatibility with latest versions of PHP, WordPress and WooCommerce
* Fixed: PHP 8.x warnings, errors and deprecated functions
* Improved: Terms Importer speed
* Fixed: Remove Data on Uninstall issue
* Fixed: HTML validation warnings

= 3.0 =
* Fixed: Compatibility with latest versions of PHP, WordPress and WooCommerce
* Fixed: PHP 8.x warnings, errors and deprecated functions
* Fixed: Duplicate WPCE terms when duplicating a WooCommerce product
* Fixed: JavaScript warnings
* Fixed: Sorting issue with alphanumeric dropdowns
* Fixed: Overlapping text with user-friendly dropdowns
* Fixed: Terms Importer
* Added: Product tab terms list loads via AJAX for faster product page initial load
* Added: Shortcode for product tab terms list

= 2.0 =
* Added: Universal Products CSV Importer
* Added: Categories Filter
* Added: Comma support for multiple values per cell in Terms CSV Importer
* Improved: Terms CSV Importer handling for range-based levels (e.g. 2002-2007)
* Fixed: Deprecated function warnings
* Fixed: PHP 7.x warnings
* Fixed: All products showing when no matching product found on search results page
* Fixed: Slow loading on Edit Product page
* Improved: Multiple terms selectable from last dropdown on Edit Product page

= 1.1 =
* Fixed: Shortcode typo in backend
* Fixed: Level name placeholder not hiding when nth dropdown is not selected
* Fixed: Duplicate WPCE terms when duplicating a WooCommerce product
* Fixed: PHP warnings
* Fixed: JS conflict causing previous child dropdown options not to clear on new selection

= 1.0 =
* Initial release