Description
Use this action hook to perform logic when entries' basic information is updated.
Usage
<?php
add_action("gform_update_status", "status_changed", 10, 3);
?>
Parameters
- $entry_id
- (int) Current entry ID
- $property_value
- (mixed) New value of the entry's property
- $previous_value
- (mixed) Previous value of the entry's property
Examples
This example automatically deletes entries that are marked as Spam
<?php
add_filter("gform_update_status", "delete_spam", 10, 3);
function delete_spam($entry_id, $property_value, $previous_value){
if($property_value == "spam"){
RGFormsModel::delete_lead($entry_id);
}
}
?>
This example sends an email to the admin whenever an entry's status changes.
add_action("gform_update_status", "check_lead_status", 10, 3);
function check_lead_status($entry_id, $property_value, $previous_value){
if ($previous_value != $property_value)
{
$to = get_bloginfo("admin_email");
$subject = "The status of entry {$entry_id} has changed.";
$message = "The status of entry {$entry_id} has changed. Please review this entry.";
wp_mail($to, $subject, $message);
}
}
This example sends an email to the admin whenever an entry is starred.
add_action("gform_update_is_starred", "check_starred_status", 10, 3);
function check_starred_status($entry_id, $property_value, $previous_value){
if ($previous_value != $property_value && $property_value == 1)
{
$to = get_bloginfo("admin_email");
$subject = "Entry {$entry_id} has been starred as important.";
$message = "Entry {$entry_id} has been starred as important. Please review this entry.";
wp_mail($to, $subject, $message);
}
}
Placement
This code should be placed in the functions.php file of your active theme.
Source Code
This filter is located in forms_model.php