Przejdź do głównej zawartości

Reguły i warunki wykluczeń w Pagelean

Ten poradnik stanowi kompletne omówienie reguł warunkowych, obsługi zależności skryptów oraz opcji wyrejestrowywania w Pagelean.

Podczas tworzenia reguły lista Usuń gdy (Remove when) decyduje o tym, na jakich podstronach Pagelean wywoła wp_dequeue_script lub wp_dequeue_style:

Warunek Logika dopasowania Typowe zastosowanie
Wszędzie (Everywhere) Obejmuje wszystkie żądania na froncie (! is_admin()). Całkowite wyłączenie zbędnego pliku bez deaktywacji całej wtyczki.
Na stronie głównej (On the front page) Odpowiada is_front_page(). Usunięcie ciężkich suwaków, widgetów blogowych lub skryptów galerii ze strony startowej.
Na indeksie wpisów bloga (On the blog posts index) Odpowiada is_home(). Usunięcie skryptów sklepowych z listy wpisów blogowych.
Na pojedynczych wpisach/stronach o podanych ID Odpowiada is_singular() dla podanych ID. Przy pustym polu ID dopasowuje wszystkie pojedyncze wpisy i strony. Wyłączenie skryptów builderów lub galerii z konkretnych artykułów.
Z wyjątkiem pojedynczych wpisów/stron o podanych ID Odwrócenie warunku: wyłącza zasób wszędzie poza wskazanymi ID. Niezbędne dla wtyczek formularzy kontaktowych lub systemów rezerwacji potrzebnych tylko na 1 lub 2 podstronach.
Na urządzeniach mobilnych (On mobile devices) Odpowiada wp_is_mobile(). Wyłączenie ciężkich animacji kursora, efektów najechania myszą lub suwaków na telefonach.
Na komputerach (On desktop devices) Odpowiada ! wp_is_mobile(). Wyłączenie skryptów nawigacji mobilnej na ekranach stacjonarnych.
Na pojedynczych wpisach typu postu Odpowiada is_singular($post_type) dla wybranego typu postu. Wyłączenie skryptów sklepowych na stronach bazy wiedzy lub w portfolio.
Na stronie sklepu WooCommerce Odpowiada is_shop(). Usunięcie skryptów pojedynczych produktów z głównego katalogu.
Na stronach produktów WooCommerce Odpowiada is_product(). Wyłączenie skryptów filtrów katalogowych z kart produktów.
W koszyku WooCommerce Odpowiada is_cart(). Usunięcie niepowiązanych widgetów i narzędzi z widoku koszyka.
W kasie WooCommerce Odpowiada is_checkout() && ! is_order_received_page(). Usunięcie zbędnych skryptów z procesu finalizacji zamówienia w celu maksymalizacji konwersji.

Uwaga: Warunki powiązane z WooCommerce wyświetlają się na liście wyłącznie wtedy, gdy WooCommerce jest aktywne.

Wyłączenie z kolejki a wyrejestrowanie: Zależności skryptów

Dział zatytułowany „Wyłączenie z kolejki a wyrejestrowanie: Zależności skryptów”

WordPress zarządza skryptami i arkuszami stylów w formie drzewa zależności. Jeśli skrypt A deklaruje skrypt B jako wymaganą zależność ($deps = ['skrypt-b']), WordPress automatycznie załaduje skrypt B, gdy skrypt A trafi do kolejki.

1. Standardowe wyłączenie z kolejki (wp_dequeue_script)

Dział zatytułowany „1. Standardowe wyłączenie z kolejki (wp_dequeue_script)”

Domyślnie Pagelean wywołuje funkcje wp_dequeue_script($handle) oraz wp_dequeue_style($handle) z priorytetem 100 na akcji wp_enqueue_scripts.

  • Informuje to WordPressa, aby nie dołączał danego pliku w kodzie HTML strony.
  • Zachowanie przy zależnościach: Jeśli inny aktywny na stronie skrypt wymaga wyłączonego pliku jako zależności, WordPress uszanuje tę zależność i mimo to wygeneruje znacznik pliku.

2. Opcja “Wyrejestruj również” (Also deregister)

Dział zatytułowany „2. Opcja “Wyrejestruj również” (Also deregister)”

Gdy w regule zaznaczysz pole Wyrejestruj również (Also deregister):

  • Pagelean wykonuje dodatkowo wp_deregister_script($handle) oraz wp_deregister_style($handle).
  • Całkowicie usuwa to uchwyt z rejestru zarejestrowanych zasobów WordPressa ($wp_scripts lub $wp_styles).
  • Zachowanie przy zależnościach: Plik nie zostanie załadowany nawet wtedy, gdy inny skrypt go wymaga. Jeśli inny skrypt bezwzględnie oczekiwał tego zasobu, w konsoli przeglądarki może pojawić się błąd.
  • Dobra praktyka: Zawsze zaczynaj od zwykłego wyłączenia z kolejki. Zaznaczaj wyrejestrowanie tylko wtedy, gdy plik nadal się ładuje z powodu agresywnych zależności, i upewnij się, że nie wywołuje to błędów w konsoli.
  1. Podpowiedzi w panelu: Przeglądaj stronę jako zalogowany administrator. Pagelean zapisuje identyfikatory ładowanych zasobów. Podczas dodawania reguły pole uchwytu automatycznie podpowiada zarejestrowane nazwy.
  2. Narzędzia deweloperskie w przeglądarce:
    • Otwórz konsolę (F12) i przejdź do widoku źródła strony lub elementów DOM.
    • Odszukaj znacznik <script src="..."> lub <link rel="stylesheet" href="...">.
    • Sprawdź atrybut id: WordPress dodaje końcówkę -js do skryptów oraz -css do stylów.
    • Przykład: ID contact-form-7-css oznacza uchwyt contact-form-7.
    • Przykład: ID wc-cart-fragments-js oznacza uchwyt wc-cart-fragments.