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.
Tabela dostępnych warunków
Dział zatytułowany „Tabela dostępnych warunków”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)orazwp_deregister_style($handle). - Całkowicie usuwa to uchwyt z rejestru zarejestrowanych zasobów WordPressa (
$wp_scriptslub$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.
Jak odnaleźć nazwę uchwytu (handle)?
Dział zatytułowany „Jak odnaleźć nazwę uchwytu (handle)?”- 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.
- 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ę-jsdo skryptów oraz-cssdo stylów. - Przykład: ID
contact-form-7-cssoznacza uchwytcontact-form-7. - Przykład: ID
wc-cart-fragments-jsoznacza uchwytwc-cart-fragments.