diff --git a/change_log.txt b/change_log.txt index 1a3f603..f1894d3 100644 --- a/change_log.txt +++ b/change_log.txt @@ -1,3 +1,6 @@ +### 1.1.1 | 2026-08-11 +- gravity-forms-abilities: Document productField auto-linking for quantity and option fields, and add the option field example to the pricing table. + ### 1.1.0 | 2026-08-04 - gravity-flow-abilities: Add the skill — workflow guidance for Gravity Flow abilities via the WordPress Abilities API (MCP), covering step CRUD, approval policies, reassignment, and feasibility consultation. - gravity-forms-abilities: Add a phone pitfall row and a phone step to the form-creation workflow; an omitted phoneFormat breaks rendering on older Gravity Forms versions. diff --git a/skills/gravity-forms-abilities/SKILL.md b/skills/gravity-forms-abilities/SKILL.md index 49077c8..34f658a 100644 --- a/skills/gravity-forms-abilities/SKILL.md +++ b/skills/gravity-forms-abilities/SKILL.md @@ -5,7 +5,7 @@ license: GPL-2.0+ compatibility: Requires a WordPress site with Gravity Forms 2.9+ and the MCP endpoint enabled (GF Settings → MCP) metadata: author: gravityforms - version: "1.0.3" + version: "1.0.4" --- # Gravity Forms Abilities — Agent Skill diff --git a/skills/gravity-forms-abilities/references/field-config.md b/skills/gravity-forms-abilities/references/field-config.md index 069c6d9..78ce3bf 100644 --- a/skills/gravity-forms-abilities/references/field-config.md +++ b/skills/gravity-forms-abilities/references/field-config.md @@ -105,12 +105,15 @@ Pricing variants are NOT standalone field types. `system-field-types` intentiona | Hidden product | `{ "type": "product", "inputType": "hiddenproduct", "basePrice": "$9.00" }` | | Calculated price | `{ "type": "product", "inputType": "calculation", "calculationFormula": "{Qty:3} * 2" }` | | Quantity for a product | `{ "type": "quantity", "label": "Qty", "productField": 1 }` (`productField` = the product field's ID) | +| Options for a product | `{ "type": "option", "label": "Add-ons", "productField": 1, "choices": [{ "text": "Gift wrap", "value": "Gift wrap", "price": "$5.00" }] }` | | Flat shipping | `{ "type": "shipping", "inputType": "singleshipping", "basePrice": "$5.00" }` | | Shipping options | `{ "type": "shipping", "inputType": "select", "choices": [{ "text": "Ground", "value": "Ground", "price": "$5.00" }] }` | | Order total | `{ "type": "total", "label": "Total" }` | The API applies the same defaults the editor would: bare `type: product` becomes `inputType: singleproduct`; single/hidden/calculation products get their `.1` (name) / `.2` (price) / `.3` (quantity) sub-inputs created automatically; choice-based product and shipping fields get `enablePrice` set (required — without it, priced submissions fail GF's anti-tampering state validation). +`productField` on `quantity` and `option` fields: if omitted, current Gravity Forms links the field to the **nearest preceding product field** in the form. That is only safe on single-product forms — ALWAYS set `productField` explicitly when the form has more than one product. + **Submitting pricing fields:** - Single product: `"input_1.1": "Widget"`, `"input_1.2": "$25.00"`, and `"input_1.3": "2"` for quantity (or use a separate quantity field: `"input_3": "2"`).