函数文档

_wp_privacy_account_request_confirmed()

💡 云策文档标注

概述

此函数用于在隐私请求被确认时更新相关日志。它通过检查请求状态并更新时间戳和状态来实现。

关键要点

  • 函数名:_wp_privacy_account_request_confirmed()
  • 参数:$request_id(整数,必需),表示请求的ID
  • 功能:更新请求的确认时间戳和状态为'request-confirmed'
  • 条件:仅当请求状态为'request-pending'或'request-failed'时执行
  • 相关函数:wp_get_user_request(), wp_update_post(), update_post_meta()

代码示例

function _wp_privacy_account_request_confirmed( $request_id ) {
    $request = wp_get_user_request( $request_id );

    if ( ! $request ) {
        return;
    }

    if ( ! in_array( $request->status, array( 'request-pending', 'request-failed' ), true ) ) {
        return;
    }

    update_post_meta( $request_id, '_wp_user_request_confirmed_timestamp', time() );
    wp_update_post(
        array(
            'ID'          => $request_id,
            'post_status' => 'request-confirmed',
        )
    );
}

注意事项

  • 此函数在WordPress 4.9.6版本中引入
  • 确保传入有效的$request_id,否则函数可能提前返回
  • 状态更新依赖于wp_update_post()和update_post_meta()函数

📄 原文内容

Updates log when privacy request is confirmed.

Parameters

$request_idintrequired
ID of the request.

Source

function _wp_privacy_account_request_confirmed( $request_id ) {
	$request = wp_get_user_request( $request_id );

	if ( ! $request ) {
		return;
	}

	if ( ! in_array( $request->status, array( 'request-pending', 'request-failed' ), true ) ) {
		return;
	}

	update_post_meta( $request_id, '_wp_user_request_confirmed_timestamp', time() );
	wp_update_post(
		array(
			'ID'          => $request_id,
			'post_status' => 'request-confirmed',
		)
	);
}

Changelog

Version Description
4.9.6 Introduced.