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 3 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