Product Finder
v1.1.26

Display

This section stores the finder block's Widget, Layout Update XML and Template .phtml code snippets. You have to copy one of them and place it on any page in order for the finder to be displayed there.

Any of the three options can work, but they are intended for different editing purposes. They also vary in complexity and flexibility:

  • Widgets are generally the easiest to use: you can copy and paste the snippet directly to the editor.
  • Layout updates offer more control but they require a knowledge of XML and a direct access to the server.
  • Templates are the most flexible but they require the knowledge of HTML and PHP.

Useful Info

If you are unsure of which snippet to use, please review Magento documentation on widgets, layout updates, and templates or consult with your developer.

Note

You cannot edit the snippets. The block's visual design is determined by default PHTML templates in the module's installation folder and custom templates in the theme folder design/frontend/*/*/Mirasvit_Finder/templates/finder/.

Adding the Finder to the Page

Adding the snippet to the relevant page is sufficient for the finder to work properly if the page has a list of the products you need filtered. If you would like to place the finder on a different page, e.g. your homepage, you have to place a secondary finder on the page with the products, then add the secondary page's URL to the Destination URL field of the finder's general settings section.

If you would like to place the finder on a page that contains the relevant product list:

  1. Copy the code from the field of your choice in the Display section.
  2. Place it on the relevant page by pasting the widget to the editor, updating the layout or adding the template.
  3. Clean Magento cache.

If you would like to place it on a page without a product list:

  1. Copy the code from the field of your choice in the Display section.
  2. Place it on the relevant page by pasting the widget to the editor, updating the layout or adding the template.
  3. Specify the full or the relative page URL in the Destination URL field of the finder's general settings section.

Example

The relative page URL has to start with a slash after the domain extension. If the full URL is https://www.mystore.com/tyres.html, you only need to add /tyres.html.
  1. Copy the code from the field of your choice in the Display section.
  2. Place it on the the page where you would like to place the primary finder, e.g. the homepage, by pasting the widget to the editor, updating the layout or adding the template.
  3. Clean Magento cache.

Useful Info

You can add several finders to a single page.

Available Options

Snippet Description
Layout Update XML Copy this snippet if you would like to work with a layout update.
Widget Copy this snippet if you would like to work with a widget.
Template .phtml Copy this snippet if you would like to work with a PHTML file.