Filter Editor

The Filter Editor allows you to construct and modify a filter for a Wordpress Query by Target (colour, size, etc), Filter Type, Data Source, Data Type.

Open

Select filter block.
Open the Block Inspector.
Navigate to the Primary tab.
Find the Filter Editor.
Click to open the Filter Modal.

Query ID

The Query ID allows you to specify the identity of the Query you wish to filter.

You can find the ID of the Query you wish to filter by opening the Query Editor and locating the Query ID.

Find Query ID.
Input required Query ID.

Target

The Target uses the URL parameter that you have specified for the specific parameter you want to filter inside the query, for example colour, size, tags, categories.

Find Target.
Input required parameter (colour, size, tags, categories).

Filter Type

The Filter Type property allows you to select the type of filter you wish to apply to your query. These may be general, for example select, custom, button single, button multiple or specific, for example user selection, clear selection, range selection.

select: normal imput.

custom: for input blocks (currently).

button single: any type of block can be inserted inside, but there is a wrapper that triggers the filtering on user interaction.

button multiple: any type of blocks can be inserted inside, but there is a wrapper that triggers the filtering on user interaction.

user selection: adds a dynamic block and sets user selection.

clear selection: resets the specific query filtering back to the original query.

range selection: allows you to use a range slider for pricing etc or number of products.

Find Filter Type dropdown.
Select required filter type.

Data Source

The Data Source property allows you to choose the Source you wish to use, such as Static, Dynamic and User Input.

Find Data Source dropdown.
Select Static, Dynamic or User Input as required.

Count Items

The Count Items property allows you to count the number of items in your filtered selection.

Count Items can be toggled on or off.

Find Count Items.
Toggle on/off as required.

Show in Selection

When the “show in selection” property is toggled, it displays the items that the user has selected in the filter.

This option is typically used in conjunction with the “user selection” filter type.

Once the user selects a filter item, it will appear in their selection, which is displayed through the “show in selection” option.

In summary, the “show in selection” property allows the user to view the items they have selected in the filter, and it works alongside the “user selection” filter type to achieve this functionality.

Find Show in Selection.
Toggle as required.

Selection Prefix

The Selection Prefix property allows you to add a prefix to your filter, for example 'from...', 'only...' .

Find Selection Prefix.
Input required prefix.

Selection Suffix

The Selection Suffix property allows you to add a Suffix to your filter, for example '...tax free' .

Find Selection Suffix.
Input required Suffix.

Taxonomy

The Taxonomy property allows you to refine the parameters you select to determine your filter. This includes taxonomy, parent, include, exclude, order by, order, use field. You can also toggle whether it should be childless or not, and whether to hide empty or not.

The Taxonomy property can be selected when Dynamic is selected as the Data Source.

This will open a modal with a number of different parameters including: Taxonomy, Parent, Include, Exclude, Order by, Order, Use field, Childless, Hide Empty.

Data Source

Set Data Source to Dynamic in the dropdown.

Data Type

Set Data Type to Taxonomy.

Taxonomy(ies)

The Taxonomy parameter allows you flexibility over the taxonomy parameters you would like to include in your filter.

Find Taxonomy.
Select required parameter(s).

Parent

The Parent parameter allows you to select the parameters you want to select as parents.

Select

Find Parent.
Select required parameter(s).

Reset

Find Parent .
Click dot to reset.

Include

The Include parameter allows you to include selected taxonomies or terms.

Select

Find Include.
Select terms or taxonomies to include.

Reset

Find Include.
Click dot to reset.

Exclude

The Exclude parameter allows you to exclude selected taxonomies or terms.

Select

Find Exclude.
Select terms or taxonomies to exclude.

Reset

Find exclude.
Click dot to reset.

Order by

The Include parameter allows you to filter by a specific parameter. These include: Term Name, Term Slug, Term Group, Term ID, Term Description, Term Parent, Term Count, Meta Value, Numeric Meta Value, None.

Order by

Term Name: order by a specific name.

Term Slug: order by the part of the URL that explains the content.

Term Group: order by a set of terms that all share common requirements.

Term ID: order by the ID of a term in the terms table.

Term Description: order by the description of a given term.

Term Parent: order by the parent of the term.

Term Count: order by term count.

Meta Value: order by meta value.

Numeric Value: order by numeric value.

None

Select

Find Order By.
Select terms or taxonomies to include.

Reset

Find Order by.
Click dot to reset.

Order

The Order parameter allows you to select the order of your filter, Descending or Ascending.

Select

Find Order.
Select Descending or Ascending.

Use Field

The Use Field parameter allows you to add custom fields to your filter, including: Count, Description, Name, Term ID, Slug, Taxonomy, Term taxonomy ID.