本文档旨在指导开发者如何在 WooCommerce 产品目录页面实现基于自定义字段（例如年龄）的筛选功能。通过 woocommerce_product_query 钩子，我们可以修改 WooCommerce 的产品查询，从而根据 URL 参数动态地过滤产品。本文将提供详细的代码示例和解释，帮助你快速实现该功能。
理解 woocommerce_product_query 钩子
woocommerce_product_query 钩子允许开发者在 WooCommerce 执行产品查询之前对其进行修改。这为我们提供了在产品循环中添加自定义筛选条件的机会。该钩子接收两个参数：$q (WP_Query 对象) 和 $query (WC_Query 对象)。通过操作 $q 对象，我们可以添加或修改查询参数，例如 meta_query，从而实现自定义的筛选逻辑。
实现基于年龄的筛选
假设我们使用 ACF (Advanced Custom Fields) 插件在产品中添加了一个名为 book_age_group 的自定义字段，用于存储书籍的适用年龄段。现在，我们希望通过 URL 参数 filterbyAge 来筛选产品。例如，访问 wordpress.test/shop?filterbyAge=23 时，只显示 book_age_group 值为 23 的产品。
以下代码展示了如何使用 woocommerce_product_query 钩子来实现这一功能：
/**
* 修改 WooCommerce 产品查询，根据年龄筛选产品
*
* @param WP_Query $q WP_Query 对象
* @param WC_Query $query WC_Query 对象
*/
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' => '=' // 使用精确匹配
);
// 设置新的 meta query
$q->set( 'meta_query', $meta_query );
}
}
add_action( 'woocommerce_product_query', 'action_woocommerce_product_query', 10, 2 );代码解释：
- action_woocommerce_product_query( $q, $query ) 函数: 这是我们自定义的函数，它将在 woocommerce_product_query 钩子被触发时执行。
- is_shop() && isset( $_GET['filterbyAge'] ): 首先，我们检查当前是否在产品存档页面（商店页面），并且 URL 中是否存在 filterbyAge 参数。这确保了我们的筛选逻辑只在特定的页面和条件下执行。
- $meta_query = $q->get( 'meta_query' ): 获取已存在的 meta_query，避免覆盖其他插件或主题可能添加的筛选条件。
- $key = 'book_age_group'; $value = $_GET['filterbyAge'];: 设置自定义字段的键（book_age_group）和值（从 URL 参数 filterbyAge 获取）。
- $meta_query[] = array(...): 创建一个新的 meta_query 数组，并将其添加到现有的 meta_query 数组中。 compare => '=' 表示我们使用精确匹配。
- $q->set( 'meta_query', $meta_query ): 最后，将新的 meta_query 设置回 $q 对象，从而修改 WooCommerce 的产品查询。
- add_action( 'woocommerce_product_query', 'action_woocommerce_product_query', 10, 2 ): 将我们的函数绑定到 woocommerce_product_query 钩子。 10 是优先级，2 是参数数量。
注意事项
- 代码位置: 将以上代码添加到你的主题的 functions.php 文件或者一个自定义的插件中。
- 自定义字段: 确保你已经使用 ACF 或其他插件创建了名为 book_age_group 的自定义字段，并且该字段存储了正确的年龄数据。
- URL 参数: 确保你使用正确的 URL 参数 filterbyAge 来传递年龄值。
- 比较操作符: 根据你的需求，你可以修改 compare 参数的值。例如，可以使用 'compare' => '>=' 来筛选大于等于指定年龄的产品。其他可用的比较操作符包括：'=', '!=', '>', '=', '
- 性能优化: 如果你的产品数量非常庞大，建议对查询进行性能优化，例如添加索引。
总结
通过使用 woocommerce_product_query 钩子，我们可以轻松地修改 WooCommerce 的产品查询，从而实现基于自定义字段的筛选功能。本文提供了一个基于年龄筛选的示例，你可以根据自己的需求进行修改和扩展，实现更复杂的筛选逻辑。 记住，理解 WooCommerce 的钩子机制对于自定义 WooCommerce 功能至关重要。
