WordPress 常用函数中文翻译

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

nav_menu_submenu_css_class Filter 修改子菜单 class

功能 过滤应用于菜单列表元素的CSS类。 参数 参数 数据类型 描述 $classes 数组 应用于菜单的CSS类数组 $args stdClass wp_nav_menu() 参数的对象 $depth 整数 菜单深度,用于菜单级别和锁进 代码示例 需要修改 has-submenu 菜单类是,使用此 filter 修改,以适应我们的前端代码。

wp_nav_menu_items 修改导航菜单项目的 HTML 内容

函数描述 修改导航菜单的HTML列表内容。 函数参数 参数 数据类型 描述 $items 字符串 菜单项目的 HTML 列表内容。 $args stdClass 包含 wp_nav_menu() 的对象。 $items:(字符串) 菜单项目的 HTML 列表内容。 $args:(stdClass) 包含 wp_nav_menu() 的对象。 使用示例 假如,我们需要添加一个「登录/我的账户链接」到导航菜单,因为我们要根据用户登录状态判断 […]

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, 以及其他类型的名称