July 18, 2017: Fixed issue where $result was not returned.
July 1, 2016: Fixed issue where if no quantity was specified, minimum order validation was still applied. To force a quantity to be specified, make the Product or Quantity field required.
Gravity Forms provides the ability to set a minimum per field when using a separate Quantity field but what about a minimum quantity for the entire order? This snippet can help!
| <?php | |
| /** | |
| * Gravity Wiz // Gravity Forms // Minimum Order Quantity | |
| * https://gravitywiz.com/set-a-minimum-order-quantity/ | |
| */ | |
| add_filter('gform_validation_87', function( $result ) { | |
| $result = gw_validate_minimum_quantity( $result, array( | |
| 'min_qty' => 20, | |
| 'min_qty_message' => 'Customized messaged for this group.', | |
| 'min_qty_fields' => array( 1, 2, 3 ), | |
| ) ); | |
| $result = gw_validate_minimum_quantity( $result, array( | |
| 'min_qty' => 15, | |
| 'min_qty_fields' => array( 4, 5, 6 ), | |
| ) ); | |
| return $result; | |
| } ); | |
| function gw_validate_minimum_quantity( $result, $ags = array() ) { | |
| $args = wp_parse_args( $args, array( | |
| 'min_qty' => 1, | |
| 'min_qty_message' => 'You must order a minimum of %1$d tickets. Order %2$d more tickets to complete your order.', | |
| 'min_qty_fields' => array(), | |
| ) ); | |
| $min_qty = $args['min_qty']; | |
| $min_qty_message = $args['min_qty_message']; | |
| $min_qty_fields = $args['min_qty_fields']; | |
| /* no need to edit below this line */ | |
| $form = $validation_result['form']; | |
| $quantity = 0; | |
| $qty_fields = array(); | |
| $has_entered_value = false; | |
| foreach($form['fields'] as &$field) { | |
| // if $min_qty_fields specified, make sure only applicable quantity fields are totaled | |
| if(!empty($min_qty_fields) && !in_array($field['id'], $min_qty_fields)) | |
| continue; | |
| if(in_array(RGFormsModel::get_input_type($field), array('singleproduct', 'calculation'))) { | |
| // check if product field has separate quantity field, if so skip | |
| if(sizeof(GFCommon::get_product_fields_by_type($form, array("quantity"), $field['id'])) > 0) | |
| continue; | |
| $value = rgpost( "input_{$field['id']}_3" ); | |
| if( ! rgblank( $value ) ) { | |
| $has_entered_value = true; | |
| } | |
| $quantity += GFCommon::clean_number( $value ); | |
| $qty_fields[] =& $field; | |
| } else if($field['type'] == 'quantity') { | |
| $value = rgpost( "input_{$field['id']}_3" ); | |
| if( ! rgblank( $value ) ) { | |
| $has_entered_value = true; | |
| } | |
| $quantity += GFCommon::clean_number( $value ); | |
| $qty_fields[] =& $field; | |
| } | |
| } | |
| if( ! $has_entered_value || $quantity >= $min_qty ) { | |
| return $validation_result; | |
| } | |
| for($i = 0; $i < count($qty_fields); $i++) { | |
| $qty_fields[$i]['failed_validation'] = true; | |
| $qty_fields[$i]['validation_message'] = sprintf($min_qty_message, $min_qty, $min_qty - $quantity); | |
| } | |
| $validation_result['is_valid'] = false; | |
| $validation_result['form'] = $form; | |
| return $validation_result; | |
| } |
How do I install this snippet?
Click the “Copy to Clipboard” link at the bottom of the snippet then paste the code into your theme’s functions.php file. Abracadabra!
Do I need to configure this snippet to work with my form?
Yes! This snippet has four bits to customize.
- Update the
86in the filter namegform_validation_86to the ID of your own form. - Update the
$min_qtyvariable to the minimum quantity your form should require. - Update the
$min_qty_messagevariable to the validation message which should be displayed if the minimum quantity is not met. Use%1$dto populate the minimum number of tickets require. Use%2$dto populate the number of tickets the user must add to their order to meet the minimum. The actual values will be populated when the form is validated.
Minimum Quantity Validation Message - If you wish to limit the minimum quantity requirement to a specific set of fields, enter the IDs of these fields in the
$min_qty_fields = array();array like so:$min_qty_fields = array(3, 5);. Otherwise, simply leave this variable as is.
Ready to go!
And that’s it; you’re all ready to go. If you use this snippet, we’d love to see it live on your site. Consider sharing a link to your implementation in the comments.
Need to set a maximum order quantity? Let us know and we’ll show you how to modify this snippet to do it!
Did this resource help you do something awesome with Gravity Forms? Then you'll absolutely love Gravity Perks; a suite of 29+ essential add-ons for Gravity Forms with support you can count on.
Hello, We’re getting an issue where the validation is working on the minimum order total and the form doesn’t actually get submitted or saves an entry but it is still charging the credit card. How would we overcome this?
Hi Dillon, what payment add-on are you using?
authorize.net
Hi We trying to run this code to limit the quantity in the product field. The code works fine but the one issue that we are facing is the page won’t load or give us an error message if the product field is not in the legal range. when we load the page and fill out the missing box we are supposed to get a message Variable value is not within the legal range.
what changes need to make so we get the result.
thanks
Hi Eddy, I’ve just tested the snippet locally and wasn’t able to recreate this issue. If you’re a Gravity Perks customer, we’ll be happy to provide additional support via the support form.
Thanks for the great share.
We are still receiving the ‘Oops! We could not locate your form.’ error.
Do you have any suggestions?
Thanks again!
This typically occurs when the form ID is not correct.