“Woocommerce Step Filter” Documentation by “troll_winner” v4.1.0

“Woocommerce Step Filter”

Table of Contents

  1. About
  2. Question settings
  3. Filter Settings
  4. Plugin Settings
  5. Templates Customizations

A) About - top

The main task of the plugin is creating different types of filters for your products.

It could help your customers to choose products consistently by answering questions and giving a description of each step.

Or just use it as a usual filter of products in a widget. Just place a shortcode wherever you want to output it.

Plugin image

B) Question Settings - top

Use the post content as a description of the question. The title of the post will be the step name.

First of all select one of view types. Possible types are:

After you can select a filter type setting. You can see not all of the variants are allowed. This depends on the selected view type. Possible types are:

Some of the combinations have Action on click setting. It allows making action on selecting the valueThere is possible to do:

Types with the only answer have Doesn't matter setting to not filter results by the question.

Types with a few possible answers have a Relation setting to define "OR" or "AND" relation between the selected answers.

There is a possibility to make the question invisible in the filter until of firing of some dependency. Use the Dependencies settings table for this. Select another question in the dropdown, then select its value in the next field and the comparison operator. Then this question will be visible only then this dependency will be met.

If you need to make more complex dependency then add more dependency rows in the table and define relations between them.

Attribute filtering

Filtering by an Attribute with Numeric view will work correct only with numeric values of the attribute.

Numeric question

Category filtering

With category type the question will have product categories as values.

You can define Category parent setting to get sub-categories by this category.

You can tick Include sub-categories setting to output all children.

Manual filtering

Manual filter type allows to create and configure each possible value you need in the question.

Click on the Add a value button to add a row with settings.

Each value could have the settings:

Manual question

In the value source modal you can select one of the values:

Manual category question

Meta filtering

The Meta key setting is required for this type of filtering. Place a string to it and the question will collect all of the possible values of this meta key of products and then use them as the question's values.

For the numeric views the min and the max meta values will be used for the limits, but they should have numeric type.

C) Filter Settings - top

Select created questions for using and change their order.

There are three modes allowed:

After tuning all settings, copy the shortcode into any page content to output the filter.

Filter basic settings

This is possible to Show results withing the filter on the last step without a redirect to another page. This tab could have any title.

If you tick the Show preliminary results count setting there will be a tooltip shown on each question value change.

The filter can check and Disable unmet values which will lead to zero results.

Results URL should have a URL to a shop or category page or just "#" symbol to stay on the same page (for the using as a widget).

Also, you can limit the Maximum products number results.

Filter results

This is possible to Scroll to top on the form update to let the user see the starting of the next question on submit. Also, there is the gap setting to not scroll the page to hight.

Navigation items might have one of the Nav action on click - just go to the next step or submit and go next.

Filter behavior

Select on of Nav view values to change navigation view.

Use the post content as a description of the first step. If you need this, check the Enable description tab setting. To change the step title, change the description tab title setting.

Filter view

You can Enable "Skip" button if you want to allow users to skip the questions.

Lower you can find all controls labels to change them.

Filter controls

D) Settings - top

If you active theme is based on "Bootstrap" framework, then the filter will styled the same as your active theme. Otherwise, check Include full styles file option to make the filter looks correct.

If for some reasons you need to disable some of plugin's scripts, change Scripts including type setting to "Multiple files" and de-select them in the list lower.

Settings admin page

E) Templates Customization - top

If you want to customize some views of the plugin and don't lose these changes while updating the plugin create "woocommerce-step-filter" folder in your active theme directory and copy into it files from the plugin's "views" directory saving the sub-directory hierarchy.

The plugin trying to get a view from the theme at first, and if it doesn't find this view, it gets the view from itself directory.

troll_winner

Go To Table of Contents