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
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.
Add
Find Use Field.
Select fields to add (Count, Description, Name, Term ID, Slug, Taxonomy, Term taxonomy ID).
Childless
The Use Field parameter allows you to return a taxonomy that has no children. It can be toggled on or off.
Toggle
Find Childless.
Toggle as required.
Hide Empty
The Hide Empty parameter allows you to hide empty categories. It can be toggled on or off.
Toggle
Find Hide Empty.
Toggle as required.
Last updated