← All changes | classes/models/FrmFormAction.php +120 -47 6.3.2 → 6.13 View file →

		@@ -4,19 +4,71 @@
4	4	}
5	5
6	6	class FrmFormAction {
7	7
8		- public $id_base; // Root id for all actions of this type.
9		- public $name; // Name for this action type.
	8	+ /**
	9	+ * Root id for all actions of this type.
	10	+ *
	11	+ * @var string
	12	+ */
	13	+ public $id_base;
	14	+
	15	+ /**
	16	+ * Name for this action type.
	17	+ *
	18	+ * @var string
	19	+ */
	20	+ public $name;
	21	+
	22	+ /**
	23	+ * Name of the option used to store the settings for this action type.
	24	+ *
	25	+ * @var string
	26	+ */
10	27	public $option_name;
11		- public $action_options; // Option array passed to wp_register_sidebar_widget()
12		- public $control_options; // Option array passed to wp_register_widget_control()
13	28
14		- public $form_id; // The ID of the form to evaluate
15		- public $number = false; // Unique ID number of the current instance.
16		- public $id = ''; // Unique ID string of the current instance (id_base-number)
17		- public $updated = false; // Set true when we update the data after a POST submit - makes sure we don't do it twice.
	29	+ /**
	30	+ * Option array passed to wp_register_sidebar_widget().
	31	+ *
	32	+ * @var array
	33	+ */
	34	+ public $action_options;
18	35
	36	+ /**
	37	+ * Option array passed to wp_register_widget_control().
	38	+ *
	39	+ * @var array
	40	+ */
	41	+ public $control_options;
	42	+
	43	+ /**
	44	+ * The ID of the form to evaluate.
	45	+ *
	46	+ * @var int
	47	+ */
	48	+ public $form_id;
	49	+
	50	+ /**
	51	+ * Unique ID number of the current instance.
	52	+ *
	53	+ * @var int
	54	+ */
	55	+ public $number = false;
	56	+
	57	+ /**
	58	+ * Unique ID string of the current instance (id_base-number).
	59	+ *
	60	+ * @var string
	61	+ */
	62	+ public $id = '';
	63	+
	64	+ /**
	65	+ * Set true when we update the data after a POST submit - makes sure we don't do it twice.
	66	+ *
	67	+ * @var bool
	68	+ */
	69	+ public $updated = false;
	70	+
19	71	// Member functions that you must over-ride.
20	72
21	73	/**
22	74	* This function should check that $new_instance is set correctly.
		@@ -22,10 +74,10 @@
22	74	* This function should check that $new_instance is set correctly.
23	75	* The newly calculated value of $instance should be returned.
24	76	* If "false" is returned, the instance won't be saved/updated.
25	77	*
26		- * @param array $new_instance New settings for this instance as input by the user via form()
27		- * @param array $old_instance Old settings for this instance
	78	+ * @param array $new_instance New settings for this instance as input by the user via form().
	79	+ * @param array $old_instance Old settings for this instance.
28	80	*
29	81	* @return array Settings to save or bool false to cancel saving
30	82	*/
31	83	public function update( $new_instance, $old_instance ) {
		@@ -34,9 +86,10 @@
34	86
35	87	/**
36	88	* Echo the settings update form
37	89	*
38		- * @param array $instance Current settings
	90	+ * @param WP_Post $instance Current settings.
	91	+ * @param array $args
39	92	*/
40	93	public function form( $instance, $args = array() ) {
41	94	echo '<p class="no-options-widget">' . esc_html__( 'There are no options for this action.', 'formidable' ) . '</p>';
42	95
		@@ -68,14 +121,14 @@
68	121	*
69	122	* @param string $id_base Optional Base ID for the widget, lower case,
70	123	* if left empty a portion of the widget's class name will be used. Has to be unique.
71	124	* @param string $name Name for the widget displayed on the configuration page.
72		- * @param array $action_options Optional Passed to wp_register_sidebar_widget()
73		- * - description: shown on the configuration page
74		- * - classname
75		- * @param array $control_options Optional Passed to wp_register_widget_control()
76		- * - width: required if more than 250px
77		- * - height: currently not used but may be needed in the future
	125	+ * @param array $action_options Optional Passed to wp_register_sidebar_widget().
	126	+ * - description: shown on the configuration page.
	127	+ * - classname.
	128	+ * @param array $control_options Optional Passed to wp_register_widget_control().
	129	+ * - width: required if more than 250px.
	130	+ * - height: currently not used but may be needed in the future.
78	131	*/
79	132	public function __construct( $id_base, $name, $action_options = array(), $control_options = array() ) {
80	133	if ( ! defined( 'ABSPATH' ) ) {
81	134	die( 'You are not allowed to call this page directly.' );
		@@ -111,11 +164,11 @@
111	164	}
112	165
113	166	$upgrade_class = isset( $action_options['classes'] ) && $action_options['classes'] === 'frm_show_upgrade';
114	167	if ( $action_options['group'] === $id_base ) {
115		- $upgrade_class = strpos( $action_options['classes'], 'frm_show_upgrade' ) !== false;
	168	+ $upgrade_class = strpos( $action_options['classes'], 'frm_show_upgrade' ) !== false;
116	169	$action_options['classes'] = $group['icon'];
117		- } elseif ( ! isset( $action_options['classes'] ) || empty( $action_options['classes'] ) || $upgrade_class ) {
	170	+ } elseif ( empty( $action_options['classes'] ) || $upgrade_class ) {
118	171	$action_options['classes'] = $group['icon'];
119	172	}
120	173
121	174	if ( $upgrade_class ) {
		@@ -135,9 +188,9 @@
135	188
136	189	/**
137	190	* Help to switch old field id by new field id for duplicate form
138	191	*
139		- * @param string $action id of the field that needs to be switched
	192	+ * @param string $action id of the field that needs to be switched.
140	193	*
141	194	* @return string
142	195	*/
143	196	public function maybe_switch_field_ids( $action ) {
		@@ -176,14 +229,14 @@
176	229	* Constructs name attributes for use in form() fields
177	230	*
178	231	* This function should be used in form() methods to create name attributes for fields to be saved by update()
179	232	*
180		- * @param string $field_name Field name
	233	+ * @param string $field_name Field name.
181	234	*
182	235	* @return string Name attribute for $field_name
183	236	*/
184	237	public function get_field_name( $field_name, $post_field = 'post_content' ) {
185		- $name = $this->option_name . '[' . $this->number . ']';
	238	+ $name = $this->option_name . '[' . $this->number . ']';
186	239	$name .= ( empty( $post_field ) ? '' : '[' . $post_field . ']' );
187	240	$name .= '[' . $field_name . ']';
188	241
189	242	return $name;
		@@ -193,9 +246,9 @@
193	246	* Constructs id attributes for use in form() fields
194	247	*
195	248	* This function should be used in form() methods to create id attributes for fields to be saved by update()
196	249	*
197		- * @param string $field_name Field name
	250	+ * @param string $field_name Field name.
198	251	*
199	252	* @return string ID attribute for $field_name
200	253	*/
201	254	public function get_field_id( $field_name ) {
		@@ -270,17 +323,18 @@
270	323	unset( $action );
271	324	}
272	325	}
273	326
274		- /* Check if imported action should be created or updated
	327	+ /**
	328	+ * Check if imported action should be created or updated.
275	329	*
276	330	* @since 2.0
277	331	*
278	332	* @param array $action
279		- * @return integer $post_id
	333	+ * @return int $post_id
280	334	*/
281	335	public function maybe_create_action( $action, $forms ) {
282		- if ( isset( $action['ID'] ) && is_numeric( $action['ID'] ) && isset( $forms[ $action['menu_order'] ] ) && $forms[ $action['menu_order'] ] == 'updated' ) {
	336	+ if ( isset( $action['ID'] ) && is_numeric( $action['ID'] ) && isset( $forms[ $action['menu_order'] ] ) && $forms[ $action['menu_order'] ] === 'updated' ) {
283	337	// Update action only
284	338	$action['post_content'] = FrmAppHelper::maybe_json_decode( $action['post_content'] );
285	339	$post_id = $this->save_settings( $action );
286	340	} else {
		@@ -346,9 +400,9 @@
346	400	} elseif ( $ck == $subkey ) {
347	401	$action[ $ck ] = $this->maybe_switch_field_ids( $action[ $ck ] );
348	402	}
349	403	}
350		- }
	404	+ }//end if
351	405
352	406	return $action;
353	407	}
354	408
		@@ -398,9 +452,9 @@
398	452	$new_instance['post_type'] = FrmFormActionsController::$action_post_type;
399	453	$new_instance['post_name'] = $this->form_id . '_' . $this->id_base . '_' . $this->number;
400	454	$new_instance['menu_order'] = $this->form_id;
401	455	$new_instance['post_date'] = isset( $old_instance->post_date ) ? $old_instance->post_date : '';
402		- $instance = $this->update( $new_instance, $old_instance );
	456	+ $instance = $this->update( $new_instance, $old_instance );
403	457
404	458	/**
405	459	* Filter an action's settings before saving.
406	460	*
		@@ -411,9 +465,8 @@
411	465	*
412	466	* @param array $instance The current widget instance's settings.
413	467	* @param array $new_instance Array of new widget settings.
414	468	* @param array $old_instance Array of old widget settings.
415		- * @param WP_Widget $this The current widget instance.
416	469	*/
417	470	$instance = apply_filters( 'frm_action_update_callback', $instance, $new_instance, $old_instance, $this );
418	471
419	472	$instance['post_content'] = apply_filters( 'frm_before_save_action', $instance['post_content'], $instance, $new_instance, $old_instance, $this );
		@@ -425,9 +478,9 @@
425	478
426	479	$action_ids[] = $this->save_settings( $instance );
427	480
428	481	$this->updated = true;
429		- }
	482	+ }//end foreach
430	483
431	484	return $action_ids;
432	485	}
433	486
		@@ -436,9 +489,9 @@
436	489	*
437	490	* @since 3.04
438	491	*
439	492	* @param array $new_instance
440		- * @param stdClass|array $old_instance
	493	+ * @param array|stdClass $old_instance
441	494	* @return void
442	495	*/
443	496	protected function maybe_update_status( $new_instance, $old_instance ) {
444	497	if ( ! is_object( $old_instance ) || $new_instance['post_status'] === $old_instance->post_status ) {
		@@ -453,8 +506,12 @@
453	506	)
454	507	);
455	508	}
456	509
	510	+ /**
	511	+ * @param array $settings
	512	+ * @return int|WP_Error
	513	+ */
457	514	public function save_settings( $settings ) {
458	515	self::clear_cache();
459	516
460	517	return FrmDb::save_settings( $settings, 'frm_actions' );
		@@ -584,10 +641,10 @@
584	641	global $frm_vars;
585	642	$frm_vars['action_type'] = $type;
586	643
587	644	add_filter( 'posts_where', 'FrmFormActionsController::limit_by_type' );
588		- $query = self::action_args( $form_id, $limit );
589		- $query['post_status'] = $atts['post_status'];
	645	+ $query = self::action_args( $form_id, $limit );
	646	+ $query['post_status'] = $atts['post_status'];
590	647	$query['suppress_filters'] = false;
591	648
592	649	$actions = FrmDb::check_cache( json_encode( $query ) . '_type_' . $type, 'frm_actions', $query, 'get_posts' );
593	650	unset( $query );
		@@ -635,9 +692,9 @@
635	692	return $args;
636	693	}
637	694
638	695	/**
639		- * @param WP_Post|array $action
	696	+ * @param array|WP_Post $action
640	697	*/
641	698	public function prepare_action( $action ) {
642	699	$action->post_content = (array) FrmAppHelper::maybe_json_decode( $action->post_content );
643	700	$action->post_excerpt = sanitize_title( $action->post_excerpt );
		@@ -648,9 +705,9 @@
648	705	$action->post_content += $default_values;
649	706
650	707	foreach ( $default_values as $k => $vals ) {
651	708	if ( is_array( $vals ) && ! empty( $vals ) ) {
652		- if ( 'event' == $k && ! $this->action_options['force_event'] && ! empty( $action->post_content[ $k ] ) ) {
	709	+ if ( 'event' === $k && ! $this->action_options['force_event'] && ! empty( $action->post_content[ $k ] ) ) {
653	710	continue;
654	711	}
655	712	$action->post_content[ $k ] = wp_parse_args( $action->post_content[ $k ], $vals );
656	713	}
		@@ -734,9 +791,9 @@
734	791	/**
735	792	* Migrate settings from form->options into new action.
736	793	*/
737	794	public function migrate_to_2( $form, $update = 'update' ) {
738		- $action = $this->prepare_new( $form->id );
	795	+ $action = $this->prepare_new( $form->id );
739	796	FrmAppHelper::unserialize_or_decode( $form->options );
740	797
741	798	// fill with existing options
742	799	foreach ( $action->post_content as $name => $val ) {
		@@ -784,9 +841,9 @@
784	841	$notification = $action->post_content;
785	842	$stop = false;
786	843	$met = array();
787	844
788		- if ( ! isset( $notification['conditions'] ) || empty( $notification['conditions'] ) ) {
	845	+ if ( empty( $notification['conditions'] ) ) {
789	846	return $stop;
790	847	}
791	848
792	849	foreach ( $notification['conditions'] as $k => $condition ) {
		@@ -803,18 +860,18 @@
803	860	$observed_value = self::get_value_from_entry( $entry, $condition['hide_field'] );
804	861
805	862	$stop = FrmFieldsHelper::value_meets_condition( $observed_value, $condition['hide_field_cond'], $condition['hide_opt'] );
806	863
807		- if ( $notification['conditions']['send_stop'] == 'send' ) {
	864	+ if ( $notification['conditions']['send_stop'] === 'send' ) {
808	865	$stop = $stop ? false : true;
809	866	}
810	867
811	868	$met[ $stop ] = $stop;
812		- }
	869	+ }//end foreach
813	870
814		- if ( $notification['conditions']['any_all'] == 'all' && ! empty( $met ) && isset( $met[0] ) && isset( $met[1] ) ) {
815		- $stop = ( $notification['conditions']['send_stop'] == 'send' );
816		- } elseif ( $notification['conditions']['any_all'] == 'any' && $notification['conditions']['send_stop'] == 'send' && isset( $met[0] ) ) {
	871	+ if ( $notification['conditions']['any_all'] === 'all' && ! empty( $met ) && isset( $met[0] ) && isset( $met[1] ) ) {
	872	+ $stop = ( $notification['conditions']['send_stop'] === 'send' );
	873	+ } elseif ( $notification['conditions']['any_all'] === 'any' && $notification['conditions']['send_stop'] === 'send' && isset( $met[0] ) ) {
817	874	$stop = false;
818	875	}
819	876
820	877	return $stop;
		@@ -824,10 +881,8 @@
824	881	* Prepare the logic value for comparison against the entered value
825	882	*
826	883	* @since 2.01.02
827	884	*
828		- * @deprecated 4.06.02
829		- *
830	885	* @param array|string $logic_value
831	886	*
832	887	* @return void
833	888	*/
		@@ -835,9 +890,9 @@
835	890	if ( is_array( $logic_value ) ) {
836	891	$logic_value = reset( $logic_value );
837	892	}
838	893
839		- if ( $logic_value == 'current_user' ) {
	894	+ if ( $logic_value === 'current_user' ) {
840	895	$logic_value = get_current_user_id();
841	896	}
842	897
843	898	$logic_value = apply_filters( 'frm_content', $logic_value, $action->menu_order, $entry );
		@@ -851,12 +906,11 @@
851	906	/**
852	907	* Get the value from a specific field and entry
853	908	*
854	909	* @since 2.01.02
855		- * @deprecated 4.06.02
856	910	*
857	911	* @param object $entry
858		- * @param int $field_id
	912	+ * @param int $field_id
859	913	*
860	914	* @return array|bool|mixed|string
861	915	*/
862	916	private static function get_value_from_entry( $entry, $field_id ) {
		@@ -921,6 +975,25 @@
921	975	* @return string
922	976	*/
923	977	protected function get_upgrade_text() {
924	978	return __( 'Conditional form actions', 'formidable' );
	979	+ }
	980	+
	981	+ /**
	982	+ * Gets form fields for form action settings.
	983	+ *
	984	+ * @since 6.10
	985	+ *
	986	+ * @param int $form_id Form ID.
	987	+ * @return object[]
	988	+ */
	989	+ protected function get_form_fields( $form_id ) {
	990	+ // Get form fields, include embedded and repeater child fields.
	991	+ $form_fields = FrmField::get_all_for_form( $form_id, '', 'include' );
	992	+ return array_filter(
	993	+ $form_fields,
	994	+ function ( $form_field ) {
	995	+ return ! FrmField::is_no_save_field( $form_field->type );
	996	+ }
	997	+ );
925	998	}
926	999	}