Use the frm_after_entry_meta_change action to run code right after Formidable adds, updates, or deletes a single field value of an entry. When it runs, the change is already saved in the database.

Use it to keep your own data in sync with entry values, such as a cached total or a copy of a value in another system. When a write fails, Formidable runs frm_entry_meta_write_failed instead.

Requirements

• Formidable Forms 7.0 or later. The hook is part of Formidable Forms Lite.

When it fires

The action runs once per field value, after each of these writes:

• Add: a field value is saved for the first time, such as when a new entry is submitted.
• Update: an existing field value is saved again, such as when an entry is edited. It runs even when the value didn't change. Editing an entry fires it for every field that has a value.
• Delete: a single field value is removed, including a value that was cleared when an entry was edited.

Formidable Forms Pro uses this hook to refresh its own index of entry values.

Usage

add_action( 'frm_after_entry_meta_change', 'my_function_name', 10, 2 );

Parameters

• $entry_id (int): The ID of the entry the value belongs to.
• $field_id (int): The ID of the field whose value changed.

Examples

add_action( 'frm_after_entry_meta_change', 'my_frm_clear_cached_total', 10, 2 );
function my_frm_clear_cached_total( $entry_id, $field_id ) {
	$watched_fields = array( 25, 26 ); // Change 25 and 26 to the IDs of your fields.
	if ( in_array( (int) $field_id, $watched_fields, true ) ) {
		delete_transient( 'my_frm_order_total' );
	}
}

To compare the old and new value of a field, pair this hook with frm_before_entry_meta_change. That hook's page has a full example.

Limitations

• The hook runs only for values saved through Formidable's entry value functions. Deleting a whole entry, a field, or all entries of a form removes the values without firing it.
• For values removed when an entry is edited, the hook runs after the delete query even if the query fails.

Related developer hooks

• Run code right before a field value changes with the frm_before_entry_meta_change hook.
• Handle a field value that couldn't be saved with the frm_entry_meta_write_failed hook.
• Run code once after a whole entry is updated with the frm_after_update_entry hook.

Related articles

• How to Use Formidable Hooks
• Manage Entries from the Back-End