Combination Facets Documentation
Combination facets are a special kind of facet where there are multiple facet values which are grouped together. The most common kind of combination facet is year, make and model. In order for the facet to be useful, all three must be selected. Each product in your store then has an assigned list of year/make/models it applies to.
The combination facets functionality built in to Miva gives you a way to create any number of combination facet groups and define the facets themselves which are part of the group so you are not limited to just year, make and model. We also provide a front end user interface component so that customers can easily find the products they are looking for by choosing the year, make, model that applies to them. The menu automatically updates so that once you select year, the make list will dynamically populate with just the makes which apply to that year.
Installation & Setup
Combination facets requires that your product lists pages (Search, Category, Product List) also have facets enabled. Please see this guide on how to setup Facets in Miva. (https://docs.miva.com/how-to-guides/facets-category-search-filtering)
To enable combination facets, assign it to your store under Utilities. Here you can create a new facet which itself will contain multiple facet fields. The combination facet is the grouping for fields. The fields are the individual things which you link together and facet against. For example year, make and model. However you can create any number of fields you wish. Other examples include:
Length, Width, Height
Brand, Size, Material
Adding Combination Facets Values to Products
Once you’ve configured your combination facet fields, you can now add values associated with each of those fields at the product level. There are two ways to do this:
- Via the admin
- Via Import
Via the Admin
When editing any product, there will now be a new tab with the name you gave to the Combination Facet earlier. (This works similar to how custom field groups works.)
Once you navigate to this new tab, you’ll see the fields you created are the columns to the list and you can add new year, make and model combinations which fit this product.
Importing Facet Values
If you have hundreds or thousands of facet values to add, there is a easy way to import these values into Miva.
These values get imported as a custom product field in the following format:
Some things to keep in mind: The order of the individual values matters. If you setup your combination with Year, Make, Model you will need to make sure the the data matches that format. Each field value is separated with the “>” symbol and groups of values are separated with the pipe “|” delimiter.
Upon import, Miva will automatically parse out the data format into their individual values and it will appear in the admin just like the example above.
The header row used to import these values will depend on the name given to the combination facet. It will always be the name used with spaces replaced with underscores.
Our name in this case was “Vehicle Fitment” so the header row would be “VEHICLE_FITMENT.”