如何通过查询字符串为Gravity Forms复选框字段动态赋值

你可以顺利通过查询串为单值文本字段赋值，但尝试多种写法都无法触发复选框自动勾选，核心原因是Gravity Forms对复选框这类多选项字段的参数解析规则，和单值文本字段完全不同，你之前的所有尝试都没有匹配这个规则。

前置必做检查 #

写查询字符串前，先完成两项基础设置，否则所有参数传值都不会生效：

• 打开对应flags复选框字段的编辑面板，勾选「允许通过查询字符串动态填充」选项
• 确认字段的动态填充参数名称就是flags，没有被系统自动替换为其他默认标识

正确的查询字符串格式 #

Gravity Forms 对复选框动态值的识别逻辑非常固定：它不会解析嵌套键、布尔类型的传值，只会抓取对应参数名下、无自定义键的索引数组值，逐一匹配内置的选项标识完成勾选。
正确的传值写法为：

• 仅勾选box1选项：

https://www.example.com/formpage/?textfield=value&flags[]=box1

• 同时勾选box1和box2两个选项：

https://www.example.com/formpage/?textfield=value&flags[]=box1&flags[]=box2

之前尝试失效的原因对照 #

你试过的所有写法无法生效，都能对应到具体的规则不匹配问题：

• flags.box1=true、flags[box1]=true 这类带嵌套键的写法：系统只识别flags作为顶层参数名，不会把嵌套的子键当成选项定位标识，更不会匹配true这类不属于选项值的内容
• flags=box1 这类直接传单值字符串的写法：系统默认将复选框字段的入参识别为数组结构，直接传字符串值时，解析逻辑无法完成选项匹配
• flags.box1=1、flags[box1]=1 这类传数值/布尔值的写法：动态填充是靠选项的实际参数值（也就是box1、box2这类自定义标识）定位选项，传1这类值根本匹配不到对应选项，自然无法触发勾选状态

易踩坑注意事项 #

• 每个需要勾选的选项，必须单独写一个flags[]=对应选项值的键值对，不要把多个选项值用逗号拼接在同一个参数里
• 传入的选项值必须和字段设置里给每个选项配置的「参数值」完全一致，不要传选项的前端展示文本，否则会匹配失败

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