Settings
By default, the plugin is configured to work on most sites. You can configure the plugin as you need. For this, go to WCAPF > Settings menu and change the settings as you need.
General
Name | Description |
---|---|
Filter Relationships | The relationship between filters. AND – products shown will match all filters, OR – products shown will match any filters. |
Dynamic Product Count | Whether to update the product count number according to the applied filters. |
Options with zero products | Determines what we do with the options with zero products. Available options are Always Show, Never Show. |
Hide empty filters | Whether to hide the filters that don’t have any options. |
Disable Ajax | Enable this if you want to disable filtering via Ajax. |
Hide Empty Filters
To hide the empty filters enable “Dynamic Product Count”, set the “Options with zero products” to “Never Show” and enable “Hide empty filters”.
These settings will also hide the filters with display types “Range – Slider” and “Range – Number” if the min and max value is equal. Note: For the number range filter, the min and max value gets updated according to the applied filters if “Auto-detect min and max” is enabled in filter settings.
Integration
Name | Description |
---|---|
Active Filters on top of products | Enable this to show the active filters on top of the products loop, only works in the standard shop loop. |
Pagination via Ajax | Whether to enable Ajax to paginate the products. Only applicable when filtering via Ajax. |
Product sorting via Ajax | Whether to enable Ajax for the default product sorting dropdown. Only applicable when filtering via Ajax. |
Sorting data in Active Filters | Enable this if you want to show the sort-by data that comes from the default product sorting dropdown in active filters. |
Use term slug | Whether to use term slug instead of id as the option value. |
Child terms only | Whether to show only the child terms when viewing a term archive page. |
Vendor support | Enable this to show the store name as the option label in the post-author filter. |
Appearance
Name | Description |
---|---|
Primary Color | Set a primary color according to your theme. Default is #1C5DA1. |
Stylish checkbox & radio buttons | Enable this if you want stylish checkbox and radio buttons instead of native design. |
Enable ComboBox | Turns the native select element into a custom select box with improved design and behavior. |
Improve native select element | Uncheck this if your theme already implements the design for the native select element. |
ComboBox for sorting dropdown | Attach ComboBox for the default sorting dropdown instead of the native select element. |
Improve scrollbar | Enable this to improve the scrollbar that appears when max height is applied to a filter. |
Improve input type text/number | Enable this if you want to use styles from your theme for input type text/number. |
Hierarchy toggle at the end | Uncheck this to show the hierarchy toggle just after the item label instead of at the end of the item. |
Number range slider style | Select the number range slider style from the available ones. |
Star Icon Color | Set the star icon color for the rating filter(not applicable for display type: select, multiselect). Default is #FDA256. |
FontAwesome for star icons | Enable this if your site loads the FontAwesome icons. |
Remove focus style | Enable this to remove the focus style from input(text) and dropdown elements. |
Loader & Scroll To
Name | Description |
---|---|
Loading Animation | Whether to show an animation while the results are fetching. |
Loading Icon | Select the loading icon from the available icons. |
Custom loading icon | Upload the loading icon. Note: If the SVG icon does not animate, try to upload by disabling sanitization. |
Icon Size | Adjust the loading icon size in px. Default is 60. |
Overlay Color | Adjust the loading overlay color. Default is #FFFFFFCC. Note: There is an alpha channel to control the transparency or opacity of the color. |
Wait Cursor | Enable this to show a wait cursor while the results are fetching. |
Scroll window to | Determines the scroll behavior. |
Scroll for | Determines the devices on which we scroll the window. Desktop, Mobile, or Both. |
Scroll when | Determines when to scroll. After updating the results or Immediately. |
Custom element identifier | Give a valid id/class of the HTML element you want to scroll to. |
Scroll on | Specify the event for which you want to scroll the window. Available options are All, Filter, and Paginate. |
Scroll to top offset | If you have a sticky header or some space that you want to include in the viewport then give the height of those in px. |
Disable scroll window animation | Check this to disable the scroll window animation. |
Filter Keys
Here you can edit the filter keys globally and change the order of those in the URL.
In the PRO version, you can change the order of filter keys.
Others
Here you can change the phrases shown in the front end.
Phrases
Name | Description |
---|---|
Keyword filter placeholder | Applicable for the input field of the keyword filter. Default is “Search products” |
Keyword filter prefix | This prefix will be used in the active filters, before the keyword. Default is “Keyword:”. For a value “shirt”, it becomes “Keyword: shirt” in the active filters. |
Search field placeholder | Applicable when the search box is enabled in the list view. This will be overridden by the placeholder value of the filter itself. Default is “Search” |
No results text | Applicable when the search box is enabled in the list view and combobox enabled in the dropdown view. Default is “No results for:”. For a keyword, “purple” the text will be “No results for: purple“ |
No options text | Applicable when combobox is enabled in the dropdown(multiselect) view and all options have been chosen. Default is “No options to choose” |
Empty filter text | Applicable when there are no options to filter by or the filter is empty. Default is “N/A” |
Show more button label | Default is “+ Show more” |
Show less button label | Default is “− Show less” |
Clear button label | Default is “clear” |
Clear All button label | Default is “Clear All” |
Reset button label | Default is “Reset” |
Results count markup | Default: Found %d product|Found %d products Here two markups are separated by the pipe(|) character. The first markup is for the singular result and the second one is for the plural result. %d will be replaced with product count. |
Sort by prefix | This prefix will be used in the active filters, before the sort by value. Default is “Sort by:”. For a value “Title”, it becomes “Sort by: Title” in the active filters. |
Per page prefix | This prefix will be used in the active filters, before the per page value. Default is “Per page:”. For a value of “15”, it becomes “Per page: 15” in the active filters. |
More
Name | Description |
---|---|
Input Delay | Specify the delay (in milliseconds) before triggering the filter action when the user interacts with the input fields. Default is 300. |
Pagination container | The css class of the pagination element, supports multiple classes separated by commas. In most cases, you don’t need to change this. Applicable when filtering via Ajax. Default is “.woocommerce-pagination”. |
Additional Selectors | If you want to update additional elements give the CSS classes separated by commas. Applicable when filtering via Ajax. |
JavaScript after ajax update | You may want to run javascript codes after updating the shop loop via Ajax. Leave it empty if you don’t understand. |
Author Roles | Users having any of these roles will be available on the Available Options modal of the post-author filter. |
Form multiple locations | Enable this if you want to reuse a form in multiple locations. |
Miscellaneous
Name | Description |
---|---|
Debug Mode | This will help you to configure the plugin correctly. |
Disable WCAPF | Check this to disable WC Ajax Product Filter in the front end for testing purposes. |
Send anonymous data | Enable this if you agree to send anonymous data to the developer to make the plugin better. |
Remove Data | Enable this to remove all data when uninstalling WC Ajax Product Filter via the Plugins page. |