- Help Center Home
- Getting started
- Introducing FacetWP
- Installation and updates
- FAQ
- How it works
- What are facets?
- Facet types
- Indexing
- Listing templates
- Extras & integrations
- Add-on features and extras
- Using FacetWP with …
- Built-in integrations
- Advanced Custom Fields
- WooCommerce
- SearchWP
- WP-CLI
- Add-on integrations
- Elementor
- Beaver Builder
- WP Recipe Maker and Tasty Recipes
- Relevanssi
- WPML and Polylang
- Pods
- Meta Box
- Flatsome (theme)
- External integrations
- Listify (theme)
- Listable (theme)
- WPGraphQL
- Document Library Pro
- Tips & tricks
- WooCommerce plugins
- WordPress multi-site
- WP Job Manager
- WP All Import
- Easy Digital Downloads
- EDD Reviews
- Intuitive Custom Post Order
- Custom Taxonomy Order
- Post Types Order
- Genesis framework
- WP External Links
- ElasticPress
- Caching & hosting
- WP Rocket
- Cloudflare
- New Relic
- WP Engine
- Fast Velocity Minify
- Incompatibilities
- Incompatible plugins
- Troubleshooting
- Troubleshooting guide
- Using the right query
- Common issues
- Get support
- Developers
- Hooks reference
- JavaScript reference
- Shortcodes reference
- FacetWP REST API
- How FacetWP works
- Tutorials
- Code snippets
- Changelog
Changelog
4.0.1
- May 2, 2022
- Improved admin UI - display facet / template names in the list tables
- Improved support value-less shortcode atts, e.g. `[facetwp template="test" static]`
- Fixed prevent reset facets from resetting other reset facets (reset-ception)
- Fixed sort facet - make default label translatable via `facetwp_i18n` hook
- Fixed CSS issue when using multiple FacetWP (shortcode) listings on a page
- Fixed CSS issue preventing listing builder's default 1-column mobile layout
- Fixed restore a11y compat for the "old" sort feature
- Fixed counts shortcode display issue when per_page = -1
- Fixed cast page numbers as `int` for FWP()->facet->pager_args
4.0
- Apr 18, 2022
- Important FacetWP 4.0 requires PHP 7.0 or above
- New Reset facets
- New support for WP Rocket
- New support for multiple (static) FacetWP templates on a page
- New ability to duplicate facets/templates from the admin listing
- New ability to copy facet/template shortcodes from the admin listing
- New added `post:image` dynamic tag to the Listing Builder
- New `facetwp_facet_pager_link` hook to customize the pager output
- Improved much better Listing Builder admin UI
- Improved tweaked the order of the "Data source" options
- Improved added `span` around checkbox / radio display values
- Improved admin.css uses CSS variables to standardize colors
- Improved better admin UI tooltip help text
- Improved a11y - better support for pager and sort facets
- Improved pager - "Per page" facets support a "Show All" option
- Improved facetwp_display() now supports an optional 3rd argument ($atts)
- Improved allow sort labels to be translated using `facetwp_i18n`
- Improved made the admin tooltip UI less subtle
- Improved renamed "Templates" to "Listings"
- Fixed sort facet choices by depth only when hierarchical
- Fixed sort facets should override the default relevancy sort when in use
- Fixed autocomplete - the UI should adhere to the `facetwp_facet_autocomplete_limit` hook
- Fixed star rating facets work with the "Hide empty facets" tutorial
- Fixed issue with multiple EDD `[downloads]` shortcodes on a page
- Fixed remove Reset and Sort facets from the "User selections" list
- Fixed prevent duplicate refreshes when using custom fSelect elements
- Fixed fSelect - when "Hierarchical" setting is off, ignore depth to prevent display issues
- Updated noUiSlider
- Updated package.json
3.9.6
- Feb 15, 2022
- Improved Value modifiers setting - automatically handle encoded characters (e.g. "&")
- Improved fSelect - cleaned up styling, removed troublesome "!important" CSS properties
- Fixed WooCommerce - translation support for static strings (On Sale, In Stock, etc)
- Fixed auto-ignore the "GDPR Cookie Consent" plugin's post type
3.9.5
- Feb 1, 2022
- Fixed Ignore WP 5.9 internal post types (wp_global_styles, etc)
- Fixed Dropdown - only indent choices when "Hierarchical" setting is enabled
- Fixed User selections - choices for inherited UI types not displaying correctly
3.9.4
- Jan 12, 2022
- Fixed fSelect counts duplicating during paging
3.9.3
- Dec 30, 2021
- New added UI setting to toggle accessibility features
- Improved checkboxes - auto-expand if a checkbox within an overflow is selected
- Improved layout builder - HTML items automatically parse shortcodes
- Improved layout builder - added "is-empty" CSS class for empty items
- Improved fSelect - replaced CSS class "hidden" with "fs-hidden" to prevent conflicts
- Improved a11y - added `aria-label` attribute to sort facets
- Improved a11y - added `aria-current` attribute to the pager's current page
- Improved a11y - better support for checkbox facets
- Improved a11y - automatically exclude ghost choices from ARIA
- Fixed handle edge case of `parse_url()` returning false
- Fixed doc links
3.9.2
- Dec 2, 2021
- New added `facetwp_facet_autocomplete_limit` hook to control max results
- New added "Comment count" as a sort option (layout builder and sort facets)
- Improved moved some layout builder CSS into `front.css` for easier overriding
- Improved better instruction text for the query builder's "value" box
- Improved checkbox facets - show the "Soft limit" setting only when "Hierarchial" is off
- Fixed proximity facet "Source other" setting (props Jenny)
3.9.1
- Nov 2, 2021
- Fixed PHP "null coalescing operator" error for sites running PHP 5
- Fixed PHP "undefined index" warning for the sort facet
3.9
- Oct 19, 2021
- Important Some deprecated JS method names have been removed
- New sort facets! Create your own sort boxes from within the admin UI
- New inheritable facets! Facet types can now inherit the UI from other facet types. Range List is the first add-on to incorporate this feature, letting you choose whether to display a dropdown, checkboxes, radio, etc.
- New facet field registration (more info coming in 4.0)
- Improved smarter "re-index" notifier, now ignores non-indexable facets (search, pager, etc)
- Improved simplified the internal `get_svg` method
- Improved removed unnecessary Vue dependencies, updated libs
- Improved tweaked admin UI font sizes, other styles
- Improved updated admin labels and tooltips for more clarity
- Improved hide the data source "ACF" header if no ACF fields exist
- Improved search facet - set autocomplete = "off"
- Fixed fUtil - return empty results when the selector is an empty string (jQuery parity)
- Updated translations
3.8.12
- Sept 17, 2021
- Improved SearchWP - faster speed by loading only necessary data (props Remco)
- Improved SearchWP - support additional args passed into SWP_Query (post_type, post_status, meta_query, etc)
- Improved A11y - added ARIA support for fSelect facets
- Improved Layout builder - add row count class (r1, r2, etc) to the `.fwpl-result` element
- Fixed fUtil - `.prev`, `.next`, `.find` and `closest` methods now support multiple selectors
- Fixed the above fUtil change fixes previously-broken Conditional Logic actions
3.8.11
- August 30, 2021
- Improved smarter slider range (now dynamically adjusts even with selected values)
- Fixed slider pageload quirks (more info)
- Updated noUiSlider
3.8.10
- August 20, 2021
- Fixed WooCommerce - some choices weren't showing for variation-based facets in "OR" mode
3.8.9
- August 9, 2021
- Improved use wp_date() instead of DateTime->format() for i18n
- Improved 3 new pager "Result counts" tags: [page], [per_page] and [total_pages]
- Improved prevent pager / per page / sort values from getting stored in `FWP.facets` JS object
3.8.8
- July 9, 2021
- Fixed move indexing to `init:1000` to allow sufficient time for post type / taxonomy registration
- Fixed radio facets - force in "OR" mode (props Kari S.)
- Fixed date picker - edge case offset issue (props Lucas T.)
- Fixed MS Edge requires JS `catch(err)` instead of `catch` (props George H.)
- Updated Norwegian translations (props Johan F.)
3.8.7
- June 29, 2021
- Improved removed need for `float: right` CSS on Star Rating facets
- Improved indexer - ensure that `post_author` user exists
- Improved fetch API - include `term_id` in the response
3.8.6
- May 25, 2021
- Fixed issue caused from 3.8.5 script versioning change
3.8.5
- May 24, 2021
- New `facetwp_facet_display_value` hook (to customize choice labels)
- New `facetwp_facet_hierarchy_arrow` (to customize the "Back" arrow)
- New `get_terms` helper method to bypass 3rd party hooks (*ahem* WPML)
- Improved redesigned the admin status bar, other design tweaks
- Improved support versioning of add-on scripts (to bust browser cache)
- Improved Autocomplete - translatable UI strings
- Fixed PHP8 "optional before required parameters" deprecation notice
3.8.4
- May 6, 2021
- Improved `$params['place_details']` is now available when indexing ACF Google Map fields
- Improved A11y - support Hierarchy fields
- Improved Slider facet - the "Compare type" UI setting is now always available
- Fixed Autocomplete facet - timing issues with some CSS-based templates
- Fixed Gutenberg (10.5.0) - ignore the `wp_template` post type
3.8.3
- April 22, 2021
- Improved more tooltip info for the slider facet's "Format" setting
- Fixed fully reset the indexer when purging the index table
- Fixed Dropdown - restore support for jQuery-based enhancement libs (select2, chosen, etc)
- Fixed PHP notice caused by the "load_jquery" setting
- Fixed updated vue-select.js to resolve scrolling issues
3.8.2
- April 6, 2021
- Improved fUtil.js - enable event bubbling by default
- Improved fComplete.js - automatically close after selection
- Improved API - fetch method accepts "application/json" (docs updated)
- Improved use jQuery if available for document.ready, sort, and per-page boxes (back compat)
- Improved cache FWP_Helper->get_term_depths()
- Improved fSelect.js - trigger native JS "change" event
- Fixed fSelect.js - preserve existing class names
- Fixed fSelect.js - restore "fs-open" class when open
- Fixed restored "Go" button for autocomplete facets
- Fixed JS error for "user selections" when no results
- Fixed JS error within accessibility.js
- Updated package.json
3.8.1
- March 19, 2021
- Fixed better JSON error handling (due to 3rd party output buffering issues)
- Fixed better support for 3rd party caching and script deferring (i.e. Autoptimize)
- Fixed restored the `facetwp/ajax_settings` JS hook
- Fixed changed `init` hook priority from 10 to 20, some post types (i.e. Pods) were not indexing
- Fixed load more button
- Fixed hierarchical checkbox "expand" buttons
3.8
- March 16, 2021
- Important 3.8 is a MAJOR REWRITE. Please test first on a staging site!
- New removed jQuery dependency from FacetWP core
- New fUtil helper JS library (JS abstractions)
- New fDate date picker JS library
- New fTip tooltip JS library
- New fComplete autocomplete JS library
- New added “settings” to Debug Mode for faster debugging
- Improved modernized and refactored front-end JS code
- Improved removed jQuery libraries (query-autocomplete, jquery-powertip, etc)
- Improved complete rewrite of fSelect JS library
- Improved raw data is now sent on AJAX requests (less payload)
- Improved update checks are now made via HTTPS
- Improved removed upgrade routines > 3 years old
- Improved fSelect - simplified accents/diacritics removal code
- Improved add proximity “locate me” to keyboard nav