扩展WooCommerce产品搜索：通过自定义字段增强搜索功能

本教程详细指导如何在woocommerce中通过自定义产品数据字段扩展产品搜索功能。我们将介绍如何添加和保存自定义字段，并重点讲解如何利用wordpress的posts_search过滤器，通过直接修改sql查询，将自定义字段值纳入前端产品搜索结果，从而提升用户搜索体验。

引言

WooCommerce作为全球领先的电商平台，其强大的功能深受用户喜爱。然而，默认的产品搜索功能主要集中在产品标题、描述和SKU等核心字段。在许多业务场景中，我们可能需要根据自定义的产品数据字段进行搜索，例如产品的特定型号、批次号、颜色代码或本教程中提到的“Notch”自定义属性。直接使用meta_query配合woocommerce_product_query钩子在某些情况下可能无法完全满足需求，因为它主要用于筛选已有的查询结果，而不是修改核心的文本搜索逻辑。本文将提供一种通过WordPress posts_search 过滤器深入修改搜索行为的解决方案，以实现基于自定义字段的产品搜索。

第一步：添加并保存自定义产品数据字段

在扩展搜索功能之前，我们首先需要确保自定义字段能够被添加到产品编辑页面并正确保存。以下代码片段演示了如何在WooCommerce产品数据面板的“常规”选项卡中添加一个名为“Notch”的文本输入框，并将其数据保存到产品的元数据中。

1.1 添加自定义字段输入框

使用woocommerce_product_options_general_product_data钩子，在产品数据面板的“常规”部分添加一个自定义文本输入框。

add_action( 'woocommerce_product_options_general_product_data', 'custom_product_data_field_notch', 9999 );
/**
 * 在WooCommerce产品数据面板的“常规”选项卡中添加自定义字段。
 */
function custom_product_data_field_notch(): void {
    global $post;

    echo '<div class="options_group">';

    woocommerce_wp_text_input( [
        'id'            => '_pdc_notch', // 自定义字段的ID
        'wrapper_class' => '',
        'label'         => 'Notch', // 字段标签
        'desc_tip'      => true,
        'type'          => 'text',
        'description'   => '输入Notch PDC值', // 字段描述
        'value'         => get_post_meta( $post->ID, '_pdc_notch', true ) // 获取当前字段值
    ] );

    echo '</div>';
}

1.2 保存自定义字段数据

使用woocommerce_process_product_meta钩子，在产品保存时处理并更新自定义字段的数据。

add_action( 'woocommerce_process_product_meta', 'save_custom_product_data_field_notch', 10, 1 );
/**
 * 保存自定义产品数据字段的值。
 *
 * @param int $product_id 当前产品的ID。
 */
function save_custom_product_data_field_notch( int $product_id ): void {
    // 从POST数据中获取并清理自定义字段值
    $pdc_notch = sanitize_text_field( wp_unslash( $_POST['_pdc_notch'] ?? null ) );

    // 更新产品的元数据
    update_post_meta( $product_id, '_pdc_notch', $pdc_notch );
}

将以上代码添加到您的子主题的functions.php文件中，您将在产品编辑页面的“产品数据”部分的“常规”选项卡中看到一个新的“Notch”输入框。填写并保存产品后，该值将被存储为产品的元数据。

第二步：通过posts_search过滤器扩展产品搜索

WooCommerce默认的搜索机制主要依赖WordPress的WP_Query。当进行文本搜索时，WordPress会构建一个SQL查询来匹配文章标题、内容等。如果我们要将自定义字段纳入搜索范围，直接修改这个核心的SQL查询是最有效的方法。posts_search过滤器允许我们在WordPress生成搜索SQL语句之后，但在执行之前对其进行修改。

2.1 核心思路

我们的方法是：

Poixe AI

统一的 LLM API 服务平台，访问各种免费大模型

75

查看详情

1. 在posts_search过滤器中，首先判断当前是否为前端的产品搜索请求。
2. 利用wc_get_products函数，根据用户输入的搜索词，在我们的自定义字段_pdc_notch中查找匹配的产品。
3. 收集所有匹配产品的ID。
4. 修改原始的SQL搜索字符串，将这些匹配的产品ID通过OR条件添加到搜索查询中，确保这些产品也能被找到。

2.2 实现自定义字段搜索功能

以下代码片段展示了如何使用posts_search过滤器来扩展WooCommerce产品搜索，使其包含自定义字段_pdc_notch。

add_filter( 'posts_search', 'extend_woocommerce_product_search_by_notch', 10, 2 );
/**
 * 扩展WooCommerce产品搜索，使其包含自定义字段_pdc_notch。
 *
 * @param string   $search 原始的SQL搜索字符串。
 * @param WP_Query $query  当前的WP_Query对象。
 * @return string 修改后的SQL搜索字符串。
 */
function extend_woocommerce_product_search_by_notch( string $search, WP_Query $query ): string {
    global $wpdb; // 全局数据库对象

    // 1. 条件判断：
    //    - 搜索字符串为空则不处理
    //    - 确保是前端产品搜索且搜索词不为空
    //    - 排除后台管理界面搜索
    //    - 确保是主查询
    if ( empty( $search ) || 
         ! ( isset( $query->query_vars['s'], $query->query_vars['post_type'] ) && 
             ! empty( $query->query_vars['s'] ) && 
             $query->query_vars['post_type'] === 'product' ) || 
         is_admin() || 
         ! is_search() || 
         ! is_main_query() ) {
        return $search;
    }

    $product_ids = []; // 用于存储匹配产品ID的数组

    // 2. 使用wc_get_products根据自定义字段进行初步查询
    $products = wc_get_products( [
        'post_type'    => 'product',
        'limit'        => -1, // 获取所有匹配的产品
        'meta_key'     => '_pdc_notch', // 自定义字段的键
        'meta_value'   => esc_attr( $query->query_vars['s'] ), // 用户输入的搜索词
        'meta_compare' => 'LIKE' // 使用LIKE进行模糊匹配
    ] );

    /**
     * @var WC_Product $product
     */
    foreach ( $products as $product ) {
        $product_ids[] = $product->get_id(); // 收集匹配产品的ID
    }

    $product_ids = array_unique( $product_ids ); // 去除重复ID

    // 3. 修改原始SQL搜索字符串
    if ( count( $product_ids ) > 0 ) {
        // 查找原始SQL中AND (((的起始位置，在其后插入我们的OR条件
        // 这样，即使原始搜索条件不匹配，只要产品ID在我们的列表中，也能被找到。
        $search = str_replace( 
            'AND (((', 
            "AND ((({$wpdb->posts}.ID IN (" . implode( ',', $product_ids ) . ")) OR (", 
            $search 
        );
    }

    return $search;
}

代码解析与实现细节

1. 条件判断 (if 语句):

   • empty( $search ): 如果原始搜索字符串为空，则无需修改。
   • isset( $query->query_vars['s'], $query->query_vars['post_type'] ) && ! empty( $query->query_vars['s'] ) && $query->query_vars['post_type'] === 'product': 确保当前查询包含搜索词 (s)、指定了文章类型为product，并且搜索词不为空。
   • is_admin(): 排除后台管理界面的搜索，避免影响管理效率或产生不必要的冲突。
   • is_search(): 确保当前页面是搜索结果页。
   • is_main_query(): 确保我们只修改主查询，而不是其他可能存在的辅助查询。

2. 使用 wc_get_products 进行初步匹配:

   • wc_get_products() 是WooCommerce提供的一个强大函数，用于获取产品列表。
   • 'limit' => -1: 获取所有匹配的产品，不限制数量。
   • 'meta_key' => '_pdc_notch': 指定要搜索的自定义字段键。
   • 'meta_value' => esc_attr( $query->query_vars['s'] ): 使用当前搜索词作为元数据值进行匹配。esc_attr() 用于安全转义。
   • 'meta_compare' => 'LIKE': 指定比较操作符为LIKE，实现模糊匹配。如果需要精确匹配，可以使用'='。

3. 收集产品ID并去重:

   • 通过遍历wc_get_products返回的产品对象，提取每个产品的ID并存入$product_ids数组。
   • array_unique() 确保产品ID的唯一性。

4. 利用 str_replace 修改原始SQL查询:

   • 这是实现自定义搜索的关键步骤。WordPress的搜索SQL通常包含AND (((这样的结构来组合搜索条件。
   • 我们使用str_replace找到这个模式，并在其后插入一个新的OR条件：{$wpdb->posts}.ID IN (" . implode( ',', $product_ids ) . ")。
   • 这意味着，如果原始的搜索条件不匹配，但产品的ID在$product_ids列表中，该产品仍然会被包含在搜索结果中。这有效地将自定义字段的搜索结果与WordPress的默认搜索结果合并。

注意事项与最佳实践

• 代码放置位置: 所有代码都应放置在您的子主题的functions.php文件中，或者通过自定义插件进行管理。直接修改主题文件可能会在主题更新时丢失更改。
• 性能考量:
  • wc_get_products与limit -1结合在大型网站上可能会有性能开销，尤其当自定义字段匹配的产品数量非常庞大时。
  • 如果您的网站产品数量巨大，且自定义字段搜索需求频繁，可以考虑：
    • 使用更高效的数据库索引。
    • 结合Elasticsearch或Solr等专业搜索解决方案。
    • 对wc_get_products的查询进行优化，例如只获取ID而不加载完整产品对象。
• meta_compare的选择: 根据您的需求选择LIKE（模糊匹配）或=（精确匹配）。
• 兼容性: 在部署到生产环境之前，务必在开发环境中进行充分测试，确保与现有插件和主题的兼容性。
• 用户体验: 考虑为用户提供明确的搜索提示，告知他们可以搜索哪些自定义字段，以提升搜索效率。

总结

通过上述教程，我们不仅学会了如何在WooCommerce中添加和保存自定义产品数据字段，更重要的是，掌握了如何利用WordPress的posts_search过滤器来深度扩展产品搜索功能，使其能够识别并匹配自定义字段的值。这种方法提供了一种强大而灵活的解决方案，能够显著提升用户在您的WooCommerce商店中的搜索体验，帮助他们更快地找到所需的产品。记住，始终在安全的环境中进行开发和测试，并关注代码的性能影响。

以上就是扩展WooCommerce产品搜索：通过自定义字段增强搜索功能的详细内容，更多请关注php中文网其它相关文章！