Overview
Gravity Flow Blocks let you embed Gravity Flow functionality directly into WordPress posts, pages, and other content areas. Four blocks are available.
Note: Each block is designed for independent use do not place multiple Gravity Flow blocks on a single post or page.
Status Block
This block displays the Status page, where you can find all your submitted Workflows. By default, users will only see their own forms. Administrators will see all forms. The Status block does not currently support a live data preview.
The Status Block and Inbox Block both provide settings in relation to two views:
List View
Showing the user a list of multiple entries with a subset of columns of data about each one.
Detail View
Showing the user a single entry in more detail. The current step an entry is on in its’ workflow will determine what fields of data are shown while the
Each view has a separate set of display settings to define what the block will/not present to the site visitor.
List View Display Settings
| Setting | Description |
|---|---|
| Entry ID | Whether to show or hide a column for the ID of the entry |
| Submitter | Whether to show or hide a column for the name of the user who submitted the entry originally. |
| Step | Whether to show or hide the name of the current step an entry is on in its workflow. If the entry is complete this column value will be blank. |
| Last Updated | Whether to show or hide the date/time that the entry was last updated. |
| Filter Form(s) | Provides a select box to limit the entries to be based on a specific form. If you select a single form you can then also define specific fields which should be shown in the list view. Note that the status list can be filtered by multiple forms, however, field values can only be displayed if only one form is selected. |
Bulk Actions
The Bulk Actions dropdown lets you perform an action on multiple selected entries at once. Available actions include Print, which generates a printable view of the selected entries, and Restart Workflow, which resets the workflow from the beginning. The Send to Step options forward selected entries to a specific step in the workflow, such as User Input, Flow, or Approval Step (Manager). The available Send to Step options vary depending on the form. Bulk actions are only available when the Status screen is filtered to a single form.
Detail View Display Settings
| Setting | Description |
|---|---|
| Timeline | Show or hide the timeline on the entry details screen. The timeline lists who performed what activity or steps up to the point the entry is at in its current workflow. |
| Step Status | Whether to show the current step, its status and assignee(s) as a part of the Workflow Details section. |
| Workflow Details | Whether to show the Workflow Details section which contains the entry ID, submitted date, submitter and status. |
| Sidebar | Whether the entry details page should display in a 1-column or 2-column layout. |
| Back Link | Whether to show a link to get from the detail view back to the list view. If this setting is active, two additional sub-settings are presented: Back Link Text allows you to replace the default ‘Return to list’ text with something more contextually relevant for your website. Custom Inbox URL (Optional) lets you customize the URL to return users to from the entry detail page, useful if you have multiple pages with different Inbox/Status blocks on them or Gravity Views. |
Inbox Block
This block displays the Inbox Page, pre-filtered to entries where the site is defined as an assignee for the current step. It provides a way to control what appears on the page in both the list and detail views.
In addition to the display settings that the Inbox and Status Block share, the List View of the Inbox has 3 additional settings:
| Setting | Description |
|---|---|
| Highlight | Whether to show the step highlight at the left side of the row if any have been defined in the current step settings. |
| Approval Actions | Whether to show a column with options for assignees to bulk approve or reject directly from the inbox without having to open up the workflow detail page. See the Inbox Page or how to configure an approval process for more details on how to make best use of this setting. |
| Due Date | Whether to show a column with the due date associated to the current step of each entry if it is defined in the step settings. The selected color will override the highlight if that setting is also active for the block. |
Reports Block
The Reports block displays reports based on one or more forms which can show a variety of charts for completed workflows and average duration by month, step, and assignee. Their goal is to help you:
- Track the ongoing performance of your workflows
- Identify potential bottlenecks in your processes – in real time.
Display Settings
The Reports Block provides one display setting – Display Filters – to control whether the site visitor has access to a filter bar, which allows them to adjust which forms or data points are included in the selected report. Turning this on allows the site visitor to override any defaults you may set in the Filter Settings described below.
Filter Settings
The block can be pre-filtered to show a subset of the workflow data from your website. At a minimum, there are two settings you can set.
| Setting | Description |
|---|---|
| Range | Last 3 Months, Last 6 Months, Last 12 Months |
| Filter Forms | When the default ‘Select a Workflow Form’ setting is chosen, all forms will appear as separate bars in the chart. If you select a specific form, the following additional settings will be available: Category (whether to group the report data by Month, Assignee, or Step), Assignee (the report data will be grouped by assignee down the y-axis of the chart), Month (the report data will be grouped by month down the y-axis of the chart and could then be further filtered by assignee), and Step (when the category of Step is chosen, the report data will be grouped by step name down the y-axis of the report for each active step in the workflow). |
Submit Block
The Submit block displays all published workflow forms by default. Workflow forms can be published on the Workflow > Settings page. The list of published forms can be filtered by using the Filter Forms setting in the block settings.
 |  |