wc_get_products 和 WC_Product_Query 是WooCommerce用来查询产品的标准方法，改方法不会随着WooCommerce未来版本中的数据库更改而变化，因此，我们可以放心的使用此方法来进行自定义查询，以实现各种WooCommerce功能 虽然我们可以可以使用 WP_Query 来实现WooCommerce产品的自定义插件，但是可能会无法兼容未来的WooCommerce版本，所以不推荐使用这种方法。 函数参 […]

该函数用来获取瞬态数据的值，如果瞬态数据不存在、没有值或已过期，则返回值将为false。 函数参数 参数 数据类型 是否必需 描述 默认值 $transient 字符串 是 瞬态数据名称，预计不会被 SQL 转义 无 函数返回值 如果获取成功，返回瞬态数据的值，如果值不存在或已过期，返回false。 使用示例 下面的示例中，我们先尝试获取瞬态数据 special_query_results 的值，如果不存在，我们新建了一个 WP_Que […]

在WordPress中设置或更新瞬态数据的值，经常用来保存一些不需要一直存在的数据。 函数参数 参数 数据类型 是否必需 描述 默认值 $transient 字符串 是 瞬态数据名称，长度不得超过 172 个字符。 无 $value 多种 是 瞬态数据的值，如果是非标量，必需是可以被序列化的 无 $expiration 整数 否 过期时间，以秒为单位 0 函数返回值 设置成功返回 true，否则返回 false 使用示例 下面的示例中， […]

删除文件名中的非法特殊字符和需要转义才能在命令行中显示的特殊字符，用英文破折号替换空格和连续破折号，删除文件名开头和结尾的句号、破折号和下划线。此函数不保证能返回允许上传的文件名。 函数参数 参数 数据类型 是否必需 描述 默认值 $filename 字符串 是 需要清理的文件名 无 函数返回值 返回清理后的文件名。 更多说明 可以通过sanitize_file_name_chars过滤器修改不允许在文件名中出现的字符。该函数清理文件名 […]

pre_get_posts Action主要用来修改主查询，经常在需要修改主文章查询时使用，可以让我们不用创建自定义查询来得到我们需要的文章内容。 参数 该Action只有一个参数，就是通过引用传递的$wp_query 对象。 使用示例 下面是几个使用示例，可以帮我我们快速了解 pre_get_posts Action 的使用方法。 在首页文章中排除ID位7、11 的文章。 在搜索结果中排除页面、只搜索文章内容。

函数功能 移除WordPress后台顶级菜单。 函数参数 参数 数据类型 是否必需 描述 默认值 $menu_slug 字符串 是 菜单Slug 无 函数返回值 如果成功，返回移除的菜单数据，失败返回 false 使用示例 函数需要挂载到 admin_init 钩子上才能生效。下面的例子中，我们移除了 wpcf7菜单。 相关函数 remove_submenu_page 功能和 remove_menu_page 类似，不同的是多了一个父级 […]

函数功能 注册自定义Pattern 到WordPress古腾堡编辑器。 函数参数 参数 数据类型 是否必需 描述 默认值 $pattern_name 字符串 是 包含命名空间的Pattern名称 无 $pattern_properties 数组 是 包含Pattern属性的数组。 无 $pattern_properties 数组可以包含以下几项数据。 参数 数据类型 是否必需 描述 title 字符串 是 模式标题 content 字符 […]

函数功能 使用GET方法执行HTTP请求并返回其响应。 函数参数 参数 数据类型 是否必需 描述 默认值 $url 字符串 是 请求 URL 无 $args 数组 否 请求参数 array() 函数返回值 成功时，返回一个数组，失败时，返回一个 WP_Error 对象 使用示例 发送 HTTP 请求时，我们可以通过该函数的 $args 参数来设置 HTTP 的各种参数，包括超时时间，HTTP 版本，Headers 等信息。 请求时设置超 […]

函数功能 使用POST方法执行HTTP请求并返回其响应数据。 参数 参数 数据类型 是否必需 描述 默认值 $url 字符串 是 请求 URL 无 $args 数字 否 请求参数 array() 返回值 响应数组，如果出错，返回 WP_Error 对象 使用示例 发送的Post数据应该在 body 中提供，body 不一定是数组，也可以是 XML 或 JSON 格式的字符串或其他可以通过 HTTP 协议发送的数据。 在请求中添加基础授权 […]

参数 参数 数据类型 是否必需 描述 默认值 $key 字符串｜数组 是 需要移除的查询键 无 $query 布尔值｜字符串 否 留空时使用当前URL false 返回值 返回值为新的 URL 字符串 使用示例 假设当前页面的 URL 为：http://www.example.com/client/?details=value1&type=value2&date=value3 当我们需要操作的 URL 不是当前页面时，需 […]

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

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