To start using the annasta Woocommerce Product Filters plugin, you have to install and activate it. For instructions on how to install a WordPress plugin please refer to the WordPress official Plugin Management Guide.
This plugin needs the Woocommerce plugin to function properly.
Once you’ve successfully installed and activated the plugin, navigate to the “annasta Filters” tab of the Woocommerce > Settings menu page. You can go directly to the plugin settings from the annasta Filters section of the WordPress sidebar menu, or by clicking the Settings link under the plugin name of the Installed Plugins admin page (see image 1).
In order to setup the filters for your Woocommerce shop you will need to edit the default filters preset that has been created for you during the plugin installation. Open the preset options by clicking on the Edit preset (cog) button of the Default Plugin.
Help tips can assist you in editing the preset options. To read a tip, bring your mouse pointer to (or tap on) the black circle with the question mark near the option in question.
Setting up the display pages
Our plugin offers you the flexibility of defining site pages on which the filters are going to be displayed. This way you can place it into a universal section of your site (a sidebar, or a header), but still control that it displays only on the pages that you need (shop pages, pages with Woocommerce product shortcodes etc), but not during Checkout, or on a User Account page. Furthermore, if you need custom filter sets for different pages of your shop, you will be able to achieve it by associating different presets with different pages (multiple presets are available in the premium version of the plugin).
Please keep in mind that whenever your preset is displayed on a page that is not a shop page, or a Woocommerce [products] shortcode page that you registered for filtering, the filters will act as simple links to the corresponding filtered results of the shop. For example, if you have a product colors filter displaying on a Shopping Cart page, clicking on “red” will open your shop page with products filtered by the selected color (in this case, red).
You will specify the display pages for your preset in the Display on section of the preset options page. By default your filters are set to display on Shop pages. You can change that at any time by adding and removing page associations. To delete an association click on the Remove page association button next to it. Add another page by selecting it from the dropdown and clicking on the Add page association (+) button.
You may notice that with preset set to display on “All pages” the Add page association (+) option becomes unavailable. In a case like that, to setup your filters to display only on the selected pages please first remove the “All pages” association.
Managing your filters
All the available filters are listed in the select box under the Preset Filters section title. You can add, delete and re-add your filters at any moment. Filter open/ collapse buttons are provided for your convenience in the right corner of the filter title bar, as well as at the bottom of an opened filter. Use the drag-and-drop technique by grabbing the filter by its position label (in the left corner of the title bar) to change the filter’s position in the preset.
When you are ready to add filters to your preset, select the filter that you would like to add in the select box under the title of the Preset Filters section. Click the Add filter (+) button to add the selected filter to your preset.
Editing filter options
To illustrate the filter options setup, let’s assume that we added a Product categories filter (see image 6).
One of the first things that you have to decide when creating a filter is whether you want it to be a single-select, or a multi-select filter. In a single-select filter only one item can be selected at a time, whereas in a multi-select filter, you and the visitors of your shop will be able to select multiple filter terms.
To explain this on our product categories filter example, if you choose the single item selection Filter type, it will be EITHER the Tshirts category, OR the Hoodies category that will be getting selected by clicking on them at any given time, while a multi-select filter type will allow the selection of BOTH Tshirts AND Hoodies (as well as Accessories etc) categories at the same time.
Select Multiple items selection for the multi-select filters, or Single item selection for the single-select filters in the Filter type field.
The Products Price and Products Rating filters will have their Filter type option limited to the Range selection type. Please refer to the corresponding article of the plugin documentation for the detailed description of a range filter setup.
After having decided on the filter type, you can move on to choose the Filter style. Here you have a variety of options to choose from, ranging from the standard browser radio and check-box controls, labels, tags, and color boxes, to setting Font Awesome Free icons to display as filter icons in front of your filters.
Additionally, you can set the filter items to display in a row (which can be used for color boxes and tags), display a filter items search box on top of the filters, and limit the height of the filters list container (in this case a vertical scrollbar will appear if the list of filter items spreads further than the specified height, to allow your visitors to scroll through the list. You can also enable the “pretty” scrollbars for such cases in the Styles section of the annasta Filters settings page) .
Another useful feature of the annasta Woocommerce Product Filters plugin is the Excluded terms option. Use it to remove the unneeded terms (such as the “Uncategorized” product category) from the list of your filter items.
Check the corresponding option if you wish to display product counts for the current filter.
Don’t forget to save the preset settings each time you make changes by pushing the Save button at the bottom of the page.
Inserting preset into the site
When your preset is ready for display, you need to place it into the chosen section of your site. There are 2 options available to you to accomplish this task: via the annasta Woocommerce Product Filters widget, or with the help of the [annasta_filters preset_id=1] shortcode.
Widget is the easiest and quickest way to place your filters into the site, so let’s see how to do that. Go to the Appearence > Widgets screen of your WordPress admin and find the annasta Filters widget in the list of the available widgets.
Drag and drop the widget into the chosen section of your site and make sure that your filters preset is selected in the annasta Filters Preset field of the widget options. Click Save when you are finished, and open a page of your site to make sure that the filters started displaying.
We hope that this tutorial was helpful in guiding you through the first steps of your Woocommerce shop filters’ setup. For further information about all the variety of functions and options of our plugin please consult the plugin documentation.