WooCommerce分页功能异常求助：空白页及产品错位问题

Hey there, let's tackle this frustrating pagination problem you're facing—blank pages, misplaced products, and those empty product blocks are super common when combining WooCommerce's default pagination with the WOOF filter plugin. Here's a step-by-step breakdown to get things working right:

1. Sync WOOF & WooCommerce Pagination Settings #

First, make sure your plugin and core WooCommerce settings are aligned—this is the most frequent culprit:

• Go to WOOF Plugin Settings > Pagination and ensure it's set to use WooCommerce's default pagination (not a custom WOOF-only option).
• Check that the "Products per page" value in WOOF matches what's set in WooCommerce > Settings > Products > Display under "Products per page". Mismatched numbers here will throw off pagination calculations, leading to empty blocks or products showing up on the wrong page.

2. Fix Query Parameter Conflicts #

WOOF modifies the WP_Query parameters, which can break how pagination counts products. Add this code snippet (use a code snippet plugin instead of editing your theme's functions.php directly to avoid data loss) to force consistent query settings:

add_action('pre_get_posts', 'fix_woof_pagination_conflict');
function fix_woof_pagination_conflict($query) {
    if (!is_admin() && $query->is_main_query() && (is_shop() || is_product_category() || is_product_tag())) {
        if (isset($_GET['woof']) && !empty($_GET['woof'])) {
            $query->set('paged', get_query_var('paged'));
            $query->set('posts_per_page', get_option('posts_per_page'));
        }
    }
}

This ensures that when WOOF filters are active, the main query uses the correct pagination and products-per-page values from your WooCommerce settings.

3. Test for Theme Conflicts #

Some custom themes override WooCommerce's pagination template with buggy code. Try temporarily switching to the default Storefront theme:

• If pagination works correctly with Storefront, your theme's custom pagination template (usually located at woocommerce/loop/pagination.php) is the issue. Check that it properly calls woocommerce_pagination() and calculates max_num_pages correctly.

4. Rule Out Other Plugin Conflicts #

Disable all plugins except WooCommerce and WOOF, then test pagination again. If it works, re-enable plugins one by one to find which one is causing the conflict. Common culprits include caching plugins, SEO tools, or other product display plugins that modify query logic.

5. Clear Caches & Check Product Statuses #

• Clear WooCommerce transients: Go to WooCommerce > Status > Tools > Clear transients to wipe old pagination-related cache data.
• If you use a site-wide cache plugin, clear that too—stale cache often causes blank pages or misplaced products.
• Double-check your product statuses: Ensure no draft/private products are being counted in pagination totals but not displayed. Filter your product list by status to confirm only published products are included.

6. Verify WOOF Filter Rules #

If pagination works fine without WOOF filters but breaks when using them, your filter rules might be causing incorrect product counts. For example, a filter might hide products but still include them in the total page count, leading to blank pages. Test individual filters to see which one triggers the issue, then adjust the filter's settings to ensure it accurately counts visible products.

内容的提问来源于stack exchange，提问作者Yogesh Satale