| @@ -1,0 +1,218 @@ | ||
| 1 | +=== Repeater Fields for Gravity Forms === | |
| 2 | +Contributors: addonsorg | |
| 3 | +Tags: Gravity Forms, Gravity Forms fields, Repeater, Repeater form, Repeater field | |
| 4 | +Requires at least: 2.0 | |
| 5 | +Tested up to: 7.1 | |
| 6 | +Stable tag: 3.2.3 | |
| 7 | +Requires PHP: 5.2 | |
| 8 | +License: GPLv2 or later | |
| 9 | +License URI: https://www.gnu.org/licenses/gpl-2.0.html | |
| 10 | + | |
| 11 | +The Repeater Fields for Gravity Forms allow you to create one or more sets of fields that can be repeated. | |
| 12 | + | |
| 13 | +== Description == | |
| 14 | + | |
| 15 | +[youtube https://www.youtube.com/watch?v=gaWE0IqjYsI] | |
| 16 | + | |
| 17 | +**DEMO**: <https://demo.add-ons.org/demo-repeater-fields/> | |
| 18 | +**Document**: <https://add-ons.org/document-gravity-forms-repeater-fields/> | |
| 19 | +**Download Pro Version**: <https://add-ons.org/plugin/gravity-forms-repeater-fields/> | |
| 20 | + | |
| 21 | +The Repeater Fields for Gravity Forms allow you to create one or more sets of fields that can be repeated. | |
| 22 | + | |
| 23 | +Have you ever wanted to let your users submit multiple entries of the same field set as a single form on your WordPress site? If so, you’re in luck! This is a plugin to help you do it! | |
| 24 | + | |
| 25 | +### Pricing & Payment Fields Support (Pro) | |
| 26 | +Easily create repeatable booking, ticket, quotation, or registration forms! With the Pro version, you can place Gravity Forms **Pricing Fields** (Product, Option, Quantity, and Total) directly inside your repeaters: | |
| 27 | +* **Row Total & Grand Total Support**: Place a Total field inside repeater rows to calculate each row's subtotal `(Product + Options) * Quantity`, and place a Total field outside the repeater to calculate the Grand Total of all rows combined! Both can be used together seamlessly. | |
| 28 | +* **Real-time Price Calculation**: The form's Total field updates dynamically in real time as customers add, remove, or modify repeated rows. | |
| 29 | +* **Supports All Product Types**: Single Product, Drop Down, Radio Buttons, User Defined Price, and Calculation products. | |
| 30 | +* **Option & Quantity Support**: Sub-options (Drop Down, Radio, Checkboxes) and item quantities are calculated per individual repeater row. | |
| 31 | +* **Payment Gateways Integration**: Seamlessly passes line items and totals to payment add-ons including Stripe, PayPal, Mollie, Square, and Authorize.net. | |
| 32 | +* **Detailed Order Summary**: View entry details with full itemized breakdown (Row 1, Row 2, etc.) for admin review, notifications, and customer emails. | |
| 33 | + | |
| 34 | +### Dynamic Initial Rows Count & Field Mapping (Pro) | |
| 35 | +Control exactly how many rows appear when the form loads, or bind repeater row counts dynamically to another form field: | |
| 36 | +* **Custom Initial Rows Count**: Set any specific number of rows to display by default upon page load (e.g., start with 0, 1, 3, or more rows). | |
| 37 | +* **Smart Field Mapping**: Connect the repeater directly to another field in your form (such as a Number, Drop Down, or Quantity field) using its Field ID. | |
| 38 | +* **Instant Dynamic Row Generation**: When the user enters or selects a number (e.g., "Number of Attendees: 4"), the repeater automatically expands to create exactly 4 rows in real time. | |
| 39 | +* **Streamlined User Experience**: Optionally locks the row count and hides manual "+ Add Row" / delete buttons when mapped, preventing submission mismatches for ticket bookings, group registrations, and order forms. | |
| 40 | + | |
| 41 | +### Save and Continue Later Support | |
| 42 | +Fully compatible with Gravity Forms' built-in **Save and Continue Later** feature! When users save their unfinished submission and return via the save token link: | |
| 43 | +* **Preserves All Repeated Rows**: All added rows are automatically re-created in their exact order. | |
| 44 | +* **Restores Field Data**: Inputs including text, numbers, dates, checkboxes, radio buttons, and pricing choices are restored. | |
| 45 | +* **Retains Uploaded Files**: Attachments and files uploaded inside repeater rows are safely preserved across draft sessions. | |
| 46 | + | |
| 47 | +== Features == | |
| 48 | +- **Row Subtotal & Grand Total Support (Pro)**: Supports Total fields both inside repeater rows (as row subtotal) and outside repeater (as grand total), or both at once. | |
| 49 | +- **Initial Rows & Field Mapping (Pro)**: Set custom default row counts or link repeater rows dynamically to a number/dropdown field (e.g., Number of Guests/Tickets). | |
| 50 | +- **Save and Continue Later Support**: Seamlessly saves and restores all repeated rows and input values when resuming draft submissions. | |
| 51 | +- **Pricing & Payment Fields (Pro)**: Calculate Product, Option, and Quantity inside Repeater rows with real-time Total calculation and payment gateway integration. | |
| 52 | +- **File Uploads Support**: Allow single or multiple file uploads inside repeated rows. | |
| 53 | +- **Minimum Rows**: Sets a limit on how many rows of data are required. | |
| 54 | +- **Maximum Rows**: Sets a limit on how many rows of data are allowed. | |
| 55 | +- **Button Label**: Customizable text shown on the ‘Add Row’ button. | |
| 56 | +- **Conditional Logic support**: Supports conditional logic inside and outside repeaters. | |
| 57 | +- **Date picker support**: Full date/time picker support inside repeated fields. | |
| 58 | +- **Entry and print preview support**: Easily view, export, and print repeated entries. | |
| 59 | +- **Drag and drop repeatable fields**: Simple and flexible form builder experience. | |
| 60 | + | |
| 61 | +== Pro Version == | |
| 62 | +* Dynamic Initial Rows count & Field Mapping (Auto-generate rows based on user input) | |
| 63 | +* Pricing & Payment Fields support (Product, Option, Quantity, Total) | |
| 64 | +* Real-time Total price calculation on add/remove rows | |
| 65 | +* Payment gateways integration (Stripe, PayPal, Mollie, Square, etc.) | |
| 66 | +* Order summary breakdown per repeater row | |
| 67 | +* File Upload Support (Single & Multi-file) | |
| 68 | +* Conditional Logic support | |
| 69 | +* Unlimited minimum & maximum rows | |
| 70 | +* 30-day money-back guarantee | |
| 71 | +* 1-year support | |
| 72 | + | |
| 73 | +== Installation == | |
| 74 | +**Normal installation** | |
| 75 | + | |
| 76 | +1. Download the repeater-for-gravity-forms.zip file to your computer. | |
| 77 | +2. Unzip the file. | |
| 78 | +3. Upload the `repeater-for-gravity-forms` directory to your `/wp-content/plugins/` directory. | |
| 79 | +4. Activate the plugin through the 'Plugins' menu in WordPress. | |
| 80 | +5. Document: https://add-ons.org/document-gravity-forms-repeater-fields/ | |
| 81 | + | |
| 82 | +== Frequently Asked Questions == | |
| 83 | + | |
| 84 | += What is "Initial Rows Count" and how does "Field Mapping" work? = | |
| 85 | +**Initial Rows** allows you to choose how many rows are automatically displayed when the form loads. If you set it to 0, no rows show up until the user clicks "+ Add Row"; if set to 3, three rows appear immediately. | |
| 86 | + | |
| 87 | +**Field Mapping with Initial Rows** allows you to enter the Field ID of another field in the form (such as a Number or Dropdown field asking "How many guests/tickets?"). When the user selects or enters a number (e.g., 4), the repeater automatically renders exactly 4 rows in real time without requiring the user to click "+ Add Row" four times. | |
| 88 | + | |
| 89 | += Does it work with Gravity Forms Save and Continue Later? = | |
| 90 | +Yes! The plugin fully integrates with Gravity Forms' "Save and Continue Later" feature. When users save their progress, all repeated rows and entered field values are saved to the draft. When they open the resume token link (`?gf_token=...`), the entire repeater structure, all field values, and uploaded files are automatically restored. | |
| 91 | + | |
| 92 | += Can I use Pricing, Product, and Option fields inside the repeater? = | |
| 93 | +Yes! With the Pro version, you can place Product, Quantity, and Option fields between Repeater Start and Repeater End. The form Total automatically updates as users add/remove rows or change values. | |
| 94 | + | |
| 95 | += Does it work with payment gateways like Stripe and PayPal? = | |
| 96 | +Yes, in the Pro version, line items from each repeater row are properly registered in Gravity Forms order info (`gform_product_info`), allowing Stripe, PayPal, and all Gravity Forms payment add-ons to charge the accurate order total. | |
| 97 | + | |
| 98 | += How do repeated products appear in Entry Details and Confirmation Emails? = | |
| 99 | +Each repeated row is itemized in the Order Summary table (e.g., "Ticket (Row 1)", "Ticket (Row 2)") along with chosen options, quantities, and subtotal. | |
| 100 | + | |
| 101 | +== Screenshots == | |
| 102 | + | |
| 103 | +1. Frontend Working | |
| 104 | +2. Backend Field | |
| 105 | +3. Admin builder | |
| 106 | + | |
| 107 | +== Changelog == | |
| 108 | += 3.2.1 = | |
| 109 | +- Added: Pricing Fields support in Repeater (Pro) - Dynamic calculation for Product, Option, Quantity fields and payment gateway integration. | |
| 110 | +- Added: Full support for Save and Continue Later - Automatically preserves and restores all repeated rows, entered field values, and files when resuming via draft token link. | |
| 111 | + | |
| 112 | += 3.2.0 = | |
| 113 | +- Fixed: Radio field Required | |
| 114 | + | |
| 115 | += 3.1.1 = | |
| 116 | +- Fixed: Resolved '$element.datepicker is not a function' error by adding jquery-ui-datepicker dependency. | |
| 117 | +- Fixed: security issue | |
| 118 | + | |
| 119 | += 3.0.3 = | |
| 120 | +- Fixed: state_validation | |
| 121 | + | |
| 122 | += 3.0.1 = | |
| 123 | +- Fixed: Input Mask | |
| 124 | + | |
| 125 | += 3.0.0 = | |
| 126 | +- Fixed: PHP Fatal error: Declaration of Superaddons_GFRepeater_Field::get_field_label | |
| 127 | + | |
| 128 | += 2.5.1 = | |
| 129 | +- Fixed: upload field on multi-step form | |
| 130 | + | |
| 131 | += 2.5.0 = | |
| 132 | +- Fixed: Phone field | |
| 133 | + | |
| 134 | += 2.4.5 = | |
| 135 | +- Fixed: conditional logic radio | |
| 136 | + | |
| 137 | += 2.4.4 = | |
| 138 | +- Added: Fixed Required upload field | |
| 139 | + | |
| 140 | += 2.4.2 = | |
| 141 | +- Added: Translate | |
| 142 | + | |
| 143 | += 2.4.0 = | |
| 144 | +- Fixed: Save datas | |
| 145 | + | |
| 146 | += 2.3.5 = | |
| 147 | +- Fixed: Required field | |
| 148 | + | |
| 149 | + | |
| 150 | += 2.3.4 = | |
| 151 | +- Fixed: CSS Orbital Theme | |
| 152 | +- Fixed: Date select type | |
| 153 | + | |
| 154 | += 2.3.2 = | |
| 155 | +- Fixed: for label | |
| 156 | + | |
| 157 | += 2.2.7 = | |
| 158 | +- Fixed: Checkbox label | |
| 159 | + | |
| 160 | += 2.2.6 = | |
| 161 | +- Fixed: Important | |
| 162 | + | |
| 163 | += 2.2.5 = | |
| 164 | +- Fixed: Compatible with Gravity Forms Chained Selects Add-On | |
| 165 | + | |
| 166 | += 2.2.4 = | |
| 167 | +- Fixed: Multi Select field | |
| 168 | + | |
| 169 | += 2.2.3 = | |
| 170 | +- Fixed: https://wordpress.org/support/topic/possible-bugfix-fieldids-99-breaking-conditional-logic/ | |
| 171 | + | |
| 172 | += 2.2.2 = | |
| 173 | +- Fixed: Upload multiple files | |
| 174 | + | |
| 175 | += 2.2 = | |
| 176 | +- Fixed: Conditional logic | |
| 177 | + | |
| 178 | += 2.1.6 = | |
| 179 | +- Fixed: set Initial Rows = 0 | |
| 180 | + | |
| 181 | += 2.1.5 = | |
| 182 | +- Fixed: Conditional logic out repeater | |
| 183 | + | |
| 184 | += 2.1.4 = | |
| 185 | +- Fixed: Save Radio submit | |
| 186 | + | |
| 187 | += 2.1.3 = | |
| 188 | +- Fixed: Export entries | |
| 189 | + | |
| 190 | += 2.1.2 = | |
| 191 | +- Fixed: Maps with field | |
| 192 | + | |
| 193 | += 2.1.0 = | |
| 194 | +- Fixed: Uncaught ReferenceError: gform is not defined | |
| 195 | + | |
| 196 | += 2.0.9 = | |
| 197 | +- Fixed: Radio | |
| 198 | + | |
| 199 | += 2.0.8 = | |
| 200 | +- Fixed: Conditional logic with end repeater | |
| 201 | + | |
| 202 | += 2.0.7 = | |
| 203 | +- Fixed: Conditional logic | |
| 204 | + | |
| 205 | += 2.0.6 = | |
| 206 | +- Fixed: Input Mask | |
| 207 | + | |
| 208 | += 2.0.5 = | |
| 209 | +- Fixed: shortcode end tags | |
| 210 | + | |
| 211 | += 2.0.4 = | |
| 212 | +- Fixed: Active the plugin | |
| 213 | + | |
| 214 | += 2.0.3 = | |
| 215 | +- Fixed: Big update | |
| 216 | + | |
| 217 | += 1.0 = | |
| 218 | +- Version 1.0 Initial Release | |
