Plugin Settings Compatibility Reference

This Reference page covers the Compatibility tab in Plugin Settings. It is a manual draft for the full option Reference, not a standalone public release of the whole Reference set.

Compatibility settings are troubleshooting tools. Change them when a theme, builder, optimization plugin, multilingual plugin, or pricing integration needs different behavior.

Integration Compatibility

Force Theme Templates

• Public label: Force Theme Templates
• Location: Plugin Settings > Compatibility > Integration Compatibility
• Type: Toggle
• Default value: Off
• Shown when: Always.
• Availability: Free
• What it does: Forces filtering output to use theme template behavior where supported.
• When to use: Use it when product rendering breaks because plugin output differs from the active theme templates.
• Side effects / performance notes: Theme templates can introduce theme-specific hooks, wrappers, or layout assumptions.
• Related options: Theme Compatibility Mode, Custom Template File, Page Builder.

Remove Third-Party Actions

• Public label: Remove Third-Party Actions
• Location: Plugin Settings > Compatibility > Integration Compatibility
• Type: Toggle
• Default value: Off
• Shown when: Always.
• Availability: Free
• What it does: Removes certain third-party hooks/actions from filtered product output.
• When to use: Use it when external plugin actions duplicate content or break the AJAX-rendered product list.
• Side effects / performance notes: Removing actions can also remove desired badges, labels, or custom content.
• Related options: Allow Third-Party Prefiltering, B2B / Role-Based Pricing, Theme Compatibility Mode.

Exclude from JS Optimization

• Public label: Exclude from JS Optimization
• Location: Plugin Settings > Compatibility > Integration Compatibility
• Type: Toggle
• Default value: Off
• Shown when: Always.
• Availability: Free
• What it does: Excludes plugin scripts from optimization workflows that may combine, defer, or minify JavaScript.
• When to use: Use it when an optimization plugin causes filter scripts to load in the wrong order or fail.
• Side effects / performance notes: Excluding scripts can reduce optimization gains but improve reliability.
• Related options: Minify JS/CSS, Debug Mode, Theme Compatibility Mode.

Disable Plugin Sorting

• Public label: Disable Plugin Sorting
• Location: Plugin Settings > Compatibility > Integration Compatibility
• Type: Toggle
• Default value: Off
• Shown when: Always.
• Availability: Free
• What it does: Disables plugin-controlled sorting behavior.
• When to use: Use it when WooCommerce, the theme, or another plugin should fully control product ordering.
• Side effects / performance notes: Sorting may no longer sync with filter-specific sorting options.
• Related options: OrderBy Selector, Sort By Title After Filtering, Browser Back Button.

B2B Role-Based Pricing

• Public label: B2B / Role-Based Pricing
• Location: Plugin Settings > Compatibility > Integration Compatibility
• Type: Toggle
• Default value: Off
• Shown when: Always.
• Availability: Free
• What it does: Enables compatibility behavior for role-based pricing or B2B pricing plugins.
• When to use: Use it when product visibility, prices, or availability depend on customer role.
• Side effects / performance notes: Role-sensitive catalogs can require separate cache and count validation per user type.
• Related options: Cache Filter Results, Allow Third-Party Prefiltering, Display Private Products.

Allow Third-Party Prefiltering

• Public label: Allow Third-Party Prefiltering
• Location: Plugin Settings > Compatibility > Integration Compatibility
• Type: Toggle
• Default value: Off
• Shown when: Always.
• Availability: Free
• What it does: Allows compatible third-party logic to prefilter products before the plugin applies its filtering.
• When to use: Use it when another plugin must restrict the catalog before filter logic runs.
• Side effects / performance notes: Prefiltering can change counts and available values, so test with adaptive filtering enabled.
• Related options: Remove Third-Party Actions, B2B / Role-Based Pricing, Always Filter By All Products.

Ignore Shortcode Params

• Public label: Ignore Shortcode Params
• Location: Plugin Settings > Compatibility > Integration Compatibility
• Type: Toggle
• Default value: Off
• Shown when: Always.
• Availability: Free
• What it does: Ignores filter shortcode parameters where compatibility requires global or saved settings to win.
• When to use: Use it when embedded filter parameters conflict with the intended global configuration.
• Side effects / performance notes: Existing embedded filters may change behavior if they rely on shortcode-level parameters.
• Related options: Force Show Only This Filter, Remember Filter Selection, URL Mode.

Page Builder

• Public label: Page Builder
• Location: Plugin Settings > Compatibility > Integration Compatibility
• Type: Select
• Default value: Auto / Elementor / Divi / Bricks / Other
• Shown when: Always.
• Availability: Free
• What it does: Selects or auto-detects page-builder compatibility behavior.
• When to use: Choose the builder explicitly when Auto detection does not produce reliable AJAX updates or layout behavior.
• Side effects / performance notes: Builder-specific modes can change selectors, rendering hooks, or frontend initialization timing.
• Related options: Products Container Selector, Force Theme Templates, Theme Compatibility Mode.

WPML Polylang

• Public label: WPML / Polylang
• Location: Plugin Settings > Compatibility > Integration Compatibility
• Type: Toggle
• Default value: Off
• Shown when: Always.
• Availability: Free
• What it does: Enables compatibility behavior for multilingual stores using WPML or Polylang.
• When to use: Use it when filtered URLs, labels, or taxonomy values need multilingual handling.
• Side effects / performance notes: Multilingual catalogs should be tested per language because slugs, counts, and URLs can differ.
• Related options: Show Category Slugs, Apply Params From URL, Category Filter Robots.

Browser Back Button

• Public label: Browser Back Button
• Location: Plugin Settings > Compatibility > Integration Compatibility
• Type: Toggle
• Default value: Off
• Shown when: Always.
• Availability: Free
• What it does: Enables compatibility behavior for browser back and forward navigation with filtered states.
• When to use: Use it when shoppers expect filtering history to work with browser navigation.
• Side effects / performance notes: History behavior depends on URL mode and AJAX updates.
• Related options: URL Mode, Apply Params From URL, Pagination Selector.

Theme Compatibility Mode

• Public label: Theme Compatibility Mode
• Location: Plugin Settings > Compatibility > Integration Compatibility
• Type: Toggle
• Default value: Off
• Shown when: Always.
• Availability: Free
• What it does: Enables broader theme compatibility behavior for rendering and frontend updates.
• When to use: Use it when theme markup or scripts interfere with normal filtering.
• Side effects / performance notes: Compatibility mode can change rendering paths and should be tested after theme updates.
• Related options: Force Theme Templates, Products Container Selector, Exclude from JS Optimization.

Prevent Empty Results Redirect

• Public label: Prevent Empty Results Redirect
• Location: Plugin Settings > Compatibility > Integration Compatibility
• Type: Toggle
• Default value: Off
• Shown when: Always.
• Availability: Free
• What it does: Prevents redirects when filtering produces no products.
• When to use: Use it when the theme or another plugin redirects empty catalog states unexpectedly.
• Side effects / performance notes: Empty results should still show a clear message so shoppers understand what happened.
• Related options: No Products Found Message, No Redirect If Empty, Redirect After Selection.