函数文档

_wp_privacy_statuses()

💡 云策文档标注

概述

_wp_privacy_statuses() 函数返回隐私请求的状态数组,用于在 WordPress 隐私功能中管理请求状态。该函数定义了一个关联数组,键为状态标识符,值为翻译后的状态标签。

关键要点

  • 函数返回一个字符串数组,键为隐私请求状态(如 'request-pending'),值为对应的翻译标签。
  • 状态包括:'request-pending'(待处理)、'request-confirmed'(已确认)、'request-failed'(失败)、'request-completed'(已完成)。
  • 使用 _x() 函数进行带上下文的翻译,确保标签在 'request status' 上下文中正确显示。
  • 该函数自 WordPress 4.9.6 版本引入,主要用于 WP_Privacy_Requests_Table 类中的视图生成。

代码示例

function _wp_privacy_statuses() {
    return array(
        'request-pending'   => _x( 'Pending', 'request status' ),
        'request-confirmed' => _x( 'Confirmed', 'request status' ),
        'request-failed'    => _x( 'Failed', 'request status' ),
        'request-completed' => _x( 'Completed', 'request status' ),
    );
}

📄 原文内容

Returns statuses for privacy requests.

Return

string[] Array of privacy request status labels keyed by their status.

Source

function _wp_privacy_statuses() {
	return array(
		'request-pending'   => _x( 'Pending', 'request status' ),      // Pending confirmation from user.
		'request-confirmed' => _x( 'Confirmed', 'request status' ),    // User has confirmed the action.
		'request-failed'    => _x( 'Failed', 'request status' ),       // User failed to confirm the action.
		'request-completed' => _x( 'Completed', 'request status' ),    // Admin has handled the request.
	);
}

Changelog

Version Description
4.9.6 Introduced.