gravityflow_approval_revert_step_id
The gravityflow_approval_revert_step_id filter allows customization of what step an approval workflow will be routed to when the user clicks Revert. See Configuring an approval process for more details on setup.
Parameters
Parameter | Type | Definition |
---|---|---|
$revert_step_id | string | The current entry array. |
$entry | Array | The current entry array. |
$form | Array | The form of current entry. |
$step | Gravity_Flow_Step | The current step. |
Examples
Example 1 - Revert to a different step
This will override the step defined in step settings, enabling you to route a revert selection to more than just a user input step type.
add_filter( 'gravityflow_approval_revert_step_id', 'sh_gravityflow_step_revert_control', 10, 4 ); function sh_gravityflow_step_revert_control( $revert_id, $entry, $form, $step ) { if ( $step->get_id() == '138' ) { $revert_id = '122'; } return $revert_id; }
Example 2 - Approval Revert triggering entry field updates
If you have configured an approval process with a revert to user input setting, but want to modify some of the entry data before the workflow arrives at the selected user input step.
add_action( 'gravityflow_approval_revert_step_id', 'sh_gravityflow_step_revert_control', 10, 4 ); function sh_gravityflow_step_revert_control( $revert_id, $entry, $form, $step ) { //Update with your step ID if ( $step->get_id == '138' ) { //The name for revert button includes the step ID in it as well if( isset( $_POST['gravityflow_approval_new_status_step_138'] ) && $_POST['gravityflow_approval_new_status_step_138'] == 'revert' ) { //Change to match your field ID and data value GFAPI::update_entry_field( $entry_id, 1, 'Now' ); } } }
Placement
This code should be placed in the functions.php file of your active theme or in a custom functions plugin.