• Documentation

    Filters Preset Settings

    Preset name

    The Preset name option is for internal use only and its value will not show anywhere on the pages of your site. Use it at your convenience to describe your preset.

    Preset title

    The Preset title is the title that will show on top of all the filters on the pages of your site. You can set it to “Filters”, “Product Filters”, “Filter Products” etc. If you don’t want a title bar, leave this field blank.

    Preset description

    Use this option to display custom text under the preset title. Leave blank if not needed.

    Active filter badges

    Check the Active filter badges option if you wish to show active filters’ collector on top of filters. Keep in mind that this will show active badges for all the enabled filters on the current page (if you have more than one presets on the page, it will show filters that are activated in all the presets).

    You can also enable active badges in filter options for each filter individually.

    Reset all button

    Reset all button option controls the display of the Clear all filters button: choose to disable it, or select the button location.

    Reset button label

    Customize the label of the button that clears all the filters.

    Filter button label

    Customize the label on the Filter button.

    Filtering style

    Choose the filter behavior that suits your needs with the help of the Filtering style option:

    • Ajax with instant submission will act as classic AJAX filters and reload the Woocommerce products list part of the page immediately after a click on any of the filters
    • Ajax with button submission will collect the selected filters and wait for the push of the Filter button to apply them to the products list part of the page
    • URL filters will act as simple links and load the page with the selected filter applied immediately upon the click on a filter. Since they are essentially styled as URL links, you may sometimes find them useful for the SEO or other purposes of your shop.
    • Form with button submission will make your preset act as a classical html form element, with filters’ choices submitted with a push of a submit (“Filter”) button
    • Step-by-step filters style will make a products finder application out of the filters of the current preset. This style is provided with additional settings, to help you set up a products finder page that suits the needs of your shop. You can place such filters on your home page, or any other page of your site, and if needed, redirect to the filtered results on the shop, taxonomy archive pages, or even a page with the Woocommerce [products] shortcode.

    In AJAX filters, annasta Filters adjusts the URL part of the page each time an Ajax product filter is applied, which facilitates page reloads, and enables the Back and Forward history moves in client’s browser when using your Woocommerce ajax filters.

    Step by step filters settings

    There are many scenarios in which you may wish to use a step-by-step styled preset, such as creating a product finder page, a need to redirect the user to a correct gender / brand / model / age page for further filtering, and so on. annasta Filters gives you a wide choice of options to satisfy most of the common demands.

    The step by step filter style imposes limitations on certain options and functionality:

    When combining your step-by-steps with other presets on the same page, please pay attention to those presets not having the same filters that are present in the step-by-step.

    Please remember: the On Sale and Featured Products filters are not supported by the the step-by-step style, and will break the functioning of your products finder.

    Be careful when placing the step-by-step presets on taxonomy archive pages: such preset can NOT contain the same taxonomy filter (the same taxonomy filters are not displayed on taxonomy archive pages, which will prevent the the step-by-step from functioning properly).

    Another step-by-step presets limitation is the inability to use the reset all filters setting with the filters of such presets.

    Step by step style

    In a step by step preset, each next filter appears after the previous is selected. Choose between displaying only the current filter at any given time, or adding each next filter to already selected.

    Filters submission

    Select the submission style for your product finder filters among the following 4 options:

    • Update products list with each filter application: this may be a desired behavior on pages where you wish to apply filter results right away, but keep in mind that if your preset is programmed to redirect to the filtered results, this option will force the redirect with the very first filter’s selection!
    • Update products list when the last filter is applied: this will submit (or redirect) the results only after one of the options of the last filter is selected
    • Filter button displayed for all the steps: will have the Filter button displayed during all the steps, which will essentially allow the user to break out of the step-by-step at any moment.
    • Filter button displayed after the last filter selection: will force the user to complete the step-by-step till the last filter by displaying the Filter button only after all the filters had been selected.

    Next button

    By default the transitions from one filter to the next happen automatically when at least one filter option gets selected. This may restrict the usage of multi-select filters in some step-by-step styles (one filter at a time displays, redirects). Use the Next button to enable the multi-selection in cases like that, or whenever you want to move from one filter to the next by a push of a button.

    Back button

    Display the Back button to enable moves to the previous steps of the products finder. This can be particularly useful in step-by-steps styled to show one filter at a time. Please, keep in mind that moving the steps back will sometimes reset the already selected further filters.

    Redirect URL

    Use this option when you wish to redirect the filtered results to a page, different from the page on which the preset is displayed.

    Whenever your step-by-step preset is placed on a non-filterable page (not a shop / some products taxonomy archive / page with Woocommerce [products] shortcode registered for filtering), the filtered results will be automatically redirected to the shop page, so if that is the desired behavior, you can leave this field blank.

    When your preset is displayed on a shop, products attribute taxonomy archive, or Woocommerce [products] shortcode page registered for filtering, the step by step will by default (with the Redirect URL field blank) filter the current page.

    In a special case of redirecting the filtered result to a Woocommerce product taxonomy archive page (archive pages for product category / brand / tag with the links of type https://yoursite.com/product-category/fruit, https://yoursite.com/brand/somebrand etc), please add the archive-filter=1 parameter to the URL link, so that it would look something like https://yoursite.com/brand/somebrand/?archive-filter=1 (or https://yoursite.com/?brand=somebrand&archive-filter=1 when the permalinks aren’t enabled).

    Display on

    To provide control over the pages of your site that will display your filters, the Display on section holds the list of pages associated with each filters preset. Adjust this list to meet the needs of your shop.

    When you set the Display on option to “All pages”, the Add page association select box and button become unavailable. To change the Display on setting with “All pages” selected, simply remove the “All pages” association for the Add association options to re-appear.

    Preset 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.

    Open and collapse filter options with the help of the Show/ hide filter options button located in the right corner of the filter title bar. You will also find a filter collapse button at the bottom of each 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.

    Preset Filters list management in the annasta Woocommerce Product Filters plugin admin

    Filter title

    The Filter title field assigns the title for the filter’s title bar that will be displayed above the filter terms unless the Show title bar option is unchecked.

    Show title bar

    Uncheck this option if you don’t wish to have a title bar above the current filter.

    Users of premium version should keep in mind that a filter can not become collapsible or act as a dropdown filter with this option disabled.

    Show active filters

    Check this option if you wish to have active filter badges enabled for this particular filter. A badge (with a reset button) will be created under the filter title (or on top of filter terms if the title bar doesn’t get displayed) whenever the current filter’s item becomes selected.

    Filter value prefix

    The value of this setting will be used during the creation of the active filter badges for your filter, and in the filter labels’ hover tips. It will be added before the selected values, so you can set it to smth like “Product prices” for the price filter badge to display “Product prices $22 – $33”.

    Reset all filters

    This option is available in the premium version of the plugin.

    Check this option if you wish to reset all the rest of the active filters whenever a visitor clicks on this filter.

    Please keep in mind that the reset button of an active filter badge for this type of filter will not act as a reset all button, and will reset only the filter itself.

    Make collapsible

    This option is available in the premium version of the plugin.

    Enabling this option will add filter open / collapse buttons in the top right corner of the title bar.

    Please remember that this option is not available if the Show title bar option is disabled.

    Initialize in a collapsed state checkbox will put your filter into an initially collapsed state when the page loads.

    Display as dropdown

    This option is available in the premium version of the plugin.

    Dropdown filter style in the annasta Woocommerce Product Filters WordPress plugin

    Make your Woocommerce products filter act as dropdown filter, with checkboxes, custom icons, color boxes and all the rest of the styling options still available inside of the select box!

    Placeholder text

    This option is specific to the products search control. It allows you to customize the placeholder text (the default text appearing in the control before any value is entered) for the products search box.

    Enable autocomplete

    This is another option that belongs exclusively to the products search control. Enabling it will offer additional options that control the display of the products search autocomplete box.

    Apply filters to autocomplete results

    Enable this checkbox when you wish your autocomplete suggestions to respect the filters that are currently applied to the page. This way, if you have the Red color filter applied to the current page, the autocomplete will search for suggestions among the products that have the red color AND their titles and descriptions matching the current value of the products search box.

    The unchecked Apply filters to autocomplete results option will mean that the autocomplete will search for suggestions through ALL the shop products.

    Begin autocomplete after X characters

    Enter the number of characters entered into the products search box after which you wish the autocomplete to start working.

    Show the maximum of X results

    Enter the maximum amount of suggestions that can be displayed by autocomplete.

    Display products’ images

    Check to display the images for the suggested products.

    Display products’ prices

    Check to display the prices of the suggested products.

    Show “View all results” link

    Add the “View all results” link at the end of the suggestions list.

    View all results link text

    This option is available in the premium version of the plugin.

    Customize the text of the “View all results” link label.

    Autocomplete height limit (pixels)

    This option is available in the premium version of the plugin.

    Limit the height of the autocomplete box, in pixels. Scrollbars will be added to the autocomplete box whenever the height of the suggestions list exceeds the specified number in pixels. Set to 0 to disable the height limitation.

    Filter type

    Filter type setting controls how the filter items become selected. There are 3 built-in filter types in our Woocommerce products filters plugin: singe item selection, multiple items selection, or range selection.

    Single item selection, multiple items selection and range filters in the annasta Woocommerce Product Filters WordPress plugin

    You can see all 3 filter types presented on the image above. The product categories filter is multiple items selection type, notice how this type allows for the selection of multiple filter items at the same time. The Product Stock Status Filter in the above example is a single item selection filter type, it allows for only one item being selected at any given moment (in the above example, only the products that are in stock are being displayed, and if you clicked on the Out of stock filter, then only the out of stock products would be displayed in the shop). The Products Price Filter shown above belongs to the range selection filter type. It allows the selection of a range of values, in our case these are the product prices in the range between 3 and 25 Euro.

    If you have more than one annasta Filters presets working on the same page, make sure that the same taxonomies are associated with the same filter type (for instance, if you have Product Categories filter in 2 different presets displayed on the same page, make sure they are either single-, or multi-select Filter type in both cases). In case of the range filters it is also advised to have the multiple range filters’ scales match.

    The multiple items selection and single item selection filter types are rather self-descriptive and do not have any additional settings, but a few more words should be said about the range selection filter type.

    Range selection type

    Range selection is the default filter type for the Products Prices and Products Rating filter. There are 2 ways to setup a price range filter or a product rating range filter: with auto-completed range values, or with custom range values.

    Automatically calculated range values

    Whenever you need a range divided into equal segments, you can use the Automatically calculated range values setting of the Range values field. In a case like that all you need to do is to setup the minimum and maximum values of the range filter for your Woocommerce shop, and specify how many range divisions you want to have.

    Settings for the automatically calculated range filter values in the annasta Woocommerce Product Filters WordPress plugin admin area

    For example, you need a range filter for the products prices from 0 to 100 USD, and you want to divide it into 4 equal sections of 25 USD. Set the Minimum value option to 0, the Maximum value to 100, and put 4 in the Range divisions field. Push the preset settings Save button, and the range of 0 – 100 USD divided into 0 – 25 | 25 – 50 | 50 – 75 | 75 – 100 will be created for you automatically (if the Precision option is set to 0).

    In case the Precision is set to 0.01, the automatically created range will become 0 – 24,99 | 25,00 – 49,99 | 50 – 74,99 | 75 – 100. You will see that if you set the number of decimals option to 2 (if the decimals are set to 0, you will see the rounded values both in previews and on shop pages, so the difference made by the Precision setting may not be visible, though it will still be there when applying filters).

    Custom range values

    If you need a better control over your range divisions, you can use the Custom range values option of the Range values select box. Custom range will give you the power to setup your own value for each range division.

    Custom range filter values settings of the annasta Woocommerce Product Filters WordPress plugin admin

    You will see a list of all the filter range values right under the Range values select box. To remove an unneeded range value just push at this value’s label in the list. Add a new value to the range by putting it into the Add value field and pushing the Add value button. After each deletion or addition values will be automatically sorted in the ascending order.

    Let’s illustrate the setup of custom range values on an example. Say, you want to divide your range of 0 – 100 USD into the following uneven divisions: 0 – 9,99 | 10 – 49,99 | 50100. You do have to have the 0 and 100 on the range scale, since they’re the left-most (minimum) and the right-most (maximum) values of the scale. Then, you will add the 10 and the 50 by entering these values into the Add value field and pushing the Add value button.

    The sections’ end-values of 9,99 and the 49,99 will be calculated automatically based on the value of the Precision field according to the following formula: next range value – precision. Whenever you want you ranges to be more accurate, you can use the Precision option to make the last value of the range segment to be a little less than the first value of the next range segment. If you want the end value of the segment to be the same as the first value of the next range division, set the Precision to 0.

    Keep in mind that there always have to be at least 2 values present in a range filter (the minimum and the maximum values), so you can’t delete anymore values if only 2 are left. if you need to change the minimum or the maximum value in a 2-value range, just add the new value, and then delete the unneeded one.

    Precision

    The value of the Precision option is used to create the auto-calculated end-values of range divisions. It can help in creating more accurate ranges for price filters or ratings filters styled as radio buttons or custom icon lists.

    To understand how it can be used, imagine that you have a range of 0 to 100 USD which you wish to divide into 2 sections of 0 – 49,99 | 50 – 100. If the Precision is set to 0, you will get the range segments of 0 – 50 | 50 – 100, but say you don’t want the first value of the next range segment to be included in the previous segment. To get the end values of range divisions differ with the starting value of the next range division by 0.01 set the Precision to 0.01. This way all the end-values except for the last one will be calculated according to the formula value-precision (in our case 50-0.01=49,99), and you can achieve a range of 0 – 49,99 | 50 – 100 type.

    Number of decimals

    This setting is mostly used for the formatting purposes. Whenever possible, it controls the display of range values in the shop. You can use it if you do not wish your prices (or ratings) to display decimals: just set the setting field value to 0, and you will get rounded numbers without decimals showing in the range values.

    Keep in mind that this will not change the real values of the range divisions’ labels, but will only format the decimal part of the numbers to not be seen. Still, if you want your range filters to have the label formatting of 0 – 25 | 25 – 50 | 50 – 75 | 75 – 100, you are welcome to use this setting.

    Value prefix

    The value of this field will be displayed before the range values. It can be used for the currency symbols etc.

    Value postfix

    The value of this field will be displayed after the range values. Use it for the currency symbols and the like.

    Filter style

    The Filter style setting controls the appearance of your filter. Different options are available depending on the Filter type and the plugin version that you use. The css styling of the filters’ elements has intentionally been left as “light” as possible, for filters to seamlessly fit into your existing shop theme. You can make any changes you need through your theme’s style sheets.

    System radio buttons
    Single filter option selection with radio buttons controls in the annasta Woocommerce Product Filters plugin

    The browser-controlled radio buttons (or option buttons) are the most basic style option for the single-select or the range selection filter type. This control element may look a bit different in different browsers, but in essence will do the same job of allowing the user to choose only one of a predefined set of mutually exclusive options.

    System checkboxes
    Multiple filter options selection with checkbox controls in the annasta Woocommerce Product Filters

    This style is available for the multi-select filter type. Usually a browser checkbox is shown as a square box that is ticked (checked) when activated and is used to let a user select one or more options of a limited number of choices.

    Custom icons
    Custom Font Awesome Free filter icons style of the annasta Woocommerce Product Filters WordPress plugin

    The custom filter icons option allows you to choose any of the Font Awesome Free icons for your filters, with hover state support for both selected and unselected filter icons. This style option is available for all the filter types.

    Custom filter icons management in the annasta Woocommerce Product Filters

    To setup custom icons for you filter, select the Custom icons option in the Filter style select box. Some commonly used icons are presented at the bottom of the Custom Icons Settings admin section. You can copy them into the clipboard by simply clicking on them. If you need something more customized, please visit the Font Awesome Gallery for a full selection of Font Awesome Free icons.

    Copy – paste Font Awesome Free icons in the regular and hover state fields for Inactive (unchecked) and Active (checked) filter icons. Use the Solid style option to achieve the needed effect.

    Some Font Awesome icons are available only in Solid or Regular style. If the icon that you need is not showing properly, just toggle its Solid style checkbox to see if it fixes the problem.

    The interactive filter items Preview next to the settings fields will allow you to assess the appearance of your filter even before saving the options. Bring your mouse pointer to the filter item label of the Preview section to see the hover effects that you have created.

    If you don’t wish to have the hover effect, assign the same icon to the non-hover and hover states.

    Color boxes

    Color boxes filter style can be used in both single-select and multi-select filter types to filter the Woocommerce Color attribute.

    Color filters in the annasta Woocommerce Product Filters WordPress plugin

    To setup a Woocommerce products Color attribute filter with the color box controls, select the Color boxes option from the Filter style select box.

    Color boxes filter style management in the annasta Woocommerce Product Filters admin

    You will see a list of the current filter items with a color-picker control next to each of them. Select the needed colors from the color picker (or enter their hex codes directly into the hex code box), and set the Display label option as needed.

    If you need your color boxes to show in a row, select the Display items in a row option right underneath the Filter style section.

    Tags
    Tags filter style in the annasta Woocommerce Product Filters WordPress plugin

    Tags style will display your filter labels as boxes with border. You can combine it with Display items in a row option to display the tags one after the other.

    To apply the Tags style to your filters, select “Tags” in the Filter style select box.

    Images

    This option is available in the premium version of the plugin.

    Image filters in the annasta Woocommerce Product Filters WordPress plugin

    If you are using the premium version of annasta Filters, you can also use images in front of (or instead of) your filter labels.

    To setup this style for your filter, choose Images in the Filter style select box.

    Image filter style management in the annasta Woocommerce Product Filters admin area

    You can select a distinct image for each filter item, or use One image for all terms option to display the same image for all filter items.

    To select an image, click on the Select image from media library button, and choose the needed image from the WordPress Media Library section, or, alternatively, you can directly enter a url link of your choice into the Image link field next to the item.

    Check or uncheck the Display label option as needed.

    If you need your image boxes to show in a row, select the Display items in a row option right underneath the Filter style section.

    Whenever you update the terms images and notice that the changes do not get reflected in your browser, you might need to clear your browser’s cache (or use another browser) to see the refreshed style.

    Labels
    Filter Labels style of the annasta Woocommerce Product Filters WordPress plugin

    Labels are available for the single-select filters and are basically just filter item name without any icon. They are minimally styled so that you could customize the appearance by applying your own css rules to suit your shop theme.

    Custom term icons and labels

    This option is available in the premium version of the plugin.

    Custom icons and labels for each filter term in the annasta Woocommerce Product Filters WordPress plugin

    This advanced style option allows you to assign an individual icon for each filter term, as well as set custom labels. Select the Custom term icons and labels style from the Filter styles select box.

    Custom filter term icons and labels management in the admin area of the premium version of the annasta Woocommerce Product Filters plugin
    Example of custom icons and labels management in the premium version of the annasta Woocommerce Product Filters WordPress plugin

    In the list of the filter terms, put the chosen Font Awesome icon (or more than one icons, or some text) for the corresponding filter term, and adjust the label as needed. Whenever you don’t want any icon or label for a term, simply leave the corresponding field empty. Don’t forget to push the Save button at the bottom of the page when finished.

    Some of the icons are presented at the bottom of the section. You can copy them into the clipboard by simply clicking on them. To explore the whole variety of the available icons, please visit the Font Awesome Gallery .

    Stars

    This option is available in the premium version of the plugin.

    Stars style for the Woocommerce products rating filter available in the premium version of the annasta Woocommerce Product Filters plugin

    This premium style has been created especially for the average product rating filter. It will display the rating range values with the corresponding amount of stars near each range division.

    To assign this style to your product rating filter, choose it from the Filter style select box.

    Admin area of the Woocommerce product rating Stars style in the premium edition of the annasta Woocommerce Product Filters WordPress plugin

    Please pay attention to the custom range values, as well as the Precision option value on the image above. Copy these settings to your own filter to achieve the average ratings divisions of 1-1.99 | 2-2.99 | 3-3.99 | 4-4.99, 5, or edit according to the same pattern as needed.

    This style also gives you the option of specifying any custom label of your preference.

    Range slider

    Use the Range slider filter style for products prices filter. In the premium version of the plugin you can also use it to display slider control for the Woocommerce product rating filter.

    Range slider filter style in the annasta Woocommerce product filters plugin for the price filter, product rating filter, and a taxonomy-based range slider control example.

    Also in the premium version, you can set the Range selection as a filter type for the taxonomy-based and product attribute filters and then create sliders for labeled sizes, diameters and other non-numeric attributes and taxonomies that can be displayed as ranges.

    Admin section of the range slider control in an annasta product filter

    In the admin section of the Range slider style you can control the smallest move of a slider by means of the Slider step option, as well as the slider tooltips appearance through the Tooltips display options box. Check the Display Filter button option to make your slider control submit its filter by a click on a “Filter” button rather than by moving the slider handles.

    When displaying the same filter in different presets on the same page, and one of the filters has the range slider style, to avoid conflicts, please take care to assign the range slider style with the same exact scale to all the rest of the same filters of the same page.

    Display items in a row

    Check this option if you prefer the filter items to be shown in a row instead of column (list) view.

    Make children collapsible

    This option is available for the hierarchical (multi-level) taxonomies, such as product categories (which can have sub and sub-sub categories). Enabling this option will place toggle buttons next to each parent level filter label to allow opening and closing of its child level lists.

    Initialize with children collapsed checkbox will put the filter’s child levels in an initially collapsed state whenever the page first loads or reloads.

    Do not set the hierarchical taxonomies with collapsible children to Display items in a row, these two options are incompatible.

    Display items search

    Enabling the filter items search will add a search box at the top of the filter items list. This search box will dynamically filter the contents of the filter items list to show only the items that satisfy the search string criteria. You may find this option useful for filters with a large list of options.

    Excluded terms

    This is a very useful setting for the cases when you wish to exclude some of the filter items from the list of filter options. For instance, with the help of this option you can exclude the universal “Uncategorized” Woocommerce product category from the options list of a Product Categories filter.

    To exclude an item, select the label of the option that you want to exclude from the Exclude terms select box, and push the Exclude button. To remove an exclusion, click on the Remove button next to the name of the excluded option.

    The items from the excluded terms list are only removed from the list of filter options. Any products associated with those items will show in the shop normally.

    Sort filter items by

    This option controls the order in which the individual terms appear within the filter. You are given the choice of sorting by Name, Order of creation, or the Admin sort order. By the Admin sort order is meant to custom items order that you can set (at least for the product categories and product attributes) on their respective admin settings pages. The ability to assign the display order for the custom taxonomies depends on the custom taxonomy manager that you use.

    Filter items sort order

    The sort order setting works in combination with the previous option of Sort filter items by. You can set the ascending order for name and date sort type (which will equal to the regular display for the Admin sort order), and descending (for the Admin sort order type this will display the filter items in the reverse order).

    Limit filter height

    Scrollbars in filters with limited height in the annasta Woocommerce Product Filters WordPress plugin

    If you have filters with long lists of options, or would like to make several filters have the same height (which can be useful for arranging the filters nicely at the top of the products list), set this setting to the desired height in pixels, and you will see the filter height limited to this value and the vertical scrollbars appearing to allow scrolling through the filter list.

    Go to the Styles section of the plugin options and enable the pretty scrollbar option to replace the standard browser scrollbar with a minimalistic – looking JavaScript one.

    Show products’ counts

    Enable this option to display the dynamic product counts next to each filter option. The value of the product count will be changing with each new filter application to reflect the amount of products available in each filters’ combination.

    For example, if your shop sells 10 apples 5 of which are red, the count will show 10 near the Apples filter option in a shop with no active filters, and 5 if you have applied the Red color filter.

    A lot of attention has been given during the development of this plugin to the product counts management. A caching mechanism and other technologies are in place to ensure its smooth functioning. Still, we would like to draw your attention to the fact that this option is rather resource-consuming, so if you are on a shared hosting plan and/or run a shop with very large amount of products and many filters, please use it only on the filters that really need it.

    Styles Settings

    Enable pretty scrollbars

    Check this option for the minimalistic modern-looking scrollbars to replace the standard browser ones in filters with limited height.

    Filters style

    This option is currently in the development.

    Range slider style

    This setting lets you control the appearance of all the annasta range slider controls displayed on the pages of your shop. Choose between the default and minimalistic slider styles.

    Color & image box style

    Choose how you wish to display the image and color boxes controls of your filters. The square and round-styled image and colour boxes are currently available.

    Custom CSS

    Use this field to easily add custom css rules to your filters. Type in the needed css rules as you would in a regular css stylesheet.

    SEO Settings

    Page title

    With the help of this option you will be able to change the standard page title (HTML document title) for the shop pages. The page title is the text that you see as a title for your browser window, or tab. It is also taken into account by the search engines crawling the pages of your shop.

    Our plugin offers you 3 options to manipulate the title tags of your Woocommerce shop pages:

    • “Woocommerce default” will leave the title as it is
    • “annasta Default title” (or “annasta Default page title” for the premium version users) will set the page title to the string that you set in the Default title field below (Default page title for the premium version users).
    • “Autogenerated list of annasta filters” will dynamically generate distinct page titles for each filters combination by inserting the list of currently active filters into the page title. Use the settings of the Filters List Generation section below to customize the automatically generated titles.

    Default page title

    This option is available in the premium version of the plugin.

    Choose the “annasta Default page title” in the Page title setting to display this string as a browser (HTML document) title for the pages of your shop.

    This title will also be used as page title whenever there are no active filters to display in the autogenerated filters lists.

    Shop title

    This setting will help you customize the shop page heading (H1 tag) above the products list. You have 3 choices for setting the shop pages’ H1 tag:

    • “Woocommerce default” will leave the shop title as it is
    • “annasta Default title” (or “annasta Default shop title” for the premium version users) will set the shop title to the string that you set in the Default title (Default shop title) field.
    • “Autogenerated list of annasta filters” will dynamically generate distinct H1 tags for each filters combination on your shop pages by inserting the list of currently active filters into the title tag. Use the settings of the Filters List Generation section below to customize the automatically generated titles.

    Default title

    This option is available only in the free version of the plugin.

    Choose the “annasta Default title” in the Page title and/or Shop title settings above to display this string as a browser (HTML document) and/or shop title (H1 tag of the shop pages).

    This string will also be used as page and/or shop title whenever there are no active filters to display in the autogenerated filters lists.

    Default shop title

    This option is available in the premium version of the plugin.

    Choose the “annasta Default shop title” in the Shop title setting above to display this string as shop title (H1 tag) above the products list.

    This string will also be used as shop title whenever there are no active filters to display in the autogenerated filters lists.

    Meta Description

    Add meta description

    Check to add the “description” meta tag to the pages of your shop. The contents of the meta description tag is sometimes used by the search engines as a page description seen under the title of your shop page in the lists of search results.

    Meta description

    Write the text for your shop pages meta description inserting {annasta_filters} (or pushing the Insert annasta filters list button) at the positions at which you wish to add the autogenerated annasta filters lists to your “description” meta tag.

    Filters List Generation

    The filters lists are generated according to the following formula:

    filters prefix + space + filter 1 selection 1 + filter values separator + filter 1 selection 2 + filters separator + filter 2 selection 1 + filter values separator + filter 2 selection 2 + (… + filters separator + additional active filters …) + space + filters postfix.

    You can set the beginning of the title (in the Filters prefix option), as well as (in the premium version) the string that will be added at the end of the filters list (with the help of the Filters postfix option). Set the characters that are uniting different filters, and the multiple selected values of the same filter with the help of the Filters separator and Filter values separator settings.

    Filters prefix

    The text to add before the autogenerated annasta filters list.

    Filters postfix

    This option is available in the premium version of the plugin.

    The text string to add at the end of the title.

    Filters separator

    The characters or text used between the different filters of the list (for example, between the selected product categories and product colors).

    Filter values separator

    The characters to use between the selected values of the same filter (for example, between the names of the selected products categories).

    Filters Settings

    This section with all its options is available in the premium version of the plugin.

    The options of this section will allow the advanced customization of the active annasta filters lists for the page/ shop titles and meta description tag by letting you set some options on a filter-by-filter basis.

    Exclude unimportant filters from the titles, change the order in which the filters appear in the list, set custom prefix and postfix for each filter, a string to use in case of filter being inactive, and more!

    Include filter

    The Include filter checkbox to the left of the filter name can be used to include or exclude the filter from the page and shop titles.

    Please, remember that the “description” meta tag generation will not take this setting into account, and the filters skipped for titles will be added to the end of the active filters lists of meta descriptions.

    Prefix

    This string will be added just before the value (or list of values) for the corresponding filter.

    The title generation algorithm intentionally doesn’t add space after this prefix, so please add it at the end of this field when needed.

    Filters labels

    Whenever needed, fill the Inactive field with the text that you wish to see in place of the filter when none of its values are selected.

    An example of this option’s usage would be setting this field to “products” for the Product Categories filter, so that the title could read something like “Shop for products in Red, Black, Yellow and Small / Medium / Large” whenever no products category is selected.

    For a Product Color filter you could set the Inactive label field to “all colors” to get something like “Browse our shop for Shoes, Jeans, Tops in all colors and in Medium size”

    In the Filter labels column you can also adjust the labels for the values of some built-in annasta filters, such as Stock Availability, On Sale Products, and the Featured Products filter.

    Postfix

    A string to add after the list of filter values. No space is added between the list of values and this postfix, so please account for it when assigning the postfix values.

    Range settings

    The range settings are used for the price and rating ranges display in the SEO filters lists and include the minimum and maximum filter values that you wish to be displayed whenever these values aren’t set by the filters.

    In the Separator option of the range settings you can set the characters that will separate the minimum and maximum values of the filter.

    Plugin Settings

    Include subterms’ products

    This option controls the behavior of the filtering engine for the hierarchical taxonomies. Enable this if you want the products belonging to the filter children terms to show in the results for the parent term.

    Let’s illustrate this on a small example. Imagine you make a filter out of the Product Categories taxonomy of your shop. Product categories are a hierarchical taxonomy, meaning that there may exist sub-categories. Let’s say we have a shoe shop, and you have a parent category of Boots, which has the subcategories of Hunting Boots, Hiking Boots and Casual Boots. If you wish for the products for all these subcategories (as well as all the possible sub-sub-sub… categories) to show when the shop is filtered for the Boots category, check the Include subterms’ products option! If on the other hand you choose to leave it unchecked, only the products that are directly declared as belonging to the Boots category (and none of the products from the Boots subcategories) will be displayed whenever you apply the Boots filter option.

    Redirect archives to shop

    This option doesn’t work with some themes, please test before using it!

    Checking this option will force redirects from all the products attributes and custom taxonomies archive pages (products tags, categories, brands etc) to the corresponding filtered result of the main shop page.

    The default annasta Filters behavior for the Woocommerce products-linked taxonomy archive pages is to filter only the particular term of the given taxonomy. This means that, for example, if your customer gets to a Fruit category archive page (with a link of something like https://yoursite.com/product-category/fruit/), he or she will only be able to filter the Fruit, and no other category. The same taxonomy filters will not be displayed on such pages, even when the preset contains them.

    On a shop page, on the other hand, you can filter by any term of any taxonomy, which means that you can apply the Fruit category filter, and later change it to Berries, or combine the 2 together and filter through both of them simultaneously. It may or may not be your wish, but if the needs of your shop require the unrestricted filtering through any taxonomy at any time, you can check the Redirect archives to shop option to try and transfer any taxonomy archive page related to the Woocommerce products to a filtered shop page.

    This way, the visitors of your site will not see the separate pages for any taxonomy, but will always get redirected to the shop page (with the corresponding filter applied, so that when the Fruit taxonomy archive is requested, the redirect would lead the visitor to the shop page with the selected Fruit filter).

    Shortcodes pages

    This field registers your site pages with product lists created via the Woocommerce [products] shortcode to work with filter presets that are associated with them.

    If you wish to filter Woocommerce products shortcode pages, you will need to setup product filters to work on those pages by selecting each of them in the Shortcode pages multi-select field.

    If you omit this step, any filters that will appear on the page will redirect to the relevantly filtered results of you main shop page. If you want for the filters to work directly with the product lists of the page, you do have to add this page to the Shortcode pages list.

    For the filter preset to display on and filter the [product] shortcode page, don’t forget to include the pages registered here in the Display on section of the preset settings, and make sure that the site element in which you placed the annasta Filters widget or shortcode is present in the page using the Woocommerce products shortcode filter!

    Reset button exceptions

    This option is available in the premium version of the plugin.

    This premium option allows you to control the Reset (or Clear all filters) button behavior. There are 2 default exceptions to the action of the Reset button: the Products per Page and the Sort by controls. Their settings are not reset by the push of the Reset all button. They still can be reset by clicking on the reset button of the corresponding active filter badge, or changed through the interactions with their respective controls.

    By adding and removing filters and controls to the Reset button exceptions you can adjust the behavior of the Reset button to the needs of your shop.

    Active badges exceptions

    This option is available in the premium version of the plugin.

    Similarly to the Reset button exceptions you can add exceptions (e.g. filters and controls that you do not wish to be included) to the active filter badges by selecting them in the Active badges exceptions multiselect. No active badges will be created by none of the annasta Filters presets for the filters and controls selected in this field.

    Active badge reset tip

    This option is available in the premium version of the plugin.

    Customize the hover tip displayed when the user draws the mouse pointer to the reset button (a small x to the right) of an active filter badge. Leave blank if you do not wish any tip to be displayed.

    Active badges above products

    This option is available in the premium version of the plugin.

    Check to display active filters’ collector with reset filter buttons under the Woocommerce shop title (H1 tag of the shop pages).

    The products list badges are not available on pages with Woocommerce products shortcode.

    Remove built-in Sort by

    Checking this option will remove the built-in Woocommerce products sorting box at the top and bottom of the products list.

    This option will only work with themes that support the native Woocommerce products sorting hooks.

    Scroll to ajax results

    Check this option to enable an automatic scroll to the top of the products list on each AJAX products filter application.

    Ajax scroll adjustment

    Adjust the page position to which you want the Scroll to ajax results option to scroll the page on each ajax filter application. Accepts positive and negative numbers that will adjust the position of the scroll’s endpoint in pixels.

    Force products display

    This option controls the way the main shop page is displayed. Since the filters are usually set to work on the main shop page, they need this page to be set to the products display mode in order to function properly.

    There is a Woocommerce setting that allows product categories to be displayed on the shop pages, or subcategories to be displayed on the category pages (you will find it in the Appearence > Customize > WooCommerce > Product Catalog section in Shop page display and Category display options). Whenever this options are enabled, they break the proper filtering of the main shop page products, for which reason the annasta Woocommerce Product Filters plugin disables them by default.

    If you do not wish the filters to work on the shop page (in cases when one uses them only on the [products] shortcode pages), and want your shop to display product categories on the front page, and/or subcategories on the category pages, you can uncheck this option.

    Product columns

    This option is available in the premium version of the plugin.

    Specify the amount of product columns that you want to display in your shop.

    Products per page

    This option is available in the premium version of the plugin.

    This option will set the default products per page value for your shop. Use it in combination with the products per page control to give the visitors of your site the power to choose the amount of products that they want to see with each page load.

    Products list html container

    This is an advanced setting for those who use a theme with non-standard Woocommerce html markup. The default setting of this field is “#main” which is the standard Woocommerce and WordPress container holding the contents of the page. If your theme uses a different page structure, you’ll need to check the shop page source html to see which container encapsulates the Woocommerce product lists. Enter the id or class for this container into the Products list html container field (please put the # sign in front of the id, or a dot before the name of the class).

    Advanced Settings

    Query parameters’ labels

    This option is available in the premium version of the plugin.

    This advanced option gives you the power of specifying your own labels for the filtering parameters that appear in the url string of the filtered page address. For example, if you wish to remove the native ” pa_” prefix from the product attribute filters’ labels in the url strings and want to change “pa_sizes” into “sizes”, you can do it here.

    Be careful not to assign the parameter names that are reserved by the WordPress itself, Woocommerce, or any of the plugins that are running on your site. Doing so will result in unpredictable filters behavior and numerous other possible conflicts and errors.

    Query operators for product taxonomies

    This option is available in the premium version of the plugin.

    With the help of this option you can change the query inner-logics for each filter taxonomy from the default IN to AND, or NOT IN.

    The default IN taxonomy logics filters the Woocommerce store for all the products that are associated with the selected taxonomy terms. Taking an online grocery store as an example, setting the IN relationship between the terms of its Product Categories will result in the display of all the products that belong to the selected categories. This means that if you filter such a shop for the Fruit, Berries, and Vegetables product categories, you will be shown all the products that are Fruit, Berries, or Vegetables.

    The AND operator used in a relationship between the members of the same taxonomy will result in the display of the products that belong to ALL of the selected taxonomy terms at the same time. For example, tomatoes can be put both into the Vegetables, and the Berries product categories. If you now set the AND relationship for the members of the Product Categories taxonomy, and then filter for Berries and Vegetables, you will get the tomatoes displayed, along with any other products that are also associated with both of these categories. In a Colors filter with an AND operator, selecting Red and Yellow will display only the products that have both of those colors associated with them.

    As you might have already guessed, the NOT IN logics filters the products for those that are NOT associated with the selected filter term. Returning to the grocery store example, in a case like that selecting Dairy products will show all the products that are NOT in the Dairy category. Clicking on the Fruit will remove fruit from the filtered result as well, and so on.