Skip to main content

Product finder configurations

This section describes the configuration options for product finders. They are located in Catalog -> Product Finder -> Add New/Edit Finder.

General​

  • Enable finder: enables/disables the finder.
  • Name: defines the internal name of the finder (not visible to customers).
  • Code: sets unique identifier for this finder. This code is used in the URL as a parameter for finder ID and used to embed the finder into CMS pages, widgets, or templates. Reflected in the URL if Friendly URLs configuration is enabled in module settings.
  • Destination URL: specifies the full (https://www.mystore.com/tyres.html) or relative (/tyres.html) path to the finder's custom results page. If the destination URL is not specified, the finder will be redirected to the default results page: /finder/index.
    tip

    Use this configuration if you place the finder on a page without the relevant products (e.g., homepage).

    note

    Destination URL only changes the finder's results page. It does not determine the finder block's location. To place the finder on a specific page, you have to add its code snippet from the Display section. The results page must contain the relevant product list and a secondary finder block in order to work properly.

Appearance​

The finder’s visual design can be customized in this section. Most visual aspects, such as the background and filter layout, are determined by a PHTML template, so maximum creative flexibility is provided.

  • Template: selects a visual design template for the finder block. The extension provides two basic templates - Horizontal and Vertical.
    tip

    You can use a different design template. Create a new .phtml file and upload it to design/frontend/*/*/Mirasvit_Finder/templates/finder/.

    note

    Basic templates are situated in either of the two locations, depending on the installation type:
    Composer: vendor/mirasvit/module-finder/src/Finder/view/frontend/templates/finder/
    Manual: app/code/Mirasvit/Finder/view/frontend/templates/finder/

  • Block title: sets the public title of the finder block (visible to customers).
  • Block description: sets the public description of the finder block (visible to customers).

Applying conditions​

This section contains the condition builder, a feature that allows to adjust (limit) the scope of shown products when finder with matching filters is applied.

note

Conditions apply only to the filters linked to attribute.

Filters​

This section contains filter configurations. They are called by Add Filter button.

  • Filter name: specifies the public name of the filter (e.g., Make, Model, Year).
  • Link to: determines the data source for the filter. The data source can be imported, or it can be a product attribute.
  • Attribute: selects which product attribute the filter uses. Displayed if Link To is set to Attribute.
  • Display mode: determines how the filter options are displayed. Dropdown or Label options are available.
  • Sort mode: sets the sorting order for filter options. The following options are available: non-sorted, A-Z, Z-A, 0-9, 9-0.
  • Required: makes the filter mandatory for selection.
  • Multiselect: allows customers to select multiple values in the filter.
note

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.

Import​

This section contains configurations of Import menu. This menu opened by Import Products button.

  • Download sample file: downloads a sample CSV file for formatting your own product list.
  • Upload: uploads a new CSV file with filter values and product relations.
  • Mode: defines the import mode:
    • Overwrite existing data: replaces the existing information with data from the new file.
    • Update existing data options are available: adds new data but keeps the existing information intact.

Display​

This section stores the finder block's Widget, Layout update XML and Template .phtml code snippets.

  • Layout update XML: provides a code snippet for adding the finder via layout update XML.
  • Widget: provides a code snippet for adding the finder as a widget.
  • Template .phtml: provides a code snippet for adding the finder via a .phtml template file.
note

By design, you cannot edit the code in the Display section in the finder's settings. However, the code is there so you can copy it and place it on any page.