HUSKY - Product Filter for WooCommerce

Przyspiesz duże filtry kategorii WooCommerce: Lazy-Load Slideout

Gdy masz kategorię nadrzędną z:

  • Dużą liczbą produktów (500-1000+)
  • Głęboką hierarchią kategorii (wielopoziomowe podkategorie)
  • Włączonym Dynamic Recount

Filtr produktów może generować setki zapytań SQL przy każdym ładowaniu strony, nawet jeśli użytkownik nigdy nie używa filtra. Powoduje to:

  • Wolne ładowanie strony (10+ sekund)
  • Błędy 504 Gateway Timeout
  • Wysokie obciążenie serwera
  • Słabe wrażenia użytkownika

Dlaczego tak się dzieje

Przy włączonym Dynamic Recount WOOF musi:

  1. Rekurencyjnie przetwarzać wszystkie kategorie potomne
  2. Wykonywać zapytania SQL dla każdego terminu, aby policzyć produkty
  3. Obliczać liczby z uwzględnieniem kontekstu bieżącej kategorii

Przykład: Kategoria “Okulary przeciwsłoneczne” z podkategoriami (Mężczyźni → Kobiety → Kształty → Marki) generuje ogromne obciążenie zapytań.

Tradycyjne rozwiązania (niewystarczające)

Ukrywanie wysuwanego panelu za pomocą CSS/reguł wyświetlania – Filtr nadal przetwarza na serwerze
Wyłączenie Dynamic Recount – Traci się ważną funkcjonalność
Usuwanie opcji filtra – Użytkownicy nie mogą prawidłowo filtrować
Indeksy bazy danych – Niewielka poprawa, nie rozwiązuje głównej przyczyny

Optymalne rozwiązanie: Wysuwany panel z leniwym ładowaniem

Kluczowa koncepcja: Ładuj filtr TYLKO wtedy, gdy użytkownik faktycznie otworzy wysuwany panel.

✅ Strona ładuje się błyskawicznie (brak przetwarzania filtra)
✅ Filtr działa idealnie, gdy jest potrzebny
✅ Brak marnowania zasobów serwera
✅ Idealne dla botów i przypadkowych przeglądających
✅ Zachowuje pełną funkcjonalność filtra

Implementacja

Dodaj poniższy kod do pliku functions.php swojego motywu:

/**
 * WOOF Lazy-Load Slideout Filter
 * Loads filter only when user clicks to open slideout
 * Solves performance issues with deep category hierarchies
 */
add_action('wp_footer', function () {
    // Only on product category pages (optional - remove condition to show everywhere)
    if (!is_product_category()) {
        //return;
    }
    ?>

    <!-- Slideout Trigger Button -->
    <div id="woof-slideout-trigger" style="position: fixed; right: 0; top: 50%; transform: translateY(-50%); z-index: 9999; cursor: pointer; background: #333; color: #fff; padding: 15px 10px; border-radius: 5px 0 0 5px; font-weight: bold; writing-mode: vertical-rl; text-orientation: mixed;">
        FILTERS
    </div>

    <!-- Slideout Panel -->
    <div id="woof-slideout-panel" style="position: fixed; right: -350px; top: 0; width: 350px; height: 100%; background: #fff; box-shadow: -2px 0 10px rgba(0,0,0,0.3); z-index: 9998; transition: right 0.3s ease; overflow-y: auto; padding: 20px;">
        
        <!-- Close Button -->
        <div style="text-align: right; margin-bottom: 15px;">
            <span id="woof-slideout-close" style="cursor: pointer; font-size: 24px; font-weight: bold;">✖</span>
        </div>

        <!-- WOOF Filter with autohide - loads only on first click -->
        <?php echo do_shortcode('[woof autohide=0 start_filtering_btn=1]'); ?>
    </div>

    <!-- Background Overlay -->
    <div id="woof-slideout-overlay" style="position: fixed; top: 0; left: 0; width: 100%; height: 100%; background: rgba(0,0,0,0.5); z-index: 9997; display: none;"></div>

    <script>
        jQuery(document).ready(function ($) {
            var $trigger = $('#woof-slideout-trigger');
            var $panel = $('#woof-slideout-panel');
            var $overlay = $('#woof-slideout-overlay');
            var $close = $('#woof-slideout-close');
            var filterLoaded = false;

            // Open slideout
            $trigger.on('click', function () {
                $panel.css('right', '0');
                $overlay.fadeIn(300);

                // Auto-trigger WOOF "Start Filtering" button on first open
                if (!filterLoaded) {
                    setTimeout(function () {
                        var $woofBtn = $('.woof_start_filtering_btn');
                        if ($woofBtn.length) {
                            $woofBtn.trigger('click');
                            // Hide the button after triggering
                            $woofBtn.hide();
                            filterLoaded = true;
                        }
                    }, 500);
                }
            });

            // Close slideout
            function closeSlideout() {
                $panel.css('right', '-350px');
                $overlay.fadeOut(300);
            }

            $close.on('click', closeSlideout);
            $overlay.on('click', closeSlideout);
        });
    </script>

    <?php
}, 999);

Kroki konfiguracji

  1. Wyłącz obecny wysuwany panel w ustawieniach WOOF, jeśli jest włączony
  2. Dodaj powyższy kod do pliku functions.php aktywnego motywu
  3. Pozostaw włączone te ustawienia WOOF:
    • Cache dynamic recount: Tak
    • Cache terms: Tak
    • Hide empty terms: Tak
    • Dynamic Recount: Tak
  4. Opcjonalna personalizacja:
    • Dostosuj szerokość wysuwanego panelu: zmień width: 350px i right: -350px
    • Zmień położenie przycisku: modyfikuj top: 50%
    • Dostosuj kolory: zaktualizuj wartości background i color
    • Aby działało na całej stronie: usuń warunek if (!is_product_category())

Jak to działa

  1. Ładowanie strony: Renderowany jest tylko przycisk wyzwalający (brak przetwarzania filtra)
  2. Użytkownik klika przycisk: Wysuwany panel otwiera się, pojawia się nakładka
  3. Tylko przy pierwszym otwarciu: JavaScript automatycznie klika ukryty przycisk “Rozpocznij filtrowanie”
  4. Ładowanie filtra: WOOF przetwarza wszystkie zapytania i wyświetla opcje filtra
  5. Kolejne otwarcia: Filtr jest już załadowany, otwiera się natychmiast

Wyniki w rzeczywistych zastosowaniach

Przed:

  • Ładowanie strony: 10-15 sekund (lub błąd 504)
  • 500+ zapytań SQL na widok strony
  • Wysoki współczynnik odrzuceń

Po:

  • Ładowanie strony: < 2 sekund
  • Filtr ładuje się w ~3 sekundy (tylko na żądanie)
  • ~50% redukcja obciążenia serwera (wielu użytkowników nigdy nie otwiera filtra)

Zgodność

✅ Działa ze wszystkimi wersjami WOOF
✅ Zgodne z buforowaniem stron (WP Rocket, LiteSpeed itp.)
✅ Przyjazne dla urządzeń mobilnych
✅ Działa z dowolnym motywem WordPress

Zaawansowana personalizacja

Dopasuj do stylu swojego motywu:

/* Add to your theme's CSS */
#woof-slideout-trigger {
    background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
    font-family: 'Your Theme Font', sans-serif;
    letter-spacing: 2px;
}

#woof-slideout-panel {
    background: #f8f9fa;
    font-family: 'Your Theme Font', sans-serif;
}

#woof-slideout-trigger:hover {
    transform: translateY(-50%) scale(1.05);
}

Wysuwany panel po lewej stronie:

Zmień te wartości:

right: -350px  →  left: -350px
right: 0       →  left: 0
right: -350px  →  left: -350px

Kiedy stosować to rozwiązanie

Użyj wysuwanego panelu z leniwym ładowaniem, gdy:

  • Kategoria ma głęboką hierarchię (3+ poziomów)
  • 500+ produktów w kategorii
  • Wymagany jest Dynamic Recount
  • Czas ładowania strony > 5 sekund
  • Występują błędy 504

Alternatywa dla filtra w pasku bocznym

Jeśli wolisz pasek boczny zamiast wysuwanego panelu, użyj:

echo do_shortcode('[woof autohide=1 start_filtering_btn=1]');

Tworzy to przycisk “Rozpocznij filtrowanie” w pasku bocznym, który ładuje filtr po kliknięciu.


To rozwiązanie zapewnia najlepszą równowagę między wydajnością a funkcjonalnością, zapewniając szybkie ładowanie stron przy jednoczesnym zachowaniu pełnych możliwości filtrowania dla użytkowników, którzy ich potrzebują.

Odniesienie: https://pluginus.net/support/topic/performance-issue-504-timeouts-on-parent-category-with-deep-hierarchy-flatsome-theme/