WordPress 常用函数中文翻译

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

wc_get_products 和 WC_Product_Query 查询类的所有参数及使用示例

wc_get_products 和 WC_Product_Query 是WooCommerce用来查询产品的标准方法,改方法不会随着WooCommerce未来版本中的数据库更改而变化,因此,我们可以放心的使用此方法来进行自定义查询,以实现各种WooCommerce功能 虽然我们可以…

get_transient 获取瞬态数据

该函数用来获取瞬态数据的值,如果瞬态数据不存在、没有值或已过期,则返回值将为false。 函数参数 参数数据类型是否必需描述默认值$transient字符串是瞬态数据名称,预计不会被 SQL 转义无 函数返回值 如果获取成功,返回…

set_transient 设置或更新瞬态数据的值

在WordPress中设置或更新瞬态数据的值,经常用来保存一些不需要一直存在的数据。 函数参数 参数数据类型是否必需描述默认值$transient字符串是瞬态数据名称,长度不得超过 172 个字符。无$value多种是瞬态数据的值,如果是非标量…

sanitize_file_name 清理文件名称,用横线代替空格

删除文件名中的非法特殊字符和需要转义才能在命令行中显示的特殊字符,用英文破折号替换空格和连续破折号,删除文件名开头和结尾的句号、破折号和下划线。此函数不保证能返回允许上传的文件名。 函数参数 参数数据类型是否必需描…

remove_menu_page 移除后台菜单

函数功能 移除WordPress后台顶级菜单。 函数参数 参数数据类型是否必需描述默认值$menu_slug字符串是菜单Slug无 函数返回值 如果成功,返回移除的菜单数据,失败返回 false 使用示例 函数需要挂载到 admin_init …

register_block_pattern 注册自定义Pattern

函数功能 注册自定义Pattern 到WordPress古腾堡编辑器。 函数参数 参数数据类型是否必需描述默认值$pattern_name字符串是包含命名空间的Pattern名称无$pattern_properties数组是包含Pattern属性的数组。无 $pattern_proper…

wp_remote_get 发送 GET 请求到 URL 并返回数据

函数功能 使用GET方法执行HTTP请求并返回其响应。 函数参数 参数数据类型是否必需描述默认值$url字符串是请求 URL无$args数组否请求参数array() 函数返回值 成功时,返回一个数组,失败时,返回一个 WP_Error 对象 …

wp_remote_post 发送 HTTP POST 请求并返回相应

函数功能 使用POST方法执行HTTP请求并返回其响应数据。 参数 参数数据类型是否必需描述默认值$url字符串是请求 URL无$args数组否请求参数array() 返回值 响应数组,如果出错,返回 WP_Error 对象 使用示例 发送的…

remove_query_arg 从URL中从移除查询字符串生成新的URL

参数 参数数据类型是否必需描述默认值$key字符串|数组是需要移除的查询键无$query布尔值|字符串否留空时使用当前URLfalse 返回值 返回值为新的 URL 字符串 使用示例 假设当前页面的 URL 为:http://www.example.com/c…

nav_menu_submenu_css_class Filter 修改子菜单 class

功能 过滤应用于菜单列表元素的CSS类。 参数 参数数据类型描述$classes数组应用于菜单的CSS类数组$argsstdClasswp_nav_menu() 参数的对象$depth整数菜单深度,用于菜单级别和锁进 代码示例 需要修改 has-submenu 菜单类…