FacetWP Range List Addon v0.9.2

A Range List facet with a “Checkboxes” UI type. This add-on adds a Range List facet type that lets you create a list of filterable number ranges. It can be used to filter ranges of prices, weights, square meters, or any other numerical value. The facet can be displayed in several UI types like checkboxes, radio buttons, a dropdown, or as an fSelect facet type.

Available options Name Description Data source Where the value lives (taxonomy, custom field, post attribute). The facet expects a numeric value. Ranges To set up this facet type, create a number of ranges with min and max values. Each range will correspond to a facet choice. See the explanation below. UI type The UI type of this facet: Checkboxes – Displays as a Checkboxes facet, without an “Any” choice.

Radio – Displays as a Radio facet, with an “Any” choice (if not empty). Dropdown – Displays as a Dropdown facet, with an “Any” choice. fSelect – Displays as a single-select or multi-select fSelect facet, with an “Any” choice. Note: if you select the fSelect UI type, you can also apply all customizations described on the fSelect facet page, like setting a custom fixed label, changing the search box text, changing the “No results found” text, and hiding the search box.

Default label This setting is only visible for UI types “Radio”, “Dropdown”, and “fSelect”. It sets the text of the “Any” choice: For the “Radio” UI type it enables an “Any” choice above the other radio buttons and sets its text. Leave it blank to remove the “Any” option entirely. It is also possible to hide the “Any” option if it is the only option left, or if there are no other selections.

For the “Dropdown” UI type it sets the text of the default first “Any” choice. For the “fSelect” UI type it sets the text of the default first “Any” dropdown choice. To set a fixed “selected” label, see this explanation on the fSelect facet page. Note: this label is translatable with the facetwp_i18n hook. Multi-select This setting is only visible for UI type “fSelect”.

If enabled, the facet will accept multiple selections, and will display a checkbox-style UI. Facet logic This setting is only visible for UI types “Checkboxes” and “fSelect”. For the “fSelect” UI type it is only visible if Multi-select is enabled. This setting determines the logic used between choices within the facet. Assume a facet with the choices “Apple”, “Banana”, and “Pear”: AND (match all) – if you select “Apple”, the choices “Banana” and “Pear” will disappear (or become ghosts if “Show ghosts” is enabled).

Only results matching “Apple” will remain. OR (match any) – if you select “Apple”, the choices “Banana” and “Pear” will remain. If you select both “Apple” and “Banana”, results matching either will remain. Show ghosts Show choices that would return zero results? If enabled, facet choices (created with the facet’s “Ranges” setting) that would return zero results are still shown, but dimmed and not clickable.

If disabled, facet choices that have no associated posts will be hidden. See the explanation below. Create ranges To set up this facet type, use the Ranges setting to create a number of ranges with min and max values. Each range will correspond to a facet choice. For each choice, enter a custom label: How to set up a Range List facet. Range List facet example output.

The final output of the above settings will look like the image on the right. As shown in the above gif, if you leave the “Min” value blank in a row, the “Min” value of that field is set to the “Max” value of the previous row. Leaving “Min” blank on the first row sets that min value to 0. And leaving the “Max” value blank in the last row will be interpreted as there being no max value, meaning “and up”.

Starting with version 0.9 of the add-on, you can also use 0 (or any other number value) in the “Min” fields, to create overlapping ranges. Note that “Max” values are interpreted as “up to and including” and “Min” values as “from and including”. So in the above example, a post with a value of 10000 will be included in both the first and the second facet choice.

Using decimals in Range List ranges. Starting with version 0.9.1 of the add-on, the Ranges setting also accepts and properly works with decimal numbers (floats) for the Min/Max range values. When using decimals, use dots, not commas. Don’t use thousands separators, spaces or other characters. Here is a video walkthrough of setting up a Range List facet: What are ghosts?

Ghosts are facet choices that do appear in the unfiltered results, but disappear after being filtered out. If a facet choice has no associated posts, then it will never appear. When “Show ghosts” is enabled, after filtering, facet choices that would return zero results are still shown, but dimmed and not clickable. Note that if the UI type is set to “fSelect”, with Multi-select enabled, and the “Facet logic” set to “OR (match any)”, there will never be ghosts caused by selections made within the facet itself.

If the Facet logic setting is set to “AND (match all)”, the facet will show ghosts caused by selections made within the facet itself. In both situations, the facet will show ghosts caused by selections made in other facets. With “Show ghost” enabled, you can also (intentionally) create ranges that have zero results before filtering, which is slightly different from the behaviour of other facet types’ ghosts, which only show up after filtering.

These ghosts will always appear, also if the “Facet logic” setting is set to “OR (match any)”. Hide or customize the counts Hide counts How to hide the counts for the Range List facet, depends on the UI type setting: UI type set to “Checkboxes” or “Radio” Add the following CSS into your theme’s style.css. Be aware that this also hides the counts for all facets of type Checkboxes, Radio, Hierarchy, and Time Since (with UI type set to “Radio).

How to use custom CSS? CSS code can be placed in your (child) theme's style.css file. Alternatively, you can add it manually between