Better Inventory with Gravity Forms

• March 10, 2021: Fixed a potential HTML markup issue.

• November 10, 2020: Migrated to Snippet Library. Fixed an issue where Auth.net would still charge for the submission even when validation error was returned.

• October 18, 2019: Fixed issue where field groups were not correctly limited on submission.

• October 10, 2019: Fixed issue where Calculated Product fields were still added to order summary after their inventory was exhausted.

• March 19, 2019: Fixed issue where remaining shortcode did not always target correct instance of Better Inventory.

• November 17, 2018: Added support for fetching prepopulated values when limiting by field group.

• April 26, 2018: Updated snippet for Gravity Forms 2.3; snippet now requires 2.3.

• May 31, 2017: Updated "remaining" shortcode to correctly limit by field groups and approved payments flag.

• January 27, 2017: Fixed bug with approved_payments_only parameter where entries with no payment were counting towards all inventory limits.

• January 21, 2017: Added support for automatically limiting GP Limit Date-enabled Date fields and paired with an inventory input (via field_group parameter) so that days with exhausted inventory or not available.

• January 17, 2017: Updated "remaining" shortcode to dynamically retrieve the limit for the specified form and field.

• March 23, 2016: Added support for specifying "stock_qty" parameter as a function. Allows for dynamically setting the stock_qty during runtime.

• March 15, 2016: Updated paid status to "Paid" from "Approved" to work with GF Payment Add-on framework.

• October 5, 2014: Added support for "remaining" action on [gravityforms] shortcode.

• October 1, 2014: Added support for "sum" action on [gravityforms] shortcode.

• November 11, 2012: Fixed issue where database prefix was not applied via $wpdb->prefix.

Overview

Gravity Forms does not support the concept of inventory out of the box. This snippet provides an easy method for setting up simple, one-off inventory limits on a per field basis.

1. Overview
2. Using the Snippet
   1. Prerequisites
   2. Add a Product Field
   3. Update Snippet with Parameters
      1. Custom Stock Level Messages
         1. Out of Stock
         2. Not Enough Stock
3. Parameters
4. Shortcodes
5. Taking It Further
   1. Approved Payments

Using the Snippet

Prerequisites

Confirm that you have Gravity Forms installed and activated and that you’ve installed the snippet.

Add a Product Field

With the snippet installed, add a Product field to your form. Note the Product field’s ID.

Update Snippet with Parameters

Update the form_id and field_id in the snippet to match your Form ID and Field ID. Depending on the way your form is set up, you’ll need to format the Field IDs differently:

• If your form uses a separate Quantity field for the Product’s quantity, set the field_id to the Quantity field’s ID.
• If your Product uses the built-in quantity sub-field, set the field ID to your Product ID and add .3 to the end.

new GW_Inventory( array(
    'form_id'                  => 123,
    'field_id'                 => 4.3,
    'stock_qty'                => 20,
) );

Custom Stock Level Messages

Better Inventory includes default “out of stock” and “not enough stock” messages. These messages can be customized using the out_of_stock_message and not_enough_stock_message parameters.

new GW_Inventory( array(
    'form_id'                  => 123,
    'field_id'                 => 4.3,
    'stock_qty'                => 20,
    'out_of_stock_message'     => 'Sorry, there are no more tickets!',
    'not_enough_stock_message' => 'You ordered %1$s tickets. There are only %2$s tickets left.',
) );

Out of Stock

The “out of stock” message is displayed when the product limit has been reached. You can get fancy with this and add HTML. Be sure to escape any double quotes with a backslash. Here’s an advanced example:

$sum_limit_message = '<div style="border: 1px solid #e6db55;background-color: #FFFFE0;padding: 10px">Sorry, this show is sold out.</div>';

Better Inventory: Limit Message

Not Enough Stock

The “not enough stock” message is displayed on the field if the limit has not been reached, but the user’s requested quantity would exceed the product limit.

Better Inventory: Limit Validation Message

Parameters

• form_id (integer) (required)

  The ID of the form you are working with.

• field_id (integer|float) (required)

  The ID of your product or quantity field. If using a Single Product field, specify the quantity input ID, which will always be {field ID}.3. If using a separate Quantity field, simply specify the field ID.

• stock_qty (integer) (required)

  The number of this item you have available.

• out_of_stock_message (string) (optional)

  The message which should be displayed to users when the product limit has been reached.

• not_enough_stock_message (string) (optional)

  The message which should be displayed on the field if the limit has not been reached, but the user’s requested quantity would exceed the product limit.

• approved_payments_only (boolean) (optional)

  Indicate whether all submissions for this field should be counted against the limit or only submissions with an approved payment.

• hide_form (boolean) (optional)

  By default this snippet will only hide the field when the limit has been reached. If you would rather hide the entire form, set this to true.

• enable_notifications (boolean) (optional)

  Enable the ability to create notifications that are sent when the stock of a product (or any configured field) has been exhausted

Shortcodes

• Remaining
  Show the quantity remaining for the specified input and limit. [gravityforms action="remaining" id="1" input_id="2.3" limit="50"]

• Sum
  Show the current sum of quantities ordered for this field across all entries. [gravityforms action="sum" id="1" input_id="2.3"]

Taking It Further

Approved Payments

By default, all submissions are counted against the stock quantity. Use the approved_payments_only parameter to indicate that only submissions with an approved payment should be counted. You’ll want to be careful here when using PayPal Standard due to the delay between the form submission and the payment being approved. It could lead to users exceeding the limit.

new GW_Inventory( array(
    'form_id'                  => 123,
    'field_id'                 => 4.3,
    'stock_qty'                => 20,
    'approved_payments_only'   => true,
) );