wp_nonce_tick() – Function | Developer.WordPress.org

Returns the time-dependent variable for nonce creation.

Description

A nonce has a lifespan of two ticks. Nonces in their second tick may be updated, e.g. by autosave.

Parameters

$actionstring|intoptional: The nonce action.
Default:-1

Return

float Float value rounded up to the next highest integer.

Source

function wp_nonce_tick( $action = -1 ) {	/** * Filters the lifespan of nonces in seconds. * * @since 2.5.0 * @since 6.1.0 Added `$action` argument to allow for more targeted filters. * * @param int $lifespan Lifespan of nonces in seconds. Default 86,400 seconds, or one day. * @param string|int $action The nonce action, or -1 if none was provided. */	$nonce_life = apply_filters( 'nonce_life', DAY_IN_SECONDS, $action );	return ceil( time() / ( $nonce_life / 2 ) ); }

View all references View on Trac View on GitHub

Hooks

apply_filters( ‘nonce_life’, int $lifespan, string|int $action ): Filters the lifespan of nonces in seconds.

Uses	Description
apply_filters()`wp-includes/plugin.php`	Calls the callback functions that have been added to a filter hook.

Used by	Description
wp_verify_nonce()`wp-includes/pluggable.php`	Verifies that a correct security nonce was used with time limit.
wp_create_nonce()`wp-includes/pluggable.php`	Creates a cryptographic token tied to a specific action, user, user session, and window of time.

Changelog

Version	Description
6.1.0	Added `$action` argument.
2.5.0	Introduced.

User Contributed Notes

Skip to note 2 content

Roy Orbitson 4 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

The mathematics of this function actually only guarantees a nonce’s lifespan to be half of the nonce_life filtered value but may be up to that value (minus 1 second), depending on the time of day it was generated.

See my comment on verifying nonces.

Log in to add feedback

wp_nonce_tick( string|int $action = -1 ): float

In this article