// Changelog


  • February 20, 2018
  • Improved: slider facets are now supported for FWP.settings.num_choices
  • Improved: re-initialize autocomplete facets only when needed
  • Improved: store unfiltered IDs unconditionally
  • Fix: user selections feature was sometimes resetting everything
  • Fix: issue with "Show ghosts" setting
  • Fix: autocomplete facets not returning results (or triggering a 500 error)
  • Fix: preload_vars not being passed on pageload
  • Updated flatpickr (again)


  • February 9, 2018
  • Important: please update the Map Facet add-on
  • New: "Show ghosts" setting for fSelect facets
  • Improved: prevent unnecessary "Show ghosts" query when results are unfiltered
  • Improved: added "facet_value" parameter to FWP.reset()
  • Improved: support for multiple proximity facets on a page
  • Improved: JS cleanup and optimizations
  • Fix: sanitize term slug within edited_term hook (for Hebrew)
  • Fix: FWP.reset() issue with certain facet types (slider, map facet)
  • Fix: fSelects in "OR" mode lose selections when filtered then reverted
  • Added Catalan translations (props Jonathan Pasquier)
  • Updated noUiSlider, jQuery-autocomplete, flatpickr
  • Updated translations


  • January 24, 2018
  • Important: please update the following add-ons: [Alpha, Map Facet, Time Since]
  • New: facetwp/ajax_settings JS hook (to tweak ajax settings)
  • New: facetwp/set_options/autocomplete JS hook (to tweak autocomplete requests)
  • Improved: automatic formatting of number range inputs
  • Fix: search facet auto-refresh issue
  • Fix: issue with Listable + fSelect facets
  • Fix: Norwegian translation


  • January 4, 2018
  • New: proximity facets now support a radius slider (HTML5 range input)
  • New: search facets now have an "Auto refresh" setting
  • Improved: modified the facetwp_index table structure for greater efficiency
  • Improved: smarter autocomplete search (show only relevant choices)
  • Improved: (hierarhical checkboxes) automatically expand children if a parent choice is selected
  • Improved: facet type registration has moved to FWP()->helper->get_facet_types()
  • Improved: use wp_send_json when possible (props @mgratch)
  • Improved: freeze fSelect choices during a refresh
  • Fix: fSelect choices incorrect when in "AND" mode
  • Fix: slider rendered incorrectly when using back/forward buttons
  • Fix: hide the "Soft limit" setting for hierarchical checkboxes
  • Updated to flatpickr v4
  • Updated translations

  • December 11, 2017
  • New: the "Re-index" button will glow when re-indexing is needed
  • New: added "Copy shortcode" button
  • Improved: minified main front scripts
  • Improved: fSelect styling (wrap long choice labels)
  • Tweak: switched SWP_Query argument from "load_posts" to "fields"


  • November 20, 2017
  • New: support for ACF5 Group fields
  • Fix: issue with commas within search / autocomplete facets
  • Fix: PHP notice for hierarchy facets
  • Fix: output the "fwp-loop" tag only if wp_head() has run (props Justin @ Beaver Builder)
  • Fix: ignore queries with "suppress_filters" = true
  • Updated translations


  • November 1, 2017
  • Fix: SQL issue caused by WP 4.8.3
  • Fix: Unable to open fSelects on mobile


  • October 30, 2017
  • New: added facetwp_api_output hook
  • New: added facetwp/set_options/fselect JS hook
  • Improved: one less query for slider facets
  • Improved: Query Builder styling tweaks
  • Fix: fSelect iPhone fix
  • Fix: ignore feeds when doing query auto-detection
  • Fix: PHP notice for the facetwp/v1/fetch API endpoint


  • October 4, 2017
  • Improved: cache duplicate queries for even faster loading
  • Fix: FWP.settings.debug was undefined in some scenarios
  • Fix: issue with browser bfcache (back/forward cache)
  • Fix: incorrect counts for some preloaded facets


  • September 28, 2017
  • New: facets now load instantly on pageload (because magic)
  • New: facet choices can now be sorted by Term Order
  • New: facetwp_preload_url_vars hook for better facet pre-select
  • New: WooCommerce "Product Type" data source
  • New: facet base class (FacetWP_Facet) with a get_orderby() method
  • Improved: fail gracefully if an invalid post ID is passed to the indexer
  • Improved: fSelect counts are now within a .facetwp-counter span
  • Improved: extra javascript error handling
  • Changed: FacetWP_Facet class renamed to FacetWP_Renderer


  • September 12, 2017
  • Improved: reset individual facets using FWP.reset('facet_name')
  • Improved: FWP.reset() also clears the sort box
  • Improved: support FACETWP_LICENSE_KEY constant
  • Improved: logic tweak for date range facets with 2 sources + "Exact" mode


  • August 23, 2017
  • Fix: revert facet auto-detect on taxonomy archives (due to some edge cases)
  • Fix: is_main_query detection should ignore /wp-admin/ queries
  • Fix: permalink issue with "_" URL prefix


  • August 18, 2017
  • New: rebuilt admin UI
  • New: support for custom URL prefixes
  • New: added fSelect "Hierarchical" setting
  • Improved: hookable admin settings screen
  • Improved: fSelect auto-refresh on each selection (when multi-select)
  • Improved: cache update checks (transients stink)
  • Improved: on taxonomy archive pages, taxonomy facets should show only children of the current term
  • Improved: support for "Other data source" setting with ACF date_picker fields
  • Improved: support more date range scenarios (e.g. 2 data sources using "Exact" display)
  • Improved: proximity "Clear location" setting is now translatable
  • Improved: "No results found" text is now translatable
  • Fix: proximity issue preventing exact matches from showing
  • Fix: incorrect argument order with facetwp/save/{facet_type} JS hook
  • Fix: fSelect IE11 selection issue
  • Updated noUiSlider
  • Updated flatpickr
  • Updated translations
See older versions ยป

See Also