本文档旨在指导开发者如何使用 woocommerce_product_query 钩子，根据自定义 meta 字段的值，动态过滤 WooCommerce 产品循环。通过示例代码，我们将演示如何根据 URL 参数 filterbyAge 的值，筛选 book_age_group meta 字段匹配的产品，并提供详细的实现步骤和注意事项，帮助开发者灵活定制 WooCommerce 产品展示。
在 WooCommerce 中，有时我们需要根据自定义的 meta 字段来过滤产品列表，例如根据年龄段、颜色、尺寸等。woocommerce_product_query 钩子允许我们在产品查询执行之前修改查询参数，从而实现自定义过滤。
实现步骤：
-
理解 woocommerce_product_query 钩子：
这个钩子在 WooCommerce 产品查询构建之后、执行之前被触发。它接收两个参数：$q (WP_Query 对象) 和 $query (WC_Query 对象)。我们可以通过 $q 对象来修改查询参数，例如 meta_query。
-
获取 URL 参数：
首先，我们需要从 URL 中获取过滤条件。在本例中，我们假设 URL 参数为 filterbyAge。可以使用 $_GET 超全局变量来获取该参数的值。
-
构建 meta_query：
meta_query 是一个数组，用于指定 meta 字段的查询条件。每个条件也是一个数组，包含 key (meta 字段的键名)、value (要匹配的值) 和 compare (比较运算符)。
蓝色商务公司网站(XDcms内核)1.0下载本系统使用的是XDcms内核，在原来基础上做来相应修改 前台修改调用数据，可以使用{loop catid=栏目ID}{/loop}方式调用 主要功能： A、内容管理模型，自定义字段，更方便扩展功能。自带模型：单页模型、新闻模型、产品模型、招聘模型 B、栏目自定义，便于内容管理 C、内容模块化，二次开发更便捷。自带模块：幻灯片、QQ客服、友情链接、自定义表单(在线留言、简历管理) D、模板管理，后台
-
修改查询参数：
使用 $q->set() 方法来修改查询参数。将构建好的 meta_query 赋值给 $q 对象的 meta_query 属性。注意： 如果已经存在 meta_query，需要将其合并，而不是直接覆盖。
示例代码：
以下代码演示了如何根据 URL 参数 filterbyAge 的值，筛选 book_age_group meta 字段匹配的产品。
// Change the shop query
function action_woocommerce_product_query( $q, $query ) {
// Returns true when on the product archive page (shop) & isset
if ( is_shop() && isset( $_GET['filterbyAge'] ) ) {
// Get any existing meta query
$meta_query = $q->get( 'meta_query' );
// Settings
$key = 'book_age_group';
$value = $_GET['filterbyAge'];
$meta_query[] = array(
'key' => $key,
'value' => $value,
'compare' => '='
);
// Set the new merged meta query
$q->set( 'meta_query', $meta_query );
}
}
add_action( 'woocommerce_product_query', 'action_woocommerce_product_query', 10, 2 );代码解释：
- is_shop() 函数检查当前页面是否是商店页面。
- isset( $_GET['filterbyAge'] ) 检查 URL 中是否存在 filterbyAge 参数。
- $q->get( 'meta_query' ) 获取已有的 meta_query，如果不存在则返回空数组。
- $meta_query[] = array(...) 将新的 meta 查询条件添加到已有的 meta_query 数组中。
- $q->set( 'meta_query', $meta_query ) 设置新的 meta_query。
- add_action( 'woocommerce_product_query', 'action_woocommerce_product_query', 10, 2 ) 将函数 action_woocommerce_product_query 挂载到 woocommerce_product_query 钩子上。10 是优先级，2 是参数个数。
注意事项：
- 确保你的 meta 字段的键名 (book_age_group 在本例中) 是正确的。
- 根据你的实际需求修改比较运算符 (compare)。常用的比较运算符包括 = (等于), != (不等于), > (大于), = (大于等于),
- 如果需要同时使用多个过滤条件，可以在 meta_query 数组中添加多个条件。
- 为了安全起见，应对 URL 参数进行验证和过滤，防止 SQL 注入等安全问题。可以使用 sanitize_text_field() 函数来过滤字符串类型的参数。
总结：
通过 woocommerce_product_query 钩子，我们可以灵活地自定义 WooCommerce 产品循环，根据各种条件过滤产品列表。掌握这种方法，可以为用户提供更个性化的购物体验。记住要合并已有的 meta_query，并对 URL 参数进行验证和过滤，以确保代码的安全性和稳定性。
