Simple Approval with Save and Continue
A simple, single-step approval process for your Gravity Forms submissions.
Instructions
See “Where do I put snippets?” in our documentation for installation instructions.
Read the Walkthrough
Code
Filename: gw-simple-approval.php
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
<?php
/**
* Gravity Wiz // Gravity Forms // Simple Approval with Save and Continue
* https://gravitywiz.com/simple-submission-approval-gravity-forms/
*
* Make use of Gravity Forms' Save and Continue functionality to send the incomplete form to another user for final
* approval before submission.
*
* Plugin Name: Gravity Forms — Simple Approval with Save and Continue
* Plugin URI: https://gravitywiz.com/simple-submission-approval-gravity-forms/
* Description: A simple, single-step approval process for your Gravity Forms submissions.
* Author: Gravity Wiz
* Version: 1.1
* Author URI: https://gravitywiz.com/
*/
class GW_Simple_Approval {
protected static $is_script_output = false;
private $_args = array();
public function __construct( $args = array() ) {
// set our default arguments, parse against the provided arguments, and store for use throughout the class
$this->_args = wp_parse_args( $args, array(
'form_id' => false,
'approve_button_label' => __( 'Approve' ),
'approval_read_only' => false,
) );
// do version check in the init to make sure if GF is going to be loaded, it is already loaded
add_action( 'init', array( $this, 'init' ) );
}
function init() {
// make sure we're running the required minimum version of Gravity Forms
if ( ! property_exists( 'GFCommon', 'version' ) || ! version_compare( GFCommon::$version, '1.9', '>=' ) ) {
return;
}
// time for hooks
add_filter( 'gform_register_init_scripts', array( $this, 'add_init_script' ) );
add_filter( 'gform_save_and_continue_resume_url', array( $this, 'add_approval_query_arg' ), 10, 4 );
add_filter( 'gform_pre_render', array( $this, 'modify_frontend_form_object_for_approval' ) );
}
function add_init_script( $form ) {
if ( ! $this->is_applicable_form( $form ) ) {
return;
}
$script = '
( function( $ ) {
var $submitButton = $( "#gform_submit_button_" + formId ),
$saveContinueButton = $( "#gform_save_" + formId + "_link" );
if( $saveContinueButton.is( "a" ) ) {
var label = $saveContinueButton.html();
$saveContinueButton.html( "" );
var html = $( "<div />" ).append( $saveContinueButton.clone() ).html();
$saveContinueButton.replaceWith( html.replace( "<a", "<input type=\"submit\" value=\"" + label + "\"" ).replace( "</a>", "" ) );
$saveContinueButton.addClass( "gform_button button" );
}
if( $submitButton.is( ":visible" ) ) {
$saveContinueButton.hide();
} else {
$saveContinueButton.show();
}
} )( jQuery );';
$slug = 'gw_simple_approval';
GFFormDisplay::add_init_script( $this->_args['form_id'], $slug, GFFormDisplay::ON_CONDITIONAL_LOGIC, $script );
}
function is_applicable_form( $form ) {
$form_id = isset( $form['id'] ) ? $form['id'] : $form;
return $form_id == $this->_args['form_id'];
}
function add_approval_query_arg( $resume_url, $form, $token, $email ) {
if ( ! $this->is_applicable_form( $form ) ) {
return $resume_url;
}
// add query arg
$resume_url = add_query_arg( array(
'gf_token' => $token,
'is_approval' => 1,
), $resume_url );
return $resume_url;
}
function modify_frontend_form_object_for_approval( $form ) {
if ( ! $this->is_applicable_form( $form ) ) {
return $form;
}
if ( rgget( 'is_approval' ) ) {
?>
<style type="text/css">
form.gw-approval-mode .hide-in-approval-mode { display: none; }
</style>
<?php
$form['cssClass'] .= 'gw-approval-mode';
$form['save']['enabled'] = false;
$form['button']['text'] = $this->_args['approve_button_label'];
foreach ( $form['fields'] as &$field ) {
if ( $field->inputName == 'is_approval' ) {
$field->defaultValue = 1;
}
if ( $this->_args['approval_read_only'] ) {
$field->gwreadonly_enable = true;
}
}
}
return $form;
}
}
# Configuration
new GW_Simple_Approval( array(
'form_id' => 59,
'approve_button_label' => 'Approve Prayer Request',
'approval_read_only' => true, // requires GP Read Only
) );