Description
FacetCore Lite helps shoppers narrow down a WooCommerce catalog by product attributes and search by product name or SKU.
A Finder is a saved product search and display configuration that you place on a page with a shortcode. Give each Finder its own filters and category scope, then display matching products in a Grid. Customers can combine filters, see matching product counts and browse results without reloading the page.
Included in Lite
- Multiple published Finders, each with its own shortcode and settings.
- Product Grid with images, names, prices and optional SKU display.
- Filters using global WooCommerce attributes: choose and order up to 10 per Finder.
- One selected value per filter; selections across different filters are combined.
- Optional product name and SKU search.
- All-products scope or selected categories, including their subcategories.
- Filter value counts and pagination, with 1 to 100 products per page.
- Automatic attribute index updates and a manual Rebuild Index action.
- No plugin-imposed limit on the number of products or published Finders. Practical capacity depends on your hosting and catalog.
Example: a parts catalog
Create global attributes such as Manufacturer, Socket and Memory Type, then assign their values to your products. Create a Finder for your Components category and select those attributes as filters. Shoppers can narrow the Grid by specifications or search for a known product name or SKU. Create another Finder for a different category using its own settings.
Quick start
Install and activate WooCommerce and FacetCore Lite. Create global product attributes and assign their values to products. Go to FacetCore > Add New, configure and publish a Finder, then copy its shortcode into a Shortcode block on a page. See Installation below for the full steps and verification checks.
Optional FacetCore Pro add-on
FacetCore Pro is a separate plugin that extends Lite. It requires active FacetCore Lite 1.3.0 or newer and adds:
- Table view with configurable product and global attribute columns.
- Customer switching between Table and Grid when both views are enabled.
- Up to four additional global attributes on Grid cards.
- Custom CSS for each Finder.
- Shareable links that preserve filters, search, view and page, with link copying and browser Back/Forward support.
Multiple Finders, attribute filters, search and index rebuilding are already included in Lite. Lite does not restore filter selections from Pro links.
Upgrading and data
Back up your database and existing plugin files before updating. Update FacetCore Lite in place, keeping the facetcore plugin folder. Do not delete/uninstall the base plugin to replace it: uninstall removes FacetCore-owned data. Existing Finder IDs, shortcodes and database tables are retained by in-place updates.
Moving from an older paid installation
Obtain the separate compatible Pro ZIP through your existing purchase or support channel before replacing an older installation that includes paid features. There is no automatic entitlement lookup or Pro delivery mechanism in these plugins. Test the update on staging first, replace the base plugin in place and activate Pro. Pro requires Lite 1.3.0 or newer; when moving from 1.2.0, update both packages together.
Lite supports all public published Finders. The previous active-Finder option is ignored; configurations, IDs and publication statuses are retained. A saved Table configuration displays as Grid without Pro; saved Pro settings remain available when compatible Pro is reactivated.
Existing selection links
Selection links are Pro-only in 1.3.0. Lite leaves old Finder URL parameters untouched but does not restore their selections; it starts with the Finder’s normal initial state. Filtering, search and pagination still work without reloading. Pro retains the existing link format and independent Finder states, including browser Back/Forward and unrelated URL parameters. Saved Finder configurations need no migration.
Compatibility information
The existing 1.3.0 release documentation records edition integration testing on WordPress 7.1, WooCommerce 11.1.1 and PHP 8.3.33. Minimum-version and multisite runtime matrices and visual browser checks were not run for that release. This documentation update does not add compatibility test coverage.
Installation
- Install and activate WooCommerce from Plugins > Add New Plugin. FacetCore’s declared minimums are WordPress 6.5, PHP 7.4 and WooCommerce 9.0.
- In Plugins > Add New Plugin, search for FacetCore Lite, install it and click Activate. For a ZIP, use Upload Plugin on the same screen, install the ZIP and activate it.
- Go to Products > Attributes. Create the global attributes you want to use, add terms through Configure terms, then assign those attributes and values to products under Product data > Attributes. Save the products. Attributes created only inside an individual product are not available as Finder filters.
- Go to FacetCore > Add New and enter a name. In Products, choose All products or Selected categories. In Filters, select and order your global attributes. In Results, choose whether to enable product name and SKU search. Lite displays results in a Grid.
- Open Advanced settings if you want to show SKU on cards, change Products per page or adjust Show facet counts and Hide impossible values.
- Click Publish and keep the Finder public, without a password. Saving a Finder builds or refreshes the index for its selected filter attributes. Wait for saving to finish; a large catalog may take a while. If indexing fails, resolve the error and save again.
- Copy the shortcode from the Finder’s Shortcode box. Open Pages > Add New Page or edit an existing page, add a Shortcode block and paste the copied shortcode, for example
[facetcore id="123"]. Replace 123 with your actual Finder ID. Publish or update the page. - Open the page as a logged-out visitor. Confirm that products load, select an attribute value, try a known product name or SKU and check pagination if there are enough results. Clear the search and filters to return to the initial results.
The index supports attribute filtering; it is not a separate copy of your entire shop. Product name, SKU, category and visibility are read from WooCommerce. Attribute changes normally update the index automatically. After an import that bypasses normal WooCommerce updates, or if attribute filters are stale, go to FacetCore > Index, click Rebuild Index and check the reported status.
FAQ
Does FacetCore Lite require WooCommerce?
Yes. Install and activate WooCommerce before using FacetCore Lite. WooCommerce supplies the products, global attributes, categories and product data. Pro also requires Lite to remain active.
Which attributes can I use as filters?
Use global WooCommerce attributes created under Products > Attributes, with terms assigned to products. Custom attributes entered only on an individual product are not offered in the Finder settings. Select up to 10 global attributes per Finder. Customers select one value per filter and can combine different filters.
Can I publish more than one Finder in Lite?
Yes. Lite has no limit on the number of published Finders. Each has its own settings and shortcode ID. You can also place different Finders on the same page; their filters, search and pagination operate independently. Draft, private and password-protected Finders are not available to visitors.
Do I need to build an index manually?
Saving a Finder indexes its selected filter attributes. Product and attribute changes handled through WooCommerce and WordPress normally keep that index updated. Use FacetCore > Index > Rebuild Index if filters become stale, particularly after an import that bypasses normal update hooks. Rebuilding refreshes the selected filter attributes of all saved Finders. Products without those attributes can still appear before attribute filters are applied.
Why is my Finder empty or missing products?
Check the shortcode ID and confirm that the Finder is published, public and not password-protected. Check that the products are published and visible in the catalog. Products hidden from the catalog are excluded; WooCommerce’s setting to hide out-of-stock items is also respected.
Clear the search and filters. If Selected categories is enabled, select categories containing the products; selecting no categories returns no products. Category scope includes subcategories. For attribute filtering, confirm that matching global attribute terms are assigned to the products and selected in the Finder, then check FacetCore > Index and rebuild if needed.
If the page reports a loading error rather than zero results, check that your site allows requests to its WordPress REST API.
What is the difference between Lite and Pro?
Lite includes multiple Finders, Grid, global attribute filters, name/SKU search, category scope, counts, pagination, shortcodes and automatic/manual indexing. Neither edition imposes a product-count limit.
The separate Pro add-on adds Table and its columns, Table/Grid switching, additional card attributes, per-Finder Custom CSS and links with saved selections. Pro is not needed to publish multiple Finders or rebuild the index.
Will updates or deactivation delete my data?
Normal in-place updates retain Finder IDs, shortcodes, configurations and FacetCore database tables. Deactivation retains data. Deactivating or deleting Pro retains shared data and saved Pro settings; Lite uses Grid, and reactivating compatible Pro restores its settings.
Deleting FacetCore Lite through WordPress runs its uninstall routine and removes FacetCore-owned data, including Finders, settings and index tables. Back up before updating and do not delete Lite as an update step. See Upgrading and data below for older installations.
Screenshots
Changelog
1.3.0
- Harden extension control HTML, WooCommerce price markup and product URLs.
- Use WordPress automatic translation loading and protect executable entry points from direct access.
- Allow multiple public published Finders in Lite and remove the single-Finder selector.
- Move selection links, URL history, restoration and link copying into the separate Pro add-on.
- Keep automatic indexing and manual index rebuild in Lite.
1.2.0
- Split Lite and the Pro add-on, retaining the common engine, Finder identifiers and stored settings.
