wp_nonce_url( string $actionurl, int|string $action = -1, string $name = '_wpnonce' ): string

Parameters

$actionurlstring

URL to add nonce action.

$actionint|stringoptional

Nonce action name. Default -1.Default: -1

$namestringoptional

Nonce name. Default '_wpnonce'.Default: '_wpnonce'

Return

string

Escaped URL with nonce action added.

Uses · 3

• esc_html()Escaping for HTML blocks.
• add_query_arg()Retrieves a modified URL query string.
• wp_create_nonce()Creates a cryptographic token tied to a specific action, user, user session, and window of time.

Used by · 50

• Plugin_Installer_Skin::after()Performs an action following a plugin install.
• Plugin_Installer_Skin::do_overwrite()Checks if the plugin can be overwritten and outputs the HTML for overwriting a plugin on upload.
• Plugin_Upgrader_Skin::after()Performs an action following a single plugin update.
• Theme_Installer_Skin::after()Performs an action following a single theme install.
• Theme_Installer_Skin::do_overwrite()Checks if the theme can be overwritten and outputs the HTML for overwriting a theme on upload.
• Theme_Upgrader_Skin::after()Performs an action following a single theme update.
• WP_Links_List_Table::handle_row_actions()Generates and displays row action links.
• WP_MS_Sites_List_Table::handle_row_actions()Generates and displays row action links.
• WP_MS_Themes_List_Table::column_autoupdates()Handles the auto-updates column output.
• WP_MS_Themes_List_Table::column_name()Handles the name column output.
• WP_MS_Users_List_Table::handle_row_actions()Generates and displays row action links.
• WP_Media_List_Table::_get_row_actions()Gets the row actions for a media item.

Source

View on Trac ↗View on GitHub ↗

1875function wp_nonce_url( $actionurl, $action = -1, $name = '_wpnonce' ) {1876	$actionurl = str_replace( '&', '&', $actionurl );1877	return esc_html( add_query_arg( $name, wp_create_nonce( $action ), $actionurl ) );1878}

History

Introduced in 2.0.4. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 7.1.0 tag, from src/wp-includes/functions.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.