函数文档

translate_level_to_role()

💡 云策文档标注

概述

translate_level_to_role() 函数用于将用户级别转换为对应的用户角色名称,基于 WordPress 的用户级别系统进行映射。

关键要点

  • 函数接受一个整数参数 $level,表示用户级别
  • 返回字符串,即对应的用户角色名称,如 'administrator'、'editor' 等
  • 使用 switch 语句实现级别到角色的映射逻辑

代码示例

function translate_level_to_role( $level ) {
	switch ( $level ) {
		case 10:
		case 9:
		case 8:
			return 'administrator';
		case 7:
		case 6:
		case 5:
			return 'editor';
		case 4:
		case 3:
		case 2:
			return 'author';
		case 1:
			return 'contributor';
		case 0:
		default:
			return 'subscriber';
	}
}

注意事项

  • 该函数自 WordPress 2.0.0 版本引入
  • 用户级别系统在 WordPress 中已逐渐被角色和权限系统取代,建议优先使用角色相关函数

📄 原文内容

Translate user level to user role name.

Parameters

$levelintrequired
User level.

Return

string User role name.

Source

function translate_level_to_role( $level ) {
	switch ( $level ) {
		case 10:
		case 9:
		case 8:
			return 'administrator';
		case 7:
		case 6:
		case 5:
			return 'editor';
		case 4:
		case 3:
		case 2:
			return 'author';
		case 1:
			return 'contributor';
		case 0:
		default:
			return 'subscriber';
	}
}

Changelog

Version Description
2.0.0 Introduced.