PrestaShop 1.7.7.2：基于购物车总价设置免运费模块开发求助

针对PrestaShop中基于购物车总价设置免运费（兼容重量计价承运商）的需求，最优方案是使用官方提供的actionCarrierProcess钩子，无需重写核心类、修改数据库或创建新承运商，既能保留原承运商的全部功能，又能兼容新旧版本。

为什么之前的方案不可行？ #

• CarrierModule方案：PrestaShop仅会调用对应模块创建的承运商的计算函数，非该模块生成的承运商不会触发，无法覆盖所有场景。
• ActionCartSave钩子：购物车运费由承运商计算逻辑主导，直接修改购物车运费会被后续的承运商计算流程覆盖，无法生效。
• 自定义配送选项表：PrestaShop默认运费计算逻辑不会读取自定义表，需重写承运商计算方法，复杂度高且易出问题。

具体实现步骤 #

1. 注册钩子 #

在模块的install方法中注册actionCarrierProcess钩子：

public function install()
{
    return parent::install() &&
        $this->registerHook('actionCarrierProcess') &&
        // 可选：注册购物车更新钩子，确保运费实时重新计算
        $this->registerHook('actionCartUpdateQuantity');
}

2. 钩子处理逻辑 #

实现钩子函数，判断购物车总价是否达标，修改承运商运费为0：

public function hookActionCarrierProcess($params)
{
    // 从模块配置读取免运费阈值（需提前在后台添加配置项）
    $freeThreshold = (float)Configuration::get('MIIB_FREE_SHIPPING_THRESHOLD');
    if ($freeThreshold <= 0) {
        return;
    }

    $cart = $params['cart'];
    if (!Validate::isLoadedObject($cart)) {
        return;
    }

    // 计算购物车总价（true表示含税，Cart::BOTH包含商品和附加项）
    $cartTotal = $cart->getOrderTotal(true, Cart::BOTH);

    // 达标则将当前承运商运费置为0
    if ($cartTotal >= $freeThreshold) {
        $carrier = &$params['carrier'];
        $carrier->shipping_cost = 0;
        $carrier->shipping_cost_tax_inc = 0;
        $carrier->shipping_cost_tax_exc = 0;
    }
}

// 可选：购物车商品数量变化时重新计算运费
public function hookActionCartUpdateQuantity($params)
{
    $cart = $params['cart'];
    if (Validate::isLoadedObject($cart)) {
        $cart->update();
    }
}

3. 添加后台配置项（可选） #

让用户可在后台设置免运费阈值，在模块的getContent方法中添加表单：

public function getContent()
{
    $output = '';
    if (Tools::isSubmit('submitMiibFreeShipping')) {
        $threshold = (float)Tools::getValue('miib_free_shipping_threshold');
        Configuration::updateValue('MIIB_FREE_SHIPPING_THRESHOLD', $threshold);
        $output .= $this->displayConfirmation($this->l('免运费阈值已更新'));
    }

    return $output . $this->renderForm();
}

private function renderForm()
{
    $fields_form = [
        'form' => [
            'legend' => [
                'title' => $this->l('免运费设置'),
                'icon' => 'icon-truck'
            ],
            'input' => [
                [
                    'type' => 'text',
                    'label' => $this->l('免运费总价阈值'),
                    'name' => 'miib_free_shipping_threshold',
                    'size' => 10,
                    'required' => true,
                    'desc' => $this->l('购物车总价达到此金额时免运费')
                ]
            ],
            'submit' => [
                'title' => $this->l('保存设置'),
                'class' => 'btn btn-default pull-right'
            ]
        ]
    ];

    $helper = new HelperForm();
    $helper->show_toolbar = false;
    $helper->table = $this->table;
    $helper->module = $this;
    $helper->default_form_language = Context::getContext()->language->id;
    $helper->allow_employee_form_lang = Configuration::get('PS_BO_ALLOW_EMPLOYEE_FORM_LANG', 0);
    $helper->identifier = $this->identifier;
    $helper->submit_action = 'submitMiibFreeShipping';
    $helper->currentIndex = $this->context->link->getAdminLink('AdminModules', false)
        . '&configure=' . $this->name . '&tab_module=' . $this->tab . '&module_name=' . $this->name;
    $helper->token = Tools::getAdminTokenLite('AdminModules');
    $helper->fields_value['miib_free_shipping_threshold'] = Configuration::get('MIIB_FREE_SHIPPING_THRESHOLD');

    return $helper->generateForm([$fields_form]);
}

注意事项 #

• 版本兼容：actionCarrierProcess钩子在PrestaShop 1.7及以上版本可用，若需兼容1.6版本，可替换为actionCarrierUpdate钩子，逻辑类似。
• 总价计算：可根据需求调整getOrderTotal的参数，比如改为false使用不含税总价，或Cart::PRODUCTS_ONLY仅计算商品总价。
• 多承运商场景：若需针对特定承运商生效，可在钩子中添加$carrier->id == 目标承运商ID的判断。
• 测试验证：需测试重量计价承运商、购物车更新、折扣使用、多商品组合等场景，确保免运费逻辑正确触发。

内容的提问来源于stack exchange，提问作者jmauclair