WordPress 常用函数中文翻译

WordPress为我们提供了丰富的函数,方便我们对WordPress进行定制,开发WordPress主题或插件,我们会在这里把经常使用的函数文档翻译成中文,加上使用总结和代码示例,方便后续查阅。

add_query_arg 添加自定义查询参数生成新的 URL

函数功能描述 给一个 URL 添加新的查询参数获取新的 URL。 我们可以使用此功能重建URL,或添加新的查询参数到URL,也可以获取带查询参数的完整URL。 添加一个键值对或者一个关联数组,设置键的值为假可以出URL移除该查询字符串。用 $_SERVER 值省略旧的查询或 URI(第二或第三个参数)。 使用说明 参数 参数 数据类型 是否必需 描述 默认值 $param1 整数|字符串|数字 是 新的查询字符串或数组 无 $param […]

wp_redirect | wp_safe_redirect 重定用户到指定页面

功能描述 跳转用户到指定的URL,URL 必须是完整的绝对 URL。 使用说明 wp_redirect() 不会自动退出,使用时需要在后面添加退出函数。如下: 参数 参数 数据类型 是否必需 描述 默认值 $location 字符串 是 用户将被重定向到的绝对URL 无 $status 整数 否 重定向 HTTP 状态码 302 返回值 如果 $location 没有设置,返回false,其他情况下不返回任何值 使用示例 也可以跳转到外 […]

get_query_var 获取WordPress查询变量

功能描述 获取全局变量 $wp_query 对象使用的 WP_Query 类中的公开查询参数。 使用说明 参数 参数 数据类型 是否必需 描述 默认值 $var 字符串 是 需要获取的查询变量的名称 无 返回值 (mixed)返回参数值,如果参数没有设置,返回空 使用示例 获取当前分页数 想要获取静态首页 (或页面模板) 的分页数,我们必须使用 ‘page’ 查询参数: 注意:查询参 […]

get_current_user_id 获取当前用户 ID

函数描述 返回当前用户 ID,需要在 Init 或之后的 Action 中调用此函数,否则可能获取不到正确的用户 ID. 使用方法 返回值 返回 int 类型的用户 ID,如果获取不到,返回 0。

get_currentuserinfo 获取当前登录用户的信息

获取当前登录用户的信息并存入 $userdata 全局变量中,属性和 wp_users 数据表对应。同时也把以下信息存入对应的全局变量。

wp_set_current_user 设置当前用户,不会自动登录该用户

通过用户 ID 或名称修改当前用户。如果不知道用户ID,设置 $id 为 null 然后指定一个用户名称,提供了对未登录的某用户进行编辑和一些操作的能力。

get_current_screen 获取仪表盘中当前页面信息

返回一个包含当前页面 ID 的对象,如:base, post type, 或 taxonomy, 以及其他类型的名称

wp_get_current_user 获取当前登录的用户对象

获取当前登录的用户对象 (WP_User),是 get_currentuserinfo() 函数的封装,使用全局变量 $current_user。

get_user_by 通过用户的某属性字段获取用户数据对象

通过用户的某属性字段获取用户数据对象,分别对应 wp_users 数据表的的相应列。

current_user_can 判断用户是否有某个权限或是否为某个角色

判断用户是否有某个权限或是否为某个角色,比如我们需要判断当前登录的用户是否为管理员,或者是否有作者权限。

load_template 在主题或插件中正确加载模板文件,允许使用主题中的模板覆盖插件默认模板

在 WordPress 环境中加载模板文件,此函数的目的是确保在 WordPress 函数中正确地载模板文件,也可以使用查询参数访问这个函数。

get_userdata 获取用户数据

获取某个用户的用户数据,数据形式为一个 WP_User 对象,我们可以通过 “->” 操作符直接获取 wp_users 和 wp_usermeta 数据表里面的信息。