User Tools

Site Tools



For more details see the Product Parts Finder extension page.

Product Parts Finder

Troubleshooting checklist

  1. Make sure that the Finder block is displayed on the results page. The Finder will filter products only if it is placed on the page. If you don't want it to be displayed you can hide it with CSS, but you still need to place the block on the results page.
  2. Make sure that there are products to filter on the page which the Finder uses to display results. The Finder works as a product filter. If there are no products to filter from the Finder won't be able to do much.
  3. Try disabling Magento cache. If this helped, please try adding the Finder block through amfinder.xml file as described below.
  4. Hit the 'Save' button in the Finder one more time. Will prove useful if you've added records in the Finder first and only after that imported products in your Catalog. Hitting Save button will make the Finder to “bind” SKUs in the Finder with the SKUs in your Catalog.

How to's

How to add Finder block to a category

Open the following file:


There you can find commented part of example code:

Simply move the XML comment marked above like this:

This will add finder with ID=1 to a top of a category page. If you want to place here the finder with a different ID simply replace the 1 inside id tag with the ID of your finder. You can check finder IDs on the Parts Finder grid:

Save changes and flush Magento cache. Done!

How to add Finder block to other interesting places

In the same exact file as before:


Find the same exact code:

Move the comment marking and see the marked part of the code:

This is where we define the place for the Finder block on the page by changing the content.

Instructions below are for Magento RWD theme. If you use a custom theme then the reference names may be different.

Since we're using catalog_category_layered we should look for it in the theme files. In case it's RWD, here: /app/design/frontend/rwd/default/layout/catalog.xml

Here are our reference options: It looks like we can put the Finder block in the product list or in the left sidebar. The Sidebar is a good option, let's try it.

To add the Finder block to a sidebar we need to change the reference value to left_first. Also, we want to place the Finder before the navigation block. Since from the look of catalog.xml we know that navigation's block name is catalog.leftnav all we need to do is to mark that we want the Finder block to be placed before catalog.leftnav.

Here's how the code will look like with the changes applied above:

And here's the result of our work:

How to manage compatibility with Smartwave Ajaxcatalog

1. To manage compatibility with Smartwave Ajaxcatalog, find and edit a file: app/code/local/Smartwave/Ajaxcatalog/controllers/Catalog/CategoryController.php

2. After a line

$this->generateLayoutXml()->generateLayoutBlocks(); /*Generate new blocks*/

3. Add

/*compatibility with Amasty Finder*/
$html = $this->getLayout()->createBlock('cms/block')

Setting up Finder step by step

Using this guide you will learn how to set up very basic Finder instance quickly.

Step 1. Preparations

Let's say I'm selling car parts. I have a store with a wide variety of products and I want my customers to be able to find the part they need faster. For now, I want to start with my wheels collection.

Wheels in many cases are not interchangeable between different cars so it will be a good idea to filter the wheels collection to display only the wheel which will fit a particular car.

I can do this using the Finder. I will configure the Finder to filter Wheels category to display wheels for a selected car only.

Luckily, all my wheels are already in the same category so I can start configuring the Finder. But if in your store wheels are distributed among different categories, you should set the Anchor on a parent category.

Step 2. Creating Finder

Since I want to filter wheels I've considered three most important variables for my Finder: car make, car model and wheel diameter. So I'm going to create a Finder using these three variables as my dropdowns.

Once I hit the Add Finder button I will need to specify the number of dropdowns.

There is no way to change the number of dropdowns after the Finder is created. You can set the number of dropdowns only when creating a new Finder.

Second important setting there is Custom Destination URL. There you set the page to which the Finder block will redirect you after you hit the Find button. This setting can be changed at any time. Since I want to filter only the Wheels category I've set “wheels.html” there to redirect me to where my Wheels category is.

Hit Save to proceed.

Step 3. Filling up Finder

The easiest way to fill up Finder with products is to utilize a CSV import feature. For this, I will need to compile a CSV file with the data containing all the variations for Make, Model and Diameter and assign these variations to the products in my Magento Catalog.

Deciding on CSV format is very simple: count the number of dropdowns you have and add one more for a SKU column. In my case there are three dropdowns, adding one makes it four-column CSV.

This is how my ready-for-import CSV file looks like.

Open the Import tab, drag and drop the CSV and hit Import. After the import is done hit the Save button.

Step 4. Placing Finder block

To use finder on the home page or on the category without products, we do recommend to add the finder block to the root category.

Open the Finder you've just created and navigate to the Get Finder Code tab.

I will use the marked XML code in the Wheels' category layout update.

Then I open Catalog > Manage Categories, select the Wheels category, navigate to Custom Design tab and look for Custom Layout Update. This is where I'll insert the code I got from the Get Finder Code tab

Hit Save Category and it's done.

Step 5. Checking the result

When opening the Wheels category in the store front I can see the Finder block.

Since no selection is made all products from the category are displayed. But now I make a selection and hit Find.

After that, I can see only the products which SKUs I've assigned in a CSV file for Audi - A5 - 19″ selection.

And that is it, I have working Finder filter on my Wheels category now.

General extension settings

Settings are located in: System > Configuration > Amasty Extensions > Product Parts Finder

  • Use `universal` products - this setting enables and disables Universal products in one click.
  • Display `Find` button when - here you can set when to show the Find button, only when all dropdowns are selected or when only one dropdown is selected.
  • Show `universal` products last - when enabled, Universal products will be put in the end of filtered results.
  • Apply filter for current category only - useful when you have one Finder instance across the whole store, but you don't want to save the selection a customer made when he/she browses the entire catalog.
  • Custom Destination URL - sets the destination for Find button redirect. Can be set individually for each Finder instance.
  • Use Param in URL - controls whether to add or not to add Finder search parameters in the URL.
  • Start search when the value in the last dropdown is selected - when enabled, the Finder will start searching as soon as the value in the last dropdown is selected. Otherwise, the search will commence only after hitting the Find button.
  • Reset finder to - sets the destination of Reset button.
  • Clear other (previous) finders conditions - when enabled and you have more than one Finder instance on the page, only selection in the active instance will apply filtering, all other Finders will be reset.
  • Do Not Apply Finders on Site Search - when disabled, filtering will work on Catalog Search Results page too.
  • Redirect to product page when there is only one product in results - when enabled, it automatically redirects to the corresponding product page if there is only one product left after filtering.
  • Import history lifetime (days) - sets the lifetime of import error log.
  • Max rows per import - a batch size in lines which the import script will try to process at once.

New Finder settings

General settings

  • Title - name of the Finder instance.
  • Template - select from two available templates (horizontal, vertical) which determine how the Finder block will look on store pages.
It is set to horizontal responsive by default.
  • Custom Destination URL - sets the destination for the Find button redirect.

Dropdown settings. There is no limit to the number of dropdowns in a single Finder instance.

  • Name - name of the dropdown in the Finder block.
  • Sort - sort order for rows in dropdown
  • Range - if you enable this option and then import the data for this dropdown using ranges like “2006-2017” in CSV, the Finder will automatically create rows for each individual value in the range.


You can import records in finder in two formats: CSV and XLS (XLSX).

Deciding on CSV format is very simple: count the number of dropdowns you have and add one more for the SKU column. For example, if you have three dropdowns, adding one makes it four-column CSV. The same goes for XLS format.

There are two ways to import files into the Finder: manually from the Finder page or by uploading the file to the specific folder in the Magento directory. The latter is useful when you want to import a large file which your web-server might not allow to upload due to size restrictions.

To import files from the Folder in Magento you should put the file to the following directory: /magento_folder/media/amfinder/ftp_import/finder_id/

Please note that the finder_id part in the path should be replaced with the ID of the Finder you want to import the file into. After the file upload is done, open the Finder and hit Load Files Uploaded by FTP in the Import tab and the file you've uploaded will appear ready to import.

SKU bundling

If certain selection can output multiple different SKUs in the result, you can bundle these SKUs and import the whole thing in one line. Here's the example: Make1,Model1,Year1,“sku1,sku2,sku3,sku4,sku5,sku6” Make1,Model2,Year2,“sku3,sku4,sku5,sku6,sku7,sku8”

With these two lines Finder will generate twelve unique records, one for each Make-Model-Year-SKU combination.

Please note that bundling only works for SKUs

Generating Range

By enabling Range in dropdown settings you'll be able to automatically generate records for numeric data, like a list of years.

Now, when you import a CSV or XLS file you can simply define a range like “2001-2017” and it will generate 17 records automatically when the file is imported.

Here's how the CSV example may look like: Make1,Model1,“2001-2017”,SKU1

The example above will create 17 records in the Finder database which will differ only by the Year value.

Rate the user guide
 stars  from 1 votes (Details)
magento_1/product-parts-finder.txt · Last modified: 2017/12/12 11:59 by panamarenka