Gravity Forms折扣字段基于用户角色的动态填充实现问询

问题背景 #

我站点有40个表单，每个表单都带折扣字段，系统同时有10种用户角色。最初给每种角色单独配了对应折扣字段，太冗余，现在改成后台统一配置所有角色的折扣选项，每个表单只留一个折扣字段，根据当前用户角色自动填充对应折扣值。现在卡壳在怎么把后台配置的折扣值正确填到字段里，附上我写的测试代码，求帮忙完善：

<?php
// 定义表单ID与产品类型、折扣字段ID的映射关系
$form_mappings = [
    4 => ['product_type' => 'vtu', 'discount_field_id' => 10],
    // 添加更多表单场景的映射
];
// 获取当前用户角色
$current_user = wp_get_current_user();
$user_role = $current_user->roles[0];
?>
<script>
    jQuery(document).ready(function($) {
        // 计算并设置折扣值的函数
        function setDiscountValue(formId) {
            // 获取当前表单ID对应的映射信息
            var mapping = <?php echo json_encode($form_mappings); ?>;
            var currentMapping = mapping[formId];
            // 检查当前表单ID是否有对应的映射
            if (currentMapping) {
                var productType = currentMapping.product_type;
                var discountFieldId = currentMapping.discount_field_id;
                // 根据用户角色和产品类型获取折扣值
                var discountSettings = <?php echo json_encode($discount_settings); ?>; // 确保在PHP代码中定义$discount_settings
                var discountValue = discountSettings[userRole][productType] || 0;
                // 将计算得到的折扣值设置到指定ID的字段中
                $('#' + discountFieldId).val(discountValue);
            }
        }
        // 遍历每个表单映射并设置折扣值
        $.each(<?php echo json_encode($form_mappings); ?>, function(formId) {
            // 检查页面中是否存在该表单
            if ($('#form-' + formId).length > 0) {
                // 调用函数为每个表单设置折扣值
                setDiscountValue(formId);
                // 可选：绑定到表单提交事件
                $('#form-' + formId).on('submit', function() {
                    // 提交表单前调用函数设置折扣值
                    setDiscountValue(formId);
                });
            }
        });
    });
</script>

问题分析与修正方案 #

原代码有几个关键问题需要调整：

1. JS里的userRole变量未定义，无法从PHP拿到用户角色信息
2. 重复序列化$form_mappings，造成不必要的性能浪费
3. 未处理用户无角色、或角色/产品类型不存在的情况，容易触发JS报错
4. 未检查折扣字段是否存在，可能导致控制台报错

下面是修正后的代码，解决了上述问题：

<?php
// 表单ID与产品类型、折扣字段ID的映射
$form_mappings = [
    4 => ['product_type' => 'vtu', 'discount_field_id' => 10],
    // 补充其他表单的映射配置
];

// 获取当前用户角色，处理无角色的边界情况
$current_user = wp_get_current_user();
$user_role = !empty($current_user->roles) ? $current_user->roles[0] : 'guest';

// 后台配置的折扣数据，实际应从数据库/系统选项中读取
$discount_settings = [
    'administrator' => ['vtu' => 15],
    'editor' => ['vtu' => 10],
    'subscriber' => ['vtu' => 5],
    // 补充其他角色和产品类型的折扣配置
];
?>
<script>
    jQuery(document).ready(function($) {
        // 预加载配置数据，避免重复序列化
        const formMappings = <?php echo json_encode($form_mappings); ?>;
        const discountSettings = <?php echo json_encode($discount_settings); ?>;
        const currentUserRole = '<?php echo esc_js($user_role); ?>';

        // 设置折扣值的核心函数
        function setDiscountValue(formId) {
            const currentMapping = formMappings[formId];
            if (!currentMapping) return;

            const { product_type: productType, discount_field_id: discountFieldId } = currentMapping;
            // 用可选链安全访问嵌套属性，避免不存在时报错
            const discountValue = discountSettings[currentUserRole]?.[productType] || 0;
            // 确认字段存在后再赋值，避免无效操作
            const $discountField = $('#' + discountFieldId);
            if ($discountField.length) {
                $discountField.val(discountValue);
            }
        }

        // 遍历所有映射，为页面中存在的表单设置折扣
        Object.keys(formMappings).forEach(formId => {
            const $form = $('#form-' + formId);
            if ($form.length) {
                setDiscountValue(formId);
                // 提交前再触发一次，防止手动修改后恢复（可选逻辑）
                $form.on('submit', () => setDiscountValue(formId));
            }
        });
    });
</script>

关键改进说明 #

• 角色传递修正：将PHP获取的用户角色用esc_js()转义后传递给JS，解决变量未定义问题
• 容错处理升级：使用可选链?.访问嵌套属性，避免角色或产品类型不存在时的JS报错；给无角色用户设置默认guest角色
• 性能优化：一次性将配置数据序列化到JS变量，避免重复处理
• 字段有效性检查：赋值前先确认折扣字段存在，避免控制台无效报错
• 代码简洁性提升：用对象解构简化变量获取，逻辑更清晰

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