wp_validate_user_request_key

函数


      wp_validate_user_request_key ( $request_id, $key )

参数

(string) $request_id ID of the request being confirmed.

Required: 是
(string) $key Provided key to validate.

Required: 是

返回值

(true|WP_Error) True on success, WP_Error on failure.

定义位置

wp-includes/user.php , line 4826

相关方法: wp_generate_user_request_key wp_create_user_request wp_get_user_request wp_send_user_request wp_get_user_request_data

引入: 4.9.6

弃用: -

wp_validate_user_request_key是一个WordPress的函数，用来验证一个用户的请求密钥: 这个函数与GDPR和CCPA一起使用，以确保用户请求是有效的，并且请求密钥没有被欺诈性地使用: 该函数将请求密钥作为其输入，如果密钥有效则返回真，如果无效则返回假。

通过比较密钥和请求的密钥来验证一个用户请求。

function wp_validate_user_request_key( $request_id, $key ) {
	global $wp_hasher;

	$request_id       = absint( $request_id );
	$request          = wp_get_user_request( $request_id );
	$saved_key        = $request->confirm_key;
	$key_request_time = $request->modified_timestamp;

	if ( ! $request || ! $saved_key || ! $key_request_time ) {
		return new WP_Error( 'invalid_request', __( 'Invalid personal data request.' ) );
	}

	if ( ! in_array( $request->status, array( 'request-pending', 'request-failed' ), true ) ) {
		return new WP_Error( 'expired_request', __( 'This personal data request has expired.' ) );
	}

	if ( empty( $key ) ) {
		return new WP_Error( 'missing_key', __( 'The confirmation key is missing from this personal data request.' ) );
	}

	if ( empty( $wp_hasher ) ) {
		require_once ABSPATH . WPINC . '/class-phpass.php';
		$wp_hasher = new PasswordHash( 8, true );
	}

	/**
	 * Filters the expiration time of confirm keys.
	 *
	 * @since 4.9.6
	 *
	 * @param int $expiration The expiration time in seconds.
	 */
	$expiration_duration = (int) apply_filters( 'user_request_key_expiration', DAY_IN_SECONDS );
	$expiration_time     = $key_request_time + $expiration_duration;

	if ( ! $wp_hasher->CheckPassword( $key, $saved_key ) ) {
		return new WP_Error( 'invalid_key', __( 'The confirmation key is invalid for this personal data request.' ) );
	}

	if ( ! $expiration_time || time() > $expiration_time ) {
		return new WP_Error( 'expired_key', __( 'The confirmation key has expired for this personal data request.' ) );
	}

	return true;
}

常见问题

FAQs

如何使用add_action添加一个钩子函数？
在WordPress中，你可以使用 add_action 函数添加一个钩子函数。钩子函数是在特定事件发生时自动触发的函数。

add_action 函数的第一个参数是钩子名称，第二个参数是要执行的函数名，第三个参数是函数的优先级（可选）。

例如，添加一个在文章保存后执行的钩子函数的代码如下：
```
function my_save_post_function( $post_ID, $post ) {  
    // 执行你的代码  
}  
add_action( 'save_post', 'my_save_post_function', 10, 2 );
```
这里， save_post 是钩子名称， my_save_post_function 是要执行的函数名，10是函数的优先级，2是传递给钩子函数的参数数量。
如何使用wp_reset_query重置查询？
wp_reset_query() 函数用于重置WordPress的查询。在自定义查询或修改查询参数之后，你可能需要使用这个函数来重置到默认的查询。例如：
```
// 自定义查询  
$args = array(  
    'post_type' => 'product',  
    'posts_per_page' => 10,  
);  
$custom_query = new WP_Query($args);  
  
// 重置查询  
wp_reset_query();
```
如何创建自定义的WordPress插件？
创建自定义的WordPress插件需要以下步骤：
- 创建一个新的文件夹，用于存放插件文件。
- 在文件夹中创建一个名为plugin-name.php的文件，这是插件的主要文件。
- 在plugin-name.php文件中添加插件的基本信息，例如名称、版本、描述等。
- 编写插件的功能代码，例如添加自定义文章类型、自定义字段、自定义页面等。
- 将文件夹上传到WordPress的wp-content/plugins目录下。
- 在WordPress后台激活插件。

如何使用get_post和get_page获取单个文章或页面的详细信息？

使用 get_post 和 get_page 获取单个文章或页面的详细信息：

// 获取文章或页面的ID  
$post_id = get_the_ID();  
  
// 获取文章或页面的详细信息  
$post = get_post($post_id);  
  
// 获取文章或页面的标题  
$title = $post->post_title;  
  
// 获取文章或页面的内容  
$content = $post->post_content;

wp_enqueue_script和wp_enqueue_style函数如何使用？
wp_enqueue_script 和 wp_enqueue_style 函数的使用：
- wp_enqueue_script() ：此函数位于wp-includes/script-loader.php文件中。它会将JavaScript文件添加到WordPress网站的页脚中。您可以在主题的functions.php文件中调用此函数，以添加自定义的JavaScript文件。
- wp_enqueue_style() ：此函数位于wp-includes/script-loader.php文件中。它会将CSS文件添加到WordPress网站的部分中。您可以在主题的functions.php文件中调用此函数，以添加自定义的CSS文件。
如何使用wp_head和wp_footer在主题中添加自定义内容？
使用 wp_head 和 wp_footer 在主题中添加自定义内容：
- wp_head() ：此函数位于wp-includes/general-template.php文件中。它会在文档的部分中输出内容。您可以在主题的header.php文件中调用此函数，以在部分中添加自定义内容。
- wp_footer() ：此函数位于wp-includes/general-template.php文件中。它会在文档的部分中输出内容。您可以在主题的footer.php文件中调用此函数，以在部分中添加自定义内容。

wp_validate_user_request_key

常见问题

相关文章