Szanujemy Twoją prywatność

Używamy plików cookies niezbędnych do działania strony. Za Twoją zgodą korzystamy też z cookies analitycznych (Google Analytics), żeby wiedzieć, co ulepszać, i marketingowych (piksel Meta, Google Ads), żeby mierzyć skuteczność reklam. Możesz zaakceptować wszystkie, odrzucić wszystkie albo wybrać samodzielnie. Polityka prywatności.

Hasło w słowniku

Nonce w WordPress: co to znaczy i jak działa

Nonce (wymowa: nons, od angielskiego number used once, czyli „liczba użyta raz”) to w informatyce wartość, która ma potwierdzić, że żądanie jest świeże i wysłane świadomie. W WordPressie nonce to krótki kod dołączany do formularzy i linków. Chroni przed atakiem CSRF, czyli wykonaniem akcji w Twoim imieniu bez Twojej wiedzy, np. przez podstawiony link w mailu.

Nazwa jest myląca: nonce w WordPressie nie jest liczbą ani wartością jednorazową. To ciąg liter i cyfr, który można użyć wiele razy, dopóki nie wygaśnie.

Do czego służy nonce

Nonce sprawdza intencję. Gdy klikasz „Usuń wpis” albo zapisujesz ustawienia wtyczki, WordPress porównuje kod z formularza lub linku z kodem, który wyliczył dla Ciebie i tej akcji. Jeśli kod się nie zgadza albo go brakuje, operacja zostaje przerwana z błędem 403.

Jak działa nonce w WordPressie

  • Kod powstaje z nazwy akcji (np. delete-post_123), zalogowanego użytkownika, jego sesji i czasu.
  • Domyślnie nonce jest ważny dobę. WordPress dzieli ten czas na dwa okresy i przyjmuje kod z bieżącego albo poprzedniego okresu, więc w praktyce kod wygasa po 12 do 24 godzinach. Długość zmienisz filtrem nonce_life.
  • Kod jest związany z sesją. Po wylogowaniu i ponownym zalogowaniu nonce zapisane na otwartej karcie przestają działać.
  • Niezalogowani odwiedzający mają w WordPressie ten sam identyfikator (0), więc dla tej samej akcji dostają ten sam kod. Zmienia to filtr nonce_user_logged_out.

Jak użyć nonce w kodzie

Kod tworzysz jedną z trzech funkcji, zależnie od tego, gdzie ma trafić:

// Formularz: ukryte pole z nonce i adresem odsyłającym
wp_nonce_field( 'zapisz_ustawienia', 'moj_nonce' );

// Link: nonce doklejony do adresu jako parametr _wpnonce
$url = wp_nonce_url( admin_url( 'admin-post.php?action=wyczysc_cache' ), 'wyczysc_cache' );

// Sam kod, np. do wysłania w żądaniu AJAX
$nonce = wp_create_nonce( 'moj_ajax' );

Po stronie serwera sprawdzasz go tak:

// Formularz w panelu: sprawdza nonce i adres odsyłający, przy błędzie kończy z kodem 403
check_admin_referer( 'zapisz_ustawienia', 'moj_nonce' );

// Żądanie AJAX
check_ajax_referer( 'moj_ajax' );

// Własna logika: wp_verify_nonce() zwraca false, gdy kod jest nieprawidłowy
$kod = isset( $_POST['moj_nonce'] ) ? sanitize_text_field( wp_unslash( $_POST['moj_nonce'] ) ) : '';
if ( ! wp_verify_nonce( $kod, 'zapisz_ustawienia' ) ) {
    wp_die( 'Nieprawidłowe żądanie.' );
}

Nonce to nie są uprawnienia

Dokumentacja WordPressa mówi wprost, że nonce nie służy do uwierzytelniania ani kontroli dostępu. Kod potwierdza tylko, że żądanie wyszło z Twojej strony. Czy dana osoba może wykonać akcję, sprawdzasz osobno funkcją current_user_can():

if ( ! current_user_can( 'manage_options' ) ) {
    wp_die( 'Brak uprawnień.' );
}
check_admin_referer( 'zapisz_ustawienia', 'moj_nonce' );

Oba zabezpieczenia, nonce i sprawdzenie uprawnień, warto skontrolować w każdej wtyczce wygenerowanej przez AI. Jak to zrobić, pokazuję w poradniku jak sprawdzić wtyczkę WordPress napisaną przez AI.

Kiedy nonce sprawia kłopot

  • Karta otwarta długo. Formularz wysłany po ponad 12 do 24 godzinach od wczytania strony zostanie odrzucony. Rozwiązanie: odświeżyć stronę przed wysłaniem.
  • Cache całych stron. Jeśli serwer albo CDN zapamięta stronę razem z nonce, po wygaśnięciu kodu formularz może przestać działać dla wszystkich odwiedzających. Strony z formularzami wyłącz z cache albo pobieraj nonce osobnym żądaniem.
  • Powtórzenie żądania. WordPress nie sprawdza, czy kod został już użyty, więc nonce nie chroni przed ponownym wysłaniem tego samego żądania w czasie ważności.

Powiązane hasła i poradniki

Jak jest nonce po polsku?

Nie ma przyjętego polskiego odpowiednika. Dosłownie to „liczba użyta raz”, a w tekstach o bezpieczeństwie stron pisze się po prostu nonce albo token jednorazowy, choć w WordPressie nie jest on jednorazowy.

Ile ważny jest nonce w WordPressie?

Domyślnie dobę, a w praktyce od 12 do 24 godzin, bo WordPress przyjmuje kod z bieżącego i poprzedniego okresu ważności. Czas zmienia filtr nonce_life.

Źródła: WordPress Developer: Nonces. Hasło zaktualizowane 19 października 2026.

Z bloga

Najnowsze poradniki

Wszystkie wpisy