fSelect

Overview

The fSelect facet type generates a dropdown combo-box. It supports multi-select, and also includes a search box to narrow choices.

facet-fselect

Available Options

Name Description
Data source Where the values live (taxonomy, custom field, post attribute)
Default label Set the label for the first dropdown option (default: “Any”)
Parent term If Data Source is a hierarchical taxonomy and you want to display only child terms, enter the parent term’s ID.
Value modifiers Enter a list of values (one per line) to include or exclude from the facet’s choices
Hierarchical Whether to indent child terms
Multi-select? If “Yes”, this facet type will accept multiple selections, and will display a checkbox-style UI.
Show ghosts Show choices that would return zero results?
Preserve ghost order Keep ghost choices in the same order (mixed with valid choices)?
Facet logic Assume a facet with the choices “Apple”, “Banana”, and “Pear”.

  • AND (match all) – if selecting “Apple”, the choices “Banana” and “Pear” will disappear.
  • OR (match any) – if selecting “Apple”, the choices “Banana” and “Pear” will remain. If you select both “Apple” and “Banana”, results matching EITHER will remain.
Sort by Sort facet choices by Facet Count, Display Value, Raw Value, or Term Order
Count The number of options to display

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 content, then it will never appear.

Hide Counts

To hide counts from all dropdowns, add the following to your theme’s functions.php:

add_filter( 'facetwp_facet_dropdown_show_counts', '__return_false' );

To hide counts from specific facets, use this instead:

add_filter( 'facetwp_facet_dropdown_show_counts', function( $return, $params ) {
    if ( 'your_facet_name' == $params['facet']['name'] ) {
        $return = false;
    }
    return $return;
}, 10, 2 );

Hide the Search Box

add_filter( 'facetwp_render_output', function( $output ) {
    $output['settings']['YOUR_FACET_NAME']['showSearch'] = false;
    return $output;
});