{"id":511,"date":"2026-09-28T17:45:00","date_gmt":"2026-09-28T15:45:00","guid":{"rendered":"https:\/\/www.lukaswojcik.com\/?page_id=511"},"modified":"2026-09-25T15:07:51","modified_gmt":"2026-09-25T13:07:51","slug":"optymalizacja-wydajnosci-przez-functions-php-selektywne-wyrejestrowywanie","status":"publish","type":"post","link":"https:\/\/www.lukaswojcik.com\/blog\/pl\/wordpress-plugins-tricks-pl\/tutorials-pl-wordpress-plugins-tricks-pl\/optymalizacja-wydajnosci-przez-functions-php-selektywne-wyrejestrowywanie\/","title":{"rendered":"Optymalizacja wydajno\u015bci przez functions.php: Selektywne wyrejestrowywanie skrypt\u00f3w wtyczek WordPressa"},"content":{"rendered":"

Przegl\u0105d architektury: Mechanizm zarz\u0105dzania zasobami w WordPressie<\/h2>\n

Wsp\u00f3\u0142czesne instalacje WordPressa nierzadko zmagaj\u0105 si\u0119 z nadmiarem kodu CSS i JavaScript generowanym przez wtyczki firm trzecich. Domy\u015blnie wiele zaawansowanych rozszerze\u0144 \u2013 takich jak platformy e-commerce, generatory formularzy czy narz\u0119dzia do kolorowania sk\u0142adni \u2013 rejestruje i \u0142aduje swoje statyczne zasoby globalnie na ka\u017cdym adresie URL w warstwie frontowej. Bezwarunkowe \u0142adowanie plik\u00f3w zwi\u0119ksza rozmiar struktury DOM, generuje niepotrzebne \u017c\u0105dania HTTP i obni\u017ca wska\u017aniki Core Web Vitals, w tym Largest Contentful Paint (LCP) oraz Interaction to Next Paint (INP).<\/p>\n

W WordPressie w wersji 7.0.2 cykl \u017cycia zasob\u00f3w opiera si\u0119 na klasach WP_Scripts<\/code> oraz WP_Styles<\/code>. Pliki s\u0105 dodawane do kolejki podczas wykonywania akcji wp_enqueue_scripts<\/code>. W celu wyeliminowania zb\u0119dnych zasob\u00f3w z przegl\u0105darki bez naruszania funkcjonalno\u015bci wtyczek na stronach docelowych, konieczne jest wdro\u017cenie selektywnego wyrejestrowywania (dequeuing) z poziomu pliku functions.php<\/code> aktywnego motywu lub za pomoc\u0105 wtyczki Must-Use (MU-plugin).<\/p>\n

\n\"Tabela
WordPress \u0142aduje ka\u017cdy zas\u00f3b wtyczki na ka\u017cdej stronie, dop\u00f3ki nikt nie zareaguje. Tabela pokazuje, kt\u00f3ry uchwyt jest gdzie naprawd\u0119 potrzebny; reszta wylatuje warunkowo.<\/figcaption><\/figure>\n

Instrukcja wdro\u017cenia krok po kroku<\/h2>\n

Krok 1: Audyt i identyfikacja zarejestrowanych uchwyt\u00f3w (Handles)<\/h3>\n

Przed usuni\u0119ciem zasobu z kolejki nale\u017cy zidentyfikowa\u0107 jego unikalny uchwyt (handle). WordPress przypisuje okre\u015blony ci\u0105g znak\u00f3w do ka\u017cdego arkusza styl\u00f3w i pliku skryptu podczas rejestracji funkcjami wp_register_script()<\/code> lub wp_register_style()<\/code>.<\/p>\n

W celu sprawdzenia uchwyt\u00f3w za\u0142adowanych na danym adresie URL, mo\u017cliwe jest tymczasowe dodanie poni\u017cszego kodu diagnostycznego do pliku functions.php<\/code>, co spowoduje zapisanie listy aktywnych skrypt\u00f3w do logu serwera PHP:<\/p>\n

add_action( 'wp_print_scripts', function() {\n    if ( ! is_admin() ) {\n        global $wp_scripts;\n        error_log( 'Enqueued Scripts: ' . implode( ', ', $wp_scripts->queue ) );\n    }\n}, 9999 );\n\nadd_action( 'wp_print_styles', function() {\n    if ( ! is_admin() ) {\n        global $wp_styles;\n        error_log( 'Enqueued Styles: ' . implode( ', ', $wp_styles->queue ) );\n    }\n}, 9999 );<\/code><\/pre>\n
Krok 2: Priorytety hak\u00f3w (Hooks) i kontekst wywo\u0142ania<\/h3>\n
Pr\u00f3ba usuni\u0119cia zasobu przed jego za\u0142adowaniem przez wtyczk\u0119 ko\u0144czy si\u0119 niepowodzeniem. Wi\u0119kszo\u015b\u0107 standardowych wtyczek podpina funkcje \u0142aduj\u0105ce pod hak wp_enqueue_scripts<\/code> z domy\u015blnym priorytetem 10<\/code>.<\/p>\n
Z tego wzgl\u0119du funkcja usuwaj\u0105ca musi zosta\u0107 powi\u0105zana z hakiem wp_enqueue_scripts<\/code> z wy\u017cszym priorytetem liczbowym (np. 100<\/code> lub 999<\/code>). Gwarantuje to wykonanie procedury czyszcz\u0105cej dopiero po zako\u0144czeniu rejestracji zasob\u00f3w przez wtyczki.<\/p>\n
Krok 3: Programowanie logiki selektywnego wyrejestrowywania<\/h3>\n
Kluczowe funkcje s\u0142u\u017c\u0105ce do usuwania zasob\u00f3w z kolejki WordPressa to:<\/p>\n