根据年龄筛选 WooCommerce 产品：自定义商品查询教程

本教程旨在帮助开发者实现在 WooCommerce 产品页面循环中，根据 URL 参数筛选产品的功能。通过使用 woocommerce_product_query 钩子，我们可以修改默认的产品查询，并添加自定义的 meta query，从而实现根据产品年龄段进行筛选。本教程提供详细的代码示例，并解释了如何正确合并 meta query，以避免覆盖原有的查询条件。

在 WooCommerce 网站中，经常需要根据特定的产品属性进行筛选，例如根据年龄段筛选书籍或玩具。 WooCommerce 提供了强大的查询机制，允许开发者通过 woocommerce_product_query 钩子修改产品查询，从而实现自定义的筛选逻辑。本教程将介绍如何使用该钩子，根据 URL 参数动态地筛选产品。

实现步骤：

1. 理解 woocommerce_product_query 钩子

   woocommerce_product_query 是一个 action 钩子，它允许我们在 WooCommerce 产品查询执行之前修改查询参数。该钩子接收两个参数：

   • $q: WP_Query 对象，代表当前的产品查询。
   • $query: WC_Query 对象，包含 WooCommerce 相关的查询信息。

2. 获取 URL 参数

   我们需要从 URL 中获取筛选条件。在本例中，我们假设 URL 中包含 filterbyAge 参数，例如：wordpress.test/shop?filterbyAge=23。可以使用 PHP 的 $_GET 超全局变量来获取该参数的值。

3. 构建 Meta Query

   Meta Query 是 WordPress 用来查询自定义字段（也称为 meta 数据）的机制。我们需要构建一个 meta query，用于筛选 book_age_group 自定义字段的值与 URL 参数匹配的产品。

4. 合并 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 网站。