// Changelog


  • July 7, 2017
  • New: added wp_doing_ajax() polyfill for WP < 4.7
  • Fix: add-on updater wasn't naming plugin folders properly
  • Fix: WooCommerce PHP notice (changed to $product->get_type())
  • Fix: JS show_expanded console error
  • Fix: issue with date range facets during pagination
  • Fix: skip template auto-detection for non-FWP ajax requests
  • Fix: EDD [downloads] query detection (props @spencerfinnell)
  • Added support for loop_no_results hook (arriving in WP 4.9)


  • June 28, 2017
  • Fix: issue with ACF fields in "Other data source" (needs a re-index)


  • June 19, 2017
  • New: template auto-detection for archive / shop pages (no need to edit template files!)
  • New: "Show expanded" setting for hierarchical checkbox facets
  • New: facetwp_use_search_relevancy filter to prevent search relevancy from overriding the default orderby
  • Improved: better error handling when a valid template isn't found
  • Improved: better help text for the "Parent term" tooltip
  • Improved: simplified Debug Mode code
  • Fix: strip slashes for quoted search keywords
  • Fix: IE11 issue with HTML5 placeholders (date picker)
  • Fix: PHP notice in WooCommerce integration
  • Updated flatpickr (3.0.5-1)
  • Updated noUiSlider (10.0.0)
  • Updated jQuery PowerTip (1.3.0)
  • Updated translations


  • May 22, 2017
  • Fix: pagination issue with CSS-based templates


  • May 19, 2017
  • New: facetwp_dismiss_notices filter
  • New: "Enclose" compare type for Date Range facets
  • Improved: better error handling for CSS-based templates
  • Improved: [+] and [-] buttons are now editable (using code)
  • Improved: added "fs-default" CSS class to fSelect boxes when no value is set
  • Improved: added "fs-open" CSS class to fSelect boxes when opened
  • Fix: indexing issue for ACF fields within the "Other data source" setting
  • Fix: FWP()->helper->format_number() was incorrectly stripping slashes
  • Added Polish translations (props Jakub J.)


  • April 26, 2017
  • New: indexer background processing
  • New: WooCommerce-specific UI settings
  • Improved: admin styling tweaks
  • Improved: run update checks only when using the dashboard
  • Fix: Autocomplete facets shouldn't return anything if query is empty
  • Updated flatpickr and jQuery Autocomplete
  • Updated translations


  • April 10, 2017
  • New: "Other data source" Proximity facet setting (if your longitude is stored separately)
  • New: facetwp_indexer_is_enabled filter (to turn off automatic indexing)
  • Improved: admin styling tweaks
  • Improved: extra sanitization for good measure
  • Improved: ignore those pesky _oembed Data source choices
  • Improved: WooCommerce pagination detection tweak
  • Improved: Only support ACF4+
  • Fix: JS error when a facet type no longer exists
  • Fix: Enable EDD support only with CSS-based templates
  • Updated translations


  • March 24, 2017
  • This is an important security release
  • Security fix: added nonces to prevent CSRF (props @dtbaker)


  • March 21, 2017
  • New: facetwp_api_valid_actions filter
  • Improved: set X-WP-Nonce header (REST API auth support)
  • Fix: REST API issue w/ PHP 5.3 (closures don't support $this yet)
  • Updated flatpickr


  • March 14, 2017
  • New: "Debug Mode" UI setting
  • Fix: Autocomplete facets using incorrect ajax endpoint


  • March 9, 2017
  • What's new in FacetWP 2.8
  • New: FacetWP now requires PHP 5.3+ and WordPress 4.4+
  • New: shortcode-based templates now use REST API endpoint (~15% faster)
  • New: support for ACF5 radio fields
  • New: added "element" param to facetwp/set_options/date_range JS hook
  • Improved: admin styling tweaks, and a new intro video
  • Improved: SearchWP-powered pages are now much faster for larger sites
  • Improved: FacetWP will show an admin notice if an integration add-on needs to be installed
  • Improved: FacetWP will throw a console.error if facets are inside "facetwp-template"
  • Improved: code cleanup, incl. removing pre-1.0 upgrade scripts
  • Fix: security issue allowing logged-in users to access the migration tool
  • Fix: changed support URL (to prevent 301 redirects)
  • Fix: a facet's "OR" mode wasn’t working with WooCommerce variable products
  • Fix: PHP error when $product doesn't exist (WooCommerce)
  • Updated to flatpickr 2.4.4
  • Updated translations


  • February 6, 2017
  • IMPORTANT: FacetWP will soon require PHP 5.3 or above
  • We now collect PHP version during update checks. This information will only be used to notify users whose servers need to be updated.
  • Improved: switched user selections to single-select (see Power Plants demo)
  • Improved: automatic number formatting for slider and number_range facet types
  • Improved: using WP's remove_accents() to replace diacritics
  • Improved: data sources can now be ordered by "weight"


  • January 24, 2017
  • Improved: custom build of WP-JS-Hooks to prevent third-party conflicts
  • Improved: replace diacritics for facet_value column
  • Improved: submit button for number range facets
  • Improved: slightly less specific CSS pager selector (Flatsome support)
  • Fix: ensure that $product is defined (WooCommerce)
  • Fix: set flatpickr disableMobile option to TRUE
  • Updated noUiSlider
  • Updated jQuery Autocomplete
  • Added Danish translations (props Rasmus Grønbech)


  • January 5, 2017
  • New: loading animation setting (spin, fade, none)
  • New: facetwp_index_all_products filter (to index out-of-stock WooCommerce products)
  • Improved: FWP_HTTP.get JS variable is now dynamic
  • Improved: don't change search orderby when an "orderby" URL parameter is detected
  • Improved: REST API responses now contain JS settings for facets (if available)
  • Fix: ACF5 "Undefined variable" PHP warning
  • Fix: REST API issue when posts_per_page = -1
  • Fix: Respect WooCommerce's "Used for Variations" checkbox
  • Fix: renamed "rotate" to "spin" for CSS animations
  • Updated to flatpickr 2.2.9


  • December 14, 2016
  • Fixed WooCommerce product variation support (see usage)
  • New: facetwp_indexer_post_facet_defaults filter
  • New: Czech translations
  • Improved: only index in-stock WooCommerce product / variations
  • Improved: use purchase ID instead of license key for support
  • Improved: lookup term name for product variation values
  • Fix: strip non-breaking spaces from user selections
  • Fix: force associative array for json_decode() in class-ajax.php
  • Fix: force array for $matches within class-facet.php
  • Updated to flatpickr 2.2.5
  • Updated to noUiSlider 9.1.0
  • Updated translations

  • November 29, 2016
  • Fix: reverted WooCommerce product variation support while we address some bugs and performance issues


  • November 22, 2016
  • Please re-index if using WooCommerce
  • Fix: incorrect results when filtering on variable products
  • Improved: Finnish translations
  • Updated to flatpickr 2.1.1


  • November 15, 2016
  • New: full support for WooCommerce variable products
  • New: WooCommerce data sources - Price, Sale Price, Regular Price, and Average Rating
  • Improved: support ACF5 date_picker fields
  • Improved: select first proximity result on "Enter" press
  • Improved: welcome screen cleanup
  • Improved: flatpickr l10n
  • Fix: hierarchy facet indentation issue
  • Updated flatpickr (latest nightly)
  • Updated translations
See older versions »

See Also