如何根据 WooCommerce 产品 ACF 字段动态筛选显示的配送方式-php教程-PHP中文网

如何根据 WooCommerce 产品 ACF 字段动态筛选显示的配送方式

本文介绍如何通过 acf 自定义字段（如多选复选框）控制购物车与结算页中仅显示匹配的 woocommerce 配送方式，例如当产品标记为“cp”时，仅启用“Čp”配送方法。

本文介绍如何通过 acf 自定义字段（如多选复选框）控制购物车与结算页中仅显示匹配的 woocommerce 配送方式，例如当产品标记为“cp”时，仅启用“Čp”配送方法。

在 WooCommerce 中实现「按产品属性动态过滤配送方式」是一个常见但易出错的需求。核心逻辑是：遍历当前购物包（package）中的所有商品，检查其 ACF 字段值（如 zpusob_prepravy），汇总所需启用的配送标识（如 'cp', 'ppl', 'dpd'），再据此保留或移除对应 ID 的配送方法。

⚠️ 原代码存在多个关键问题：

未遍历 $package['contents']，直接调用 get_field('zpusob_prepravy') 会返回空或默认值（因无上下文产品 ID）；
$shipping_id 变量未定义，且硬编码了错误的费率 ID（如 'flat_rate:1' 或 'table_rate_shipping_first-class'）；
未正确映射 ACF 值（'cp'）到实际的 WooCommerce 配送方法 ID（如 'flat_rate:2' 对应 ČP）；
缺少对多商品混合场景的兼容处理（例如购物车含 CP 和 DPD 商品时，应同时显示两者）。

✅ 正确实现步骤如下：

1. 明确配送方法 ID

进入 WooCommerce → 设置 → 配送 → 配送区域 → 编辑对应区域 → 配送方法，鼠标悬停在方法名称上，查看浏览器状态栏或检查元素，获取真实 ID 格式（通常为 flat_rate:ID、local_pickup:0 等）。例如：

ČP → flat_rate:2
PPL → flat_rate:3
DPD → flat_rate:4

2. 编写健壮的过滤函数

将以下代码添加至主题 functions.php 或子主题中：

add_filter( 'woocommerce_package_rates', 'filter_shipping_methods_by_acf_field', 10, 2 );
function filter_shipping_methods_by_acf_field( $rates, $package ) {
    // 初始化允许的配送标识集合
    $allowed_methods = array();

    // 遍历当前包裹内所有商品
    foreach ( $package['contents'] as $item_id => $item ) {
        $product = $item['data'];
        $product_id = $product->get_id();

        // 获取该商品的 ACF 复选框字段值（返回数组，如 ['cp', 'dpd']）
        $shipping_options = get_field( 'zpusob_prepravy', $product_id );

        // 若字段存在且为数组，则合并到允许列表
        if ( is_array( $shipping_options ) ) {
            $allowed_methods = array_merge( $allowed_methods, $shipping_options );
        }
    }

    // 去重并确保小写一致性
    $allowed_methods = array_unique( array_map( 'strtolower', $allowed_methods ) );

    // 定义 ACF 值到 WooCommerce 配送 ID 的映射关系（请按实际 ID 修改！）
    $method_mapping = array(
        'cp'  => 'flat_rate:2',  // ČP 配送
        'ppl' => 'flat_rate:3',  // PPL 配送
        'dpd' => 'flat_rate:4',  // DPD 配送
    );

    // 构建需保留的配送 ID 列表
    $keep_ids = array();
    foreach ( $allowed_methods as $option ) {
        if ( isset( $method_mapping[ $option ] ) ) {
            $keep_ids[] = $method_mapping[ $option ];
        }
    }

    // 移除非许可的配送方法
    foreach ( $rates as $rate_id => $rate ) {
        if ( ! in_array( $rate_id, $keep_ids ) ) {
            unset( $rates[ $rate_id ] );
        }
    }

    return $rates;
}