- Help Center Home
- Getting started
- Introducing FacetWP
- Installation and updates
- FAQ
- How it works
- What are facets?
- Facet types
- Built-in facet types
- Checkboxes
- Dropdown
- Radio
- fSelect
- Hierarchy
- Slider
- Search
- Autocomplete
- Date Range
- Number Range
- Star Rating
- Proximity
- Pager + load more
- Sort
- Reset
- User Selections
- Add-on facet types
- Map
- Hierarchy Select
- Range List
- Time Since
- A-Z Listing
- Color
- Custom facet types
- Custom 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
- Blocks
- Bricks
- Elementor
- Beaver Builder
- WP Recipe Maker and Tasty Recipes
- Relevanssi
- WPML and Polylang
- Meta Box
- Flatsome (theme)
- External integrations
- Breakdance
- Document Library Pro
- Listify (theme)
- Listable (theme)
- WPGraphQL
- Tips & tricks
- WordPress multi-site
- WP All Import
- WebToffee Import Export
- WP Job Manager
- Easy Digital Downloads
- EDD Reviews
- Intuitive Custom Post Order
- Custom Taxonomy Order
- Post Types Order
- Genesis framework
- WP External Links
- ElasticPress
- Yoast SEO
- All in One SEO (Pro)
- The Events Calendar Pro
- Google Analytics 4
- Image Optimization by Optimole
- Meow Lightbox
- Cookiebot
- Caching, hosting & security
- Object caching
- WP Rocket
- Cloudflare
- WP Engine
- Pressable
- New Relic
- WordPress REST API Authentication
- All-In-One Security (AIOS)
- Fast Velocity Minify
- Incompatibilities
- Incompatible plugins and themes
- Troubleshooting
- Troubleshooting guide
- Using the right query
- Common issues
- Common indexing issues
- Get support
- Developers
- Hooks reference
- Indexing hooks
- Querying hooks
- Output hooks
- facetwp_facet_display_value
- facetwp_facet_html
- facetwp_facet_render_args
- facetwp_facet_pager_link
- facetwp_facet_sort_options
- facetwp_template_html
- facetwp_shortcode_html
- facetwp_render_params
- facetwp_render_output
- facetwp_builder_item_value
- facetwp_builder_dynamic_tags
- facetwp_builder_dynamic_tag_value
- Advanced hooks
- Deprecated hooks
- JavaScript reference
- Shortcodes reference
- FacetWP REST API
- How FacetWP works
- The FacetWP URL
- FacetWP speed and limits
- Tutorials
- Code snippets
- Feedback
- What’s new
- Changelog
- News & announcements
Changelog
4.3.4
- November 21, 2024
- Improved lots of admin UI tweaks
- Improved improved import/export UI to allow "select all"
- Improved support WooCommerce stock status for ACF fields
- Fixed CodeMirror (code editor) initialization bug
- Fixed the temp table should get deleted when the index is purged
- Fixed only modify term_link URLs after the `woocommerce_shop_loop_header` action fires
- New added `total_unfiltered` property to the pager arguments (get unfiltered count)
- New `Enable automatic indexing` setting for those wanting to re-index manually
4.3.3
- August 20, 2024
- Fixed not all "product" post types belong to WooCommerce
- Fixed renamed the `facetwp_transients` wp_option to prevent 3rd party conflicts
4.3.2
- August 19, 2024
- New visual code editor (for listing templates)!
- Improved better update-check logic
- Improved ability to translate listing builder button labels
- Improved fSelect - support for 3+ nesting levels
- Improved added `facetwp_admin_settings_capability` hook to allow trusted editors to access FacetWP settings
- Improved better ACF handling for out-of-stock WooCommerce products
- Improved added admin warning icon when Debug Mode is enabled
- Fixed ACF nested repeater field indexing
- Fixed indexing progress bar not updating correctly when the auto-indexer is disabled
- Fixed set a global default facet orderby (count)
4.3.1
- June 20, 2024
- Improved styling for "locked" (i.e. code-based) facets and templates
- Improved Listing builder - hide the "Reset" facet mobile header
- Improved checkboxes - the "See more/less" links are translatable
- Fixed query detection should ignore queries running inside `get_the_excerpt` (i.e. some block-based templates)
- Fixed ACF - prevent deprecated notices for NULL date values
- Fixed `FWP.active_facet` not working in some browsers
4.3
- May 7, 2024
- New search facets - added "Enable relevance" UI setting
- Improved slider facets - only trigger a refresh when the slider handles actually move
- Improved debug mode - show all FacetWP-related hooks in use (even ones that return a boolean)
- Improved proximity facets - allow radius unit to be translatable
- Improved WooCommerce - better counts calculation for the `facetwp_woocommerce_support_categories_display` hook (WC category filtering)
- Updated dependencies
4.2.12
- March 12, 2024
- New pager facet - added "Scroll target" and "Scroll offset" UI settings to fine-tune pager scrolling
- Improved Date range - hide date range when no dates are available
- Improved Date range - add placeholder for disabled dates
- Improved better Multi-site debugging
- Improved misc styling tweaks and Slider facet styling for RTL support
- Improved better ACF checks to ensure that fields still exist
- Fixed change date defaults from 0 to empty string
- Fixed ensure that Pager facet's scroll offset is an integer
4.2.11
- January 22, 2024
- Fixed another Date Range typo (last one!)
4.2.10
- January 18, 2024
- Fixed typo causing Date Range facets to break
4.2.9
- January 17, 2024
- Improved Google maps - added sessionTokens to (hopefully) reduce the number of API calls
- Improved added "indexable cpts" to the debug info for easier troubleshooting
- Fixed some PHP8 deprecation notices
- Fixed hide the "user selections" area when empty
- Fixed query detection issue involving SearchWP
- Fixed added more reserved words for facet/listing names (automatically prefixed with underscore)
4.2.8
- December 1, 2023
- Fixed ACF "button_group" fields can now have labels too
- Fixed query detection issue with SearchWP active
4.2.7
- November 8, 2023
- Fixed mysqli notice for sites on WP 6.4+
- Fixed ctype_digit() notice for sites on PHP 8.1+
4.2.6
- October 31, 2023
- Improved short-circuit SearchWP when "s" is empty and a search facet is in use
- Improved a11y - added `aria-label` attribute for number range facets
- Fixed preloaded selections now appear in the "User Selections" box
- Fixed JS error upon reset click for non-existant facets
- Fixed support - replace ".php" in plugin names to prevent Cloudflare from going haywire
4.2.5
- September 7, 2023
- New added "ui_ghosts" setting (needed for range_list and future facets)
- Improved improved main query detection for when query args are in a slightly different order
4.2.4
- August 3, 2023
- Fixed issue preventing "_builtin" post types from indexing
4.2.3
- August 1, 2023
- Improved Star rating facet - added new UI color settings
- Improved enable "Strict query detection" by default for new installs
- Fixed admin UI - row counts not updating after re-indexing
- Fixed replaced default post_types from "any" to an actual array, for better WooCommerce compatibility
- Fixed Listing builder - WooCommerce source field inconsistencies
- Fixed WooCommerce - hid the `cf/_product_attributes` custom field, in favor of `cf/attribute_*`
4.2.2
- June 28, 2023
- New added `facetwp_scripts` WP action to manually add custom scripts
- New Proximity facet - added Placeholder field
- Fixed better detection / handling when `facetwp_pre_filtered_post_ids` or `facetwp_filtered_post_ids` hooks are in use
- Fixed Date range - PHP warning when no end date is set (props Oscar M.)
- Fixed WooCommerce - prevent issues for custom-translated stock statuses
- Fixed more PHP8 deprecation notices
4.2.1
- June 5, 2023
- Fixed `FWP()->is_filtered` should account for `facetwp_pre_filtered_post_ids` hook usage (fixes Advanced Woo Search)
4.2.0
- May 17, 2023
- Fixed admin - prevent caching of index table row counts
- Fixed admin - plugin install notice listed the wrong add-on name (e.g. "WPML" instead of "Multilingual")
- Fixed load more - prevent injecting results into static templates
- Fixed indexer - issue causing index values for a post to clear on save
- Improved support - include memory stats
- Improved support - include whether Debug Mode is turned on
4.1.9
- May 1, 2023
- Improved include `aria-label` for fSelect dropdowns
- Fixed admin UI loading issues on Safari
- Fixed possible undefined facet limits
4.1.8
- Apr 14, 2023
- Improved (re-)added notices when necessary integration add-ons are missing
- Improved admin UI - show the HTTP status code when an ajax request fails
- Improved migration script efficiency tweaks
- Fixed Hierarchy facet - changed "Count" setting to "Soft limit" for consistency
- Fixed Listing builder - switched button items back from HTML button to link elements
- Fixed "Show indexable post types" UI setting now takes the `facetwp_indexer_query_args` hook into account
4.1.7
- Mar 20, 2023
- Fixed PHP 8.2 "AllowDynamicProperties" deprecation notices (props Andrew M.)
4.1.6
- Mar 6, 2023
- Improved autocomplete - support `facetwp_facet_display_value` hook
- Improved listing builder - use a <form> for button links ("A" tags around buttons is invalid HTML)
4.1.5
- Feb 7, 2023
- New added `facetwp_proximity_store_latlng` hook
- Improved listing builder - shortcode support for the "No results text" box
- Improved WooCommerce - renamed "Include all products" UI setting to "Index out-of-stock products"
- Fixed ensure that `facetwp_get_distance` returns the closest distance when a post contains multiple locations
- Fixed SearchWP - prevent extra escaped quotes
- Fixed proximity - added the (now required) gmap `callback` argument
- Fixed placeholder text not appearing for autocomplete and search facets
4.1.4
- Jan 16, 2022
- New added "No results text" field to the listing builder
- Improved WP-CLI integration - use temp table, just like the UI version
- Fixed JSON response - ensure that "action" is a string (3rd party plugins sometimes break this standard)
- Updated build tools
4.1.3
- Dec 15, 2022
- Improved data source dropdown - add taxonomy names after the labels (helps distinguish taxonomies sharing the same label)
- Fixed listing builder - prevent double timezone offset
4.1.2
- Nov 10, 2022
- Fixed query builder - "EMPTY" and "NOT EMPTY" clauses
- Fixed ACF integration - prevent PHP8 error on invalid parent fields
- Fixed typo with "Strict query detection" setting, please re-save if using that setting
4.1.1
- Nov 4, 2022
- New added experimental "Strict query detection" UI setting
- Improved index table charset switched to utf8mb4 (for Emoji support)
- Improved date range - input labels can now be translated via facetwp_i18n
- Improved date range - a11y support
- Fixed fSelect lib - fire a change event, even when the value is empty
- Fixed a11y - added "aria-hidden" to hidden items to prevent ARIA warnings
- Fixed the `facetwp_template_use_archive` hook should support the "s" argument
- Fixed query builder - issue with the "EXISTS" / "NOT EXISTS" query filter clauses
4.1
- October 4, 2022
- Improved tweaked admin UI styling
- Improved slider - prefix / suffix fields are now translatable via `facetwp_i18n`
- Improved slider - better styling for the disabled state
- Improved fUtil lib now supports `.prepend`
- Fixed checkboxes - choices ordered incorrectly when "Preserve ghosts order" was combined with "Highest count" sort
- Fixed improved back-compat for the `get_filtered_post_ids` method
4.0.9
- Sept 15, 2022
- Fixed query builder - issue when filtering by custom field values
- Fixed listing builder - move `display: grid` CSS inline to prevent layout shifts
4.0.8
- Sept 7, 2022
- Improved revamped the "User selections" logic for number/date range facets
- Improved refined the sort logic, modified the new `facetwp_facet_sort_options` hook slightly
- Improved slider facet - display the UI even when only 1 available choice
- Improved customized noUiSlider.js lib to support `data-disabled` attribute (long story)
- Improved listing builder - added `post:title` dynamic tag
- Improved listing builder - renamed "Name" setting to "Unique name" and added tooltip
- Improved added label to range facet "Compare type" setting
- Improved fSelect lib - don't auto-focus the search box on touch devices
- Improved cache the row counts lookup
- Fixed prevent PHP notices when indexing proximity facets (props @mgratch)
- Fixed PHP notice caused by undefined `$exists_clause`
- Fixed fSelect "No results" text wasn't appearing
- Fixed reset facet didn't reset pager or sort
4.0.7
- August 25, 2022
- New `facetwp_facet_sort_options` hook for Sort facets (mimics behavior of the "old" sort feature)
- Improved display WP compatibility data for update checks
- Improved auto-ignore "nav_menu_item" and "wp_block" post types
- Improved number range - when input is focused, Enter key now triggers a refresh
- Fixed fComplete library - prefix the "hidden" class to prevent conflicts
- Fixed PHP error when using the API `fetch` method
4.0.6
- August 15, 2022
- Improved refactored sort logic
- Improved multisite update notification support
- Improved a11y - allow for translations of pager-related ARIA attributes
- Improved query builder - added `EMPTY` and `NOT EMPTY` clauses to the query filter UI
- Fixed admin UI styling tweaks (font sizes)
- Updated translations
4.0.5
- July 22, 2022
- Improved Query builder styling tweaks
- Improved value modifiers UI setting supports both HTML entities (e.g. & copy;) and symbols (e.g. ©)
- Fixed prevent scrollbar shift when using the actions popup (on the facet/template listing screens)
- Fixed layout builder - `date_format` and `input_format` settings should have a default value
- Fixed prevent manual indexing issues when the `facetwp_indexer_is_enabled` hook is false
- Updated VueJS, SortableJS, noUiSlider, and vue-select
4.0.4
- July 5, 2022
- Fixed prevent facets from being named `labels` to prevent issues
- Fixed ignore non-facet (i.e. custom) fSelects
4.0.3
- June 6, 2022
- New slider facets - added "Reset text" UI setting
- Improved admin - only show "Compare type" setting when "Other data source" is used
- Fixed formatting bug preventing sliders from loading properly
4.0.2
- May 31, 2022
- New `facetwp_builder_query_data` hook
- Improved proximity facets are now up to 40x faster (props And)
- Improved slider - support "Enclose" compare type
- Improved added `FWP.response` JS object containing ajax response data
- Improved Query builder - better styling of vue-select (dropdown) inputs
- Improved apply `facetwp_facet_display_value` hook to dropdown and fselect facets
- Fixed moved the `facetwp/set_options/slider` JS hook (allows for "range" to be overriden)
- Fixed admin - prevent 3rd party menus from moving the top nav bar
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
See also
Last updated: September 10, 2024