Gravity Forms Advanced Calculations

What does it do?

Advanced Calculations completely revamps calculations in Gravity Forms. Not only does it empower you with advanced mathematical functions and conditionals, it improves the formula editing experience with a powerful new editor, complete with syntax highlighting, autocompletion, shorthand field references, and so much more!

With Advanced Calculations you can create:

• Mortgage calculators
• Advanced calculated products
• Auto loan calculators
• Investment/Retirement calculators
• BMI calculators
• And many more!

Features

Documentation

1. How do I enable this functionality?
2. Feature Details
   1. Merge Tag Shorthand
   2. Conditional Statements
      1. if/else
      2. if/elseif/else
   3. Syntax Highlighting
   4. Tooltips
   5. Functions
      1. Absolute Value – abs
      2. Average – average
      3. Ceiling – ceil
      4. Exponential – exp
      5. Floor – floor
      6. Future Value – fv
      7. Natural Logarithm – ln
      8. Logarithm – log
      9. Maximum – max
      10. Minimum – min
      11. Pi – pi
      12. Round – round
      13. Square Root – sqrt
3. Known Limitations
4. Hooks

How do I enable this functionality?

After installing and activating Gravity Forms Advanced Calculations,

	Add a Number field to your form.
	Check Enable Calculation.
	Insert advanced calculations into form. Use the Formula Cheatsheet for a primer on calculations.

Feature Details

Merge Tag Shorthand

The true power of calculations with Gravity Forms comes from being able to reference other fields to create calculations from what users have entered. Gravity Forms uses merge tags to reference fields. Merge tags are referenced using the field ID, with or without the descriptor, such as {Field A:1} or {:1}.

Gravity Forms Advanced Calculations adds shorthand for fields to clean up your calculations and make it easier to keep track of everything. The shorthand for the same field shown above is written as F1.

Shorthand offers more readable calculations, especially for complicated functions.

Conditional Statements

Advanced Calculations supports conditional statements such as if/else and if/elseif/else. Use these statements to evaluate calculations based on field values.

if/else

if( F1 > 1.25 && F1 < 5.5 ):
	F1 * 50
else:
	0
endif;

if/elseif/else

if( F1 < 5.5 ):
	F1 * 50
elseif( F1 >= 10 ):
	F1 * 25
else:
	0
endif;

Supported Operators

The following comparison operators are supported:

• == Equal to
• != Not equal to
• > Greater than
• < Less than
• >= Greater than or equal to
• <= Less than or equal to

Multiple Expressions

Conditional statements support multiple expressions within a single condition via the the && (and) or the || (or) operators.

To require both expressions to be true for the condition to match, you would use the && operator. In this example, the condition will only be true if Field #1 is greater than 5 and less than 10.

if ( F1 > 5 && F1 < 10 ):

If you would like your condition to match if any of the conditions are true, you would use the || operator. In this example, the condition will return true if Field #1 is greater than 5 or if Field #2 is greater than 5.

if ( F1 > 5 || F2 > 5 ):

While these examples are simple, this functionality is quite robust and can handle conditions that contain expressions with both && and || operators.

Syntax Highlighting

Advanced Calculations adds syntax highlighting and autocompletion to the calculation text area. Syntax highlighting drastically improves the readability of calculations, especially complicated ones that use conditional statements and functions.

Autocompletion aids you when inputting a function or conditional statement. When you start typing any supported function, the editor will suggest a completion. Click the suggested function (or hit return) to insert the full function with placeholder values.

The editor also automatically closes parentheses and merge tag braces. Say goodbye to invalid formulas because of an errant parenthesis!

Tooltips

When hovering over shorthand field variables and merge tag field variables with no descriptor in the formula editor, you will see a tooltip displaying the field’s label.

Functions

Advanced Calculations adds support for common functions to both save you time and effort and provide more accurate results.

abs( -78 )

abs( F1 )

abs( value )

abs( -14 )

average( F1, F2, 26 )

average( 1, 2, 3, 4, F1 )

average( value1, [value2, ...] )

average( 12, 58, 35 )

ceil( 25.4 )

ceil( F1 )

ceil( value )

ceil( 35.8 )

exp( 25.4 )

exp( F1 )

exp( value )

exp( 5 )

floor( 75.763 )

floor( F3 )

floor( value )

floor( 323.78 )

fv( F1, F2/12, F3, 10000, 1 )

fv( 0.05, 10, F1, F2 )

fv( rate, numberOfPeriods, paymentAmount, presentValue, [endOrBeginning] )

fv( 0.0311, 60, 450, -25000, 0 )

ln( 23 )

ln( F4 )

ln( value )

ln( 491 )

log( 7 )

log( F2 )

log( value )

log( 49 )

max( F1, F4, 67 )

max( 108, F7 )

max( value1, [value2, ...] )

max( 36, 49 )

min( F3, 56, F8 )

min( 3, F1 )

min( value1, [value2, ...] )

min( 18, 6 )

pi()

pi()

pi()

round( 12.7 )

round( F2 )

round( value )

round( 8.68 )

sqrt( F12 )

sqrt( 72 )

sqrt( value )

sqrt( 144 )

Known Limitations

• Non-numeric values are not supported in conditional statements.

Hooks

• gpac_should_clean_merge_tag_value (JS)