本教程旨在帮助开发者实现在 WooCommerce 产品页面循环中，根据 URL 参数筛选产品的功能。通过使用 woocommerce_product_query 钩子，我们可以修改默认的产品查询，并添加自定义的 meta query，从而实现根据产品年龄段进行筛选。本教程提供详细的代码示例，并解释了如何正确合并 meta query，以避免覆盖原有的查询条件。
在 WooCommerce 网站中，经常需要根据特定的产品属性进行筛选，例如根据年龄段筛选书籍或玩具。 WooCommerce 提供了强大的查询机制，允许开发者通过 woocommerce_product_query 钩子修改产品查询，从而实现自定义的筛选逻辑。本教程将介绍如何使用该钩子，根据 URL 参数动态地筛选产品。
实现步骤：
-
理解 woocommerce_product_query 钩子
woocommerce_product_query 是一个 action 钩子，它允许我们在 WooCommerce 产品查询执行之前修改查询参数。该钩子接收两个参数：
- $q: WP_Query 对象，代表当前的产品查询。
- $query: WC_Query 对象，包含 WooCommerce 相关的查询信息。
-
获取 URL 参数
我们需要从 URL 中获取筛选条件。在本例中，我们假设 URL 中包含 filterbyAge 参数，例如：wordpress.test/shop?filterbyAge=23。可以使用 PHP 的 $_GET 超全局变量来获取该参数的值。
-
构建 Meta Query
Meta Query 是 WordPress 用来查询自定义字段（也称为 meta 数据）的机制。我们需要构建一个 meta query，用于筛选 book_age_group 自定义字段的值与 URL 参数匹配的产品。
-
合并 Meta Query
这是最关键的一步。如果直接使用 $q->set('meta_query', ...) 替换原有的 meta query，可能会导致其他插件或 WooCommerce 自身的筛选条件失效。因此，我们需要先获取原有的 meta query，然后将新的 meta query 合并到其中。
代码示例：
/**
* 根据年龄筛选 WooCommerce 产品
*
* @param WP_Query $q The main WP_Query instance.
* @param WC_Query $query The main WC_Query instance.
*/
function action_woocommerce_product_query( $q, $query ) {
// 检查是否在商店页面，并且 URL 中存在 filterbyAge 参数
if ( is_shop() && isset( $_GET['filterbyAge'] ) ) {
// 获取已存在的 meta query
$meta_query = $q->get( 'meta_query' );
// 设置自定义字段的键和值
$key = 'book_age_group';
$value = $_GET['filterbyAge'];
// 构建新的 meta query
$meta_query[] = array(
'key' => $key,
'value' => $value,
'compare' => '=' // 可以根据需要修改比较运算符，例如：'>=', '<=', 'LIKE' 等
);
// 设置合并后的 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 query 添加到已存在的 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 是参数数量。
注意事项：
- 确保自定义字段 book_age_group 存在于你的产品中。可以使用 ACF (Advanced Custom Fields) 等插件创建自定义字段。
- 根据实际需求修改比较运算符 (compare)，例如：'=', '>=', '
- 如果需要添加多个筛选条件，可以在代码中添加多个 meta query。
- 在测试代码时，确保启用 WordPress 的调试模式，以便及时发现错误。
总结：
通过使用 woocommerce_product_query 钩子和合并 meta query 的方法，我们可以轻松地实现根据 URL 参数筛选 WooCommerce 产品的功能。 这种方法不仅灵活，而且可以避免与其他插件或 WooCommerce 自身的功能冲突。希望本教程能够帮助你更好地定制 WooCommerce 网站。
