Table of Contents

DOCS

What is Gravity Cloud?

For Gravity Forms Users

Gravity Cloud form recipes enable you to compose Gravity forms together to generate new forms. Single source of truth updates allows you to change an ingredient and have it reflected everywhere. Time travel with undo/redo functionality enables speed and confidence to experiment with new form models and revert with a click of a button.  Gravity Cloud connects to any instance of Gravity Forms via API.

For WooCommerce & Gravity Forms Product Add-ons Users

Gravity Cloud enables merchants to sell complex/custom products online.  Gravity Cloud is a service that connects to your existing eCommerce platform to enable you to simplify the management of your products.  There are no installs or plugins required. 

  • Gravity Cloud is SaaS product 
  • Adds a layer of automation and composable commerce 
  • Supports complex conditional logic
  • Undo / Redo, with history time travel
Is it safe to try the service to see if I can benefit from it?  

Absolutely,  the service does not add anything proprietary to your site, it simply automates the work you are doing by hand.

Requirements

For Gravity Forms Users

Gravity Cloud connects to any instance you have that has Gravity Forms installed. Gravity Cloud connects by API and supports Gravity Forms API Version #1 and Version #2.

 For WooCommerce & Gravity Forms Product Add-ons Users

Gravity Cloud requires your WooCommerce store is running with:

  1. Gravity Forms
  2. Gravity Forms Product Add-on
  3. Follow instructions to Setup Gravity Forms Add-on

Setup

Connecting Gravity Cloud to Gravity Forms:

  1. Five Minute Setup (video)
  2. Create a Gravity Cloud Account
  3. Create a Domain Group
  4. Connect  to your Gravity Forms API

Five Minute Setup (video)

Learn how to set up gravity cloud by watching this 5 minute video.
Play Video

Create a Gravity Cloud Account

You can create an account with a username and password or log in with a Google account.  Once you have created an account, opt-in to the beta program, and we will enable your account to get started connecting to your store.
Click Register to create an account with email password, or click Sign in with Google (no account creation requried)
Create account with email & password

Create a Domain Group

Once logged in, you will need to create a Domain Group.  The domain group is a logical grouping of web properties.  For example, with ELITE, we have three web properties (staging, pre-prod, prod).

Connect  to your Gravity Forms API

Gravity Cloud connects to your site via the Gravity Forms API.  Add all your web properties and API keys to connect to the API.  Once you have entered the details in the dialogue below, you will be ready to start creating form recipes.

Two web properties defined. The Staging is the source of components and the Target for products.

Domain Group Name – Usually the web property name.  This is the umbrella for the various web properties you set up. Shown in the left hand navigation.

Gravity Forms API Version – Supports both Version #1 and #2 of the API.  Version #2 is reco

Company URL – Optional URL to a company logo.

Source – Select the domain that has the form components that will be composed by Product recipes.

Domain Name – The domain with Gravity forms installed

Target – Select the domain that is the target of the form recipes.

Consumer Key – Create a new key for Gravity Cloud in the Gravity Forms API panel on WordPress and copy/paste the Consumer Key to this field. 

Consumer Secret – Copy/paste the consumer secret from the new key.

Component Filter – The component filter is a prefix that limits the forms available for building a product.  It is recommended that you set this to “Comp”.  Only forms that start with Comp will be fetched for the ingredients to build a product.

Default Value Product

Form Target Filter – The Target filter is a prefix that is defined to filter the Gravity Forms on your servers.  It is recommended to use “Product” for this field.  When set to “Product” only Gravity Forms that start with Product are fetched for the Target build of a Product.

Default Value Comp

Recipes/Products

Create Recipes

Recipes combine many Gravity Forms (components) into one Gravity Form (product). 

This short video demonstrates how to create a recipe/product in Gravity Cloud. In the video I have also installed Gravity Forms Product AddOn so that I can demonstrate the power of composable forms in an eCommerce context.

Play Video

Product Form 

Every Recipe in Gravity Cloud needs a single Gravity Form on the server to hold the rendered Product.  Create an empty Gravity Form (with the prefix of Product) that will hold the results of the rendered recipe. Documentation for creating Gravity Forms can be found here.

Important make sure to use the same prefix as the Target Filter, the default is to use a prefix of Product

Create Component

The building blocks of a Recipe in Gravity Cloud are components.  This short video demonstrates how to create a new Component and add it to your Recipe.

Detailed documentation for Gravity Forms here. 

Important make sure to use the same prefix as the Component Filter, the default is to use a prefix of Comp

The Component filter must match the start of your Form name.  For example, if you want to make a form for WidgetA your form name should be Comp WidgetA.  If your filter and Form prefix does not match you will not see the form in Gravity Cloud.

Deploy Recipes/Product

There are two options to deploy Recipes/Products to your Word Press sites.

  1. Deploy Individual Recipes
  2. Deploy all Recipes

Watch this short video that explains how to deploy a single Recipe to your site and how to do a full deploy of all recipes.

Play Video

Time Travel

Gravity Cloud backs up and versions all Components and Recipes/Products securely in the Cloud enabling the power of time travel for your entire store. Imagine the flexibility and experimentation possible when you have a one-click undo. Create a Black Friday sale, run it, and revert in seconds when complete.

  1. Single Recipe time travel
  2. Full deploy time travel
Play Video

Single Recipe time travel

Select History from the top navigation to access full deploy history

All product deploys are listed from newest to oldest.  You can restore any previous deploy.  Restores restore both the recipe and target forms.

Full deploy time travel

Select History from the top navigation to access full deploy history

All full deploys are listed from newest to oldest.  You can restore any previous full deploy.  Restores restore both the recipe and target forms.

Select the Restore button for any full deploy

Trouble Shooting

If you see the following then the API call to Gravity Forms on your Word Press site has failed:

  1. A red icon next to “Gravity Forms” in the toolbar
  2. A error message that includes the URL Site where the API connection failed
FAILED CONNECTION TO GRAVITY FORMS API

What does a successful connection to my Word Press Gravity Forms API look like?

  1. A green icon next to “Gravity Forms” in the toolbar
  2. No error message
SUCCESSFUL CONNECTION TO GRAVITY FORMS API
The most common issues you may encounter when trying to connect to Gravity Forms on your Word Press site:

Connection Details are incomplete or incorrect

  • Domain Name – This is the domain name of your WP instance. Make sure the format is as follows https://www.mydomain.com.  You must have a secure HTTPS connection; we will not connect to an HTTP instance.
  • For Gravity Forms API Version #2, make sure you have the correct Consumer Key, Consumer Secret
  • For Gravity Forms API Version #1, ensure you have the correct Public Key, Private Key. We recommend you use Version #2. In time we will be deprecating Version #1 of the API.

Gravity Forms Filters are filtering out your forms

  • The filters are used to separate Target Gravity Forms from Component Gravity Forms. If you are not seeing your Gravity Forms within the App, then we recommend removing both filters and then click the “Gravity Forms” link in the top navigation
  • Once the connection is working, you can add the filters back.

    Web Application Firewall (WAF) blocks calls to the Gravity Forms API

    • If your Word Press site is using Cloudflare, Sucuri or any other WAF then you may need to add an “Allow URL Path” as follows:
      • /wp-json/gf/v2
    • If you are having issues configuring the WAF then please Contact Us to help support you in getting set up.

    Basic Authentication (Password Protection) blocks calls to the Gravity Forms API

    • If your Word Press site has basic authentication set up, then Gravity Cloud will not be able to access the Gravity Forms API.
    •  Instead of using Basic Authentication, try a Plugin such as Password Protection.  Using the Plugin the Gravity Forms API is still accessible to connect to.