If filters are not output on the page, go to the additional panel on the top admin panel to find the problem.
This panel is displayed on the front pages of the site.
The panel displays the ID of filters and groups, which are links to the filter and group editing page.
When you hover over the ID, you will also see the name of the filter/group and detailed information about the output.
Menu item is not displayed on the page
If the menu item is not displayed on the page, it means that there are no filters for the output on the page or the filters are output incorrectly:
- Check that filters are added to the page using a widget or a shortcode.
- Try to output any other widget or shortcode in the same place to check that everything works correctly on the theme side.
Filter is displayed as Empty options
If the filter is displayed as Empty options, it means that the filter is configured incorrectly and there are no settings.
- Check the filter or group settings.
- If there are cache plugins on the site, you need to clear the entire cache on the site.
- Try to create a new filter with the same settings.
Filter/group is displayed as Disabled
If the filter/group is displayed as Disabled, it means that the filter is disabled by the user.
- On the page with all filters/groups on the disabled filter, click Enable.
- Disable the Disable all filters option in the plugin settings on the Advanced tab.
Filter/group is displayed as Condition restriction
If a filter/group is displayed as Condition restriction, it means that the page does not meet the conditions that are configured for that filter/group.
- Open the filter/group editing page and change the display conditions.
Filter displayed as Displayed empty
If the filter is displayed as Displayed empty, it means that the filter is displayed on the page, but there is no data to display and therefore it is empty.
- Filter cannot find products on the page. You can find out more about errors on the page in the Status block.
- Products on page have no attribute values for this filter.
- Filter uses an attribute, which has no values.
Status
Block with data about the current page. Shows the interaction of the plugin with products on the page. It is possible to define the correctness of plugin settings and product output on the page.
- Is WC page – shows whether the current archive page for WooCommerce products.
- Shortcode – shows whether the page has a shortcode WooCommerce for displaying products or any other block that uses the mechanisms of WooCommerce shortcode (product modules page constructors: Divi Builder, Elementor, WPBakery Page Builder and others).
- Products – shows whether the products are defined on the page or not.
- Pagination – shows whether the pagination is defined on the page or not.
What may be the problem, how to know from the Status block and how to solve it?
Products are not defined on the page
Products are not marked, which means that the block with products is not defined on the page.
- Check if the products are displayed on the page.
- If the products are displayed on the page, you need to install the correct Selectors for the products.
This is the archive page of WooCommerce products, but the products are not filtered.
There are several reasons why products are not filtered on the WooCommerce products archive page.
- The page has been changed by the page constructor (Divi Builder, Elementor or others). In this case, for the module that outputs products, you need to enable the Apply BeRocket AJAX Filters option for supported constructors or add a short code [brapf_next_shortcode_apply] in front of the module to output products.
- WooCommerce shortcode is used instead of product output. In this case it is necessary to add berocket_aapf parameter (for example: [products limit=”8″ category=”hoodies” paginate=”true” berocket_aapf=”true”]).
- If the previous steps do not help, then try to change the theme to the standard WordPress theme and check if everything works correctly, then contact the developers of the theme to solve the problem.
Several product blocks are defined on the page
If there are several blocks with products on the page, it means that the page has several blocks that correspond to the products selector.
- If two blocks with the same products are output, then everything should be working correctly and there is no need to change anything.
- If one block with products is output on the page that should be filtered, you must install the correct selectors for the products. The selectors must be unique, unfortunately, auto selectors can’t find everything correctly, so you have to enter them manually.
There is no page numbering
Pagination is not marked, so the block with page navigation is not defined on the page.
- If you have all the products on one page and other products don’t load, then everything is fine.
- If you have page numbering, you need to specify Selectors correctly.
- If you have a product load button or endless loading while scrolling through a page, then you may need to configure it further. You can find out more from the plugin or theme developer where the product load button or endless load is being used.
Products are defined by the plugin, but are not filtered
In most cases, Is WC page and Shortcode will not be marked, which means the products are not defined on the server side.
- A block is used from any page constructor, but such a block is not supported by our plugin, and the developers of the block have not added the necessary hooks from WooCommerce. Use a different block or WooCommerce shortcode.
- Custom output of products is used on the page.
If Is WC page is marked and Shortcode is not marked, then products on the page have been replaced.
- Page constructor is used, which replaces the store/category/attribute page and does not use WooCommerce requests for this page. The plugin is compatible with most popular page constructors. Enable the following settings in the module/block with products Apply BeRocket AJAX Filters.
- WooCommerce [products] shortcode is used on the store/category/attribute page. It is necessary to add the parameter berocket_aapf=true to the shortcode [products berocket_aapf=true].
- The code on the page has been replaced by a custom one and the WooCommerce page request is not used. It is necessary to apply filters with additional code.
Errors on page load or filtering
If critical errors occur, an exclamation mark will appear next to the “Products Filters” caption. Such errors cause the filters to malfunction and need to be fixed. There are several errors that the plugin can detect.
Same filters with ID *** added multiple times to the page
This message appears if the exact same filter is added twice on page. This may occur if the filter is added twice on the page in different positions, or if the theme duplicates the filter to be output on different devices. Each filter will be output on the page only once, all other filters will be removed.
- Leave only one filter on the page. It doesn’t matter if one filter or a group is output. Even if you add the exact same filter to two different groups, it will be output only once.
- If you need to output filters in different positions on desktops and mobile devices, then create two different groups and enable the appropriate options for setting Hide this group on (desktop/mobile/tablet).
- If there’s only one filter on the page, but the error still appears, the reason is that the theme or page editor is duplicating the panel where you are outputting the filter. Try placing the filter in a different position or using a different module to display the filters.
Multiple filters with taxonomy ****** added to the page
This message appears if you have several filters added to the page for the same attribute or taxonomy with different styles that do not work together. You have several filters added to the page that may affect each other’s functionality.
- You should leave only one filter per page.
- If you need to output filters in different positions on desktops and mobile devices, create two different groups and enable the appropriate options for setting Hide this group on (desktop/mobile/tablet).
New page has another quantity of blocks with selector ******
The error may appear after filtering if the number of blocks is displayed differently on the current page and the page after filtering.
- If you’re using a page editor, and there appears an error on the page you’ve configured with the help of that editor, try checking the filters on standard WooCommerce pages.
- It is possible that the selectors that are configured in the plugin are not unique to the products, try to find a unique selector to the products that are supposed to be filtered.
Page has products that will be filtered, but products selector is incorrect
The plugin has detected products for filtering, but won’t be able to replace them on the page without refreshing it, because the selectors are set incorrectly.
- You need to change the Products Selector settings (plugin settings > Tab Selectors) to the one that will work for your theme. Learn how to choose the correct selector with the developer tools in your browser on the product page.