Use the frm_after_form_action_logic_row action to add your own settings to each condition in a form action's conditional logic. Your inputs appear at the end of the condition row, before the Remove link.

Each setting is saved with that condition when you save the form's settings.

Requirements

• Formidable Forms Pro 7.0 or later.

Usage

add_action( 'frm_after_form_action_logic_row', 'my_after_form_action_logic_row', 10, 3 );

Parameters

• $names (array): The input names used in this condition row.
  • 'hide_field' (string): The name of the field dropdown, such as 'frm_email_action[12][post_content][conditions][0][hide_field]'.
  • 'hide_field_cond' (string): The name of the comparison dropdown (equals, contains, and so on).
  • 'hide_opt' (string): The name of the value input.
• $condition (array): The saved values for this condition, including 'hide_field', 'hide_field_cond', 'hide_opt', and any settings you add.
• $id (string): The HTML ID of the condition row.

Name your inputs

To save a setting with the condition, give your input the same name as the condition's other inputs, ending in your own key. Start with $names['hide_field'] and remove [hide_field] from the end. Then add [your_key] in its place. After you save, the value comes back in $condition['your_key'].

The action runs for the conditions of every form action type. The start of each name shows the type, such as frm_email_action for an email action. To add your setting to a single action type, check this part of the name.

Examples

add_action( 'frm_after_form_action_logic_row', 'my_condition_note', 10, 3 );
function my_condition_note( $names, $condition, $id ) {
	$suffix = '[hide_field]';

	if ( empty( $names['hide_field'] ) || 0 !== strpos( $names['hide_field'], 'frm_email_action[' ) ) {
		return;
	}

	if ( substr( $names['hide_field'], -strlen( $suffix ) ) !== $suffix ) {
		return;
	}

	$note_name = substr( $names['hide_field'], 0, -strlen( $suffix ) ) . '[my_note]';
	$note      = isset( $condition['my_note'] ) && is_string( $condition['my_note'] ) ? $condition['my_note'] : '';

	printf(
		'<p class="frm12 frm_form_field"><input type="text" name="%1$s" value="%2$s" placeholder="%3$s" /></p>',
		esc_attr( $note_name ),
		esc_attr( $note ),
		esc_attr__( 'Note about this condition', 'my-text-domain' )
	);
}

Limitations

• The action only adds settings to the screen. Your own code decides what each setting does. For example, the frm_action_logic_value hook changes the value a condition checks.
• The action doesn't run for field conditional logic on the form builder. It's only used for form action conditions.

Related developer hook

• Change the value used when a form action condition is checked with the frm_action_logic_value hook.

Related articles

• Using Form Actions
• Add a Form Action