Product Finder
v1.1.26

Filters

You can set up product filters in this section.

Note

Clicking Add Filter several times will create a separate filter for each click. There is no limit to the number of filters you can add.

The filters are prioritized from top to bottom (in the backend and the vertical template) and from left to right (in the horizontal template). Any subsequent filter will only show the values available for products with the previous filter's value.

Example

Let us look at the tyre finder in the demo. There is a large selection of tyres with widths ranging from 115 to 750 and profiles ranging from 25 to 95. However, if you select a specific tyre width, e.g. 165, you will only be able to select tyre profiles of tyres with that particular width, e.g. 60, 65, 70 and 80. The same principle applies to any subsequent filter.

Filters are mandatory by default. Visitors will have to select a value before moving on to the next filter. You can make some of them optional, letting the visitors skip the selection. However, they will not be able to select the filter to the right (or the lower one) before the filter on the left (or the higher one) even if both of them are optional. Selecting the latter will clear any selection in the former.

There are two ways to synchronize the module's filters with your product information:

Note

You can use both filtering options in a single finder. Their priority will not change.

Adding Filters by Imported Values

You can import the list of relevant products and custom attributes with a CSV file and set up the filters according to the values in the CSV:

  1. Create a new finder. If you have already created one, click Select, then Edit in the grid's rightmost field.
  2. Add the filters you need by clicking Add Filters in the Filter section.
  3. Set them to Import in the Link To field.
  4. (Optional) Choose between dropdown and label filter display mode in the Display Mode field.
  5. (Optional) Change between ascending and descending sort orders in the Sort Mode field.
  6. (Optional) Make the filter optional by unchecking the box in the Required field.
  7. (Optional) Let customers select multiple values at once by checking the box in the Multiselect field.
  8. Click Save in the top right in order to update the filter list.
  9. Prepare a CSV with the relevant products.

Note

If you are unsure about the formatting, click Import Products in the Import section of the finder's settings page, then click Download Sample File. You can use the downloaded CSV as an example.
  1. Upload your CSV to the Import section.
  2. Click Save in the top right.
  3. Reindex the module with php -f bin/magento mirasvit:finder:reindex.

Adding Filters by Attributes

Alternatively, you can connect the filters to any global product attribute:

  1. Create a new finder. If you have already created one, click Select, then Edit in the grid's rightmost field.
  2. Add the filters you need to the Filter section.
  3. Set them to Attribute in the Link To field.
  4. Select the relevant attribute.

Note

The products you would like to filter must have this attribute.
  1. (Optional) Choose between dropdown and label filter display mode in the Display Mode field.
  2. (Optional) Change between ascending and descending sort order in the Sort Mode field.
  3. (Optional) Make the filter optional by unchecking the box in the Required field.
  4. (Optional) Let customers select multiple values at once by checking the box in the Multiselect field.
  5. Click Save in the top right.
  6. (Optional) Scroll down to the Import section and review the products that have the relevant attributes.
  7. Reindex the module with php -f bin/magento mirasvit:finder:reindex.

Available Options

Option Description
Filter Name Specifies the public filter name.

Note

If you are linking the filter to an imported CSV, its name is also used as a column name.
Option Description
Link To Determines whether the filter takes the information from an imported CSV or a product attribute.
Attribute Chooses which attribute the filter uses. You can select any of the global attributes. This field is displayed only if you link the filter to a product attribute.

Note

The relevant products have to be connected to the attribute.
Option Description
Display Mode Determines how a filter list will appear live. Select dropdown mode for longer filters and label mode for shorter ones.
Sort Mode Changes between ascending and descending sort orders.
Required Makes a filter mandatory.
Multiselect Lets a customer select several values at once.

Note

You have to reindex the module with php -f bin/magento mirasvit:finder:reindex in order to make the filter updates go live.