← All changes | classes/models/FrmForm.php +19 -172 6.3 → 5.0.14 View file →

		@@ -6,9 +6,9 @@
6	6	class FrmForm {
7	7
8	8	/**
9	9	* @param array $values
10		- * @return int|bool id on success or false on failure.
	10	+ * @return int|boolean id on success or false on failure
11	11	*/
12	12	public static function create( $values ) {
13	13	global $wpdb;
14	14
		@@ -32,18 +32,9 @@
32	32	$options['before_html'] = isset( $values['options']['before_html'] ) ? $values['options']['before_html'] : FrmFormsHelper::get_default_html( 'before' );
33	33	$options['after_html'] = isset( $values['options']['after_html'] ) ? $values['options']['after_html'] : FrmFormsHelper::get_default_html( 'after' );
34	34	$options['submit_html'] = isset( $values['options']['submit_html'] ) ? $values['options']['submit_html'] : FrmFormsHelper::get_default_html( 'submit' );
35	35
36		- /**
37		- * Allows modifying form options before updating or creating.
38		- *
39		- * @since 5.4 Add the third param.
40		- *
41		- * @param array $options Form options.
42		- * @param array $values Form data.
43		- * @param bool $update Is form updating or creating. It's `true` if is updating.
44		- */
45		- $options = apply_filters( 'frm_form_options_before_update', $options, $values, false );
	36	+ $options = apply_filters( 'frm_form_options_before_update', $options, $values );
46	37	$options = self::maybe_filter_form_options( $options );
47	38	$new_values['options'] = serialize( $options );
48	39
49	40	$wpdb->insert( $wpdb->prefix . 'frm_forms', $new_values );
		@@ -140,86 +131,11 @@
140	131	if ( $new_opts != $values['options'] ) {
141	132	global $wpdb;
142	133	$wpdb->update( $wpdb->prefix . 'frm_forms', array( 'options' => maybe_serialize( $new_opts ) ), array( 'id' => $form_id ) );
143	134	}
144		-
145		- self::switch_field_ids_in_fields( $form_id );
146	135	}
147	136
148	137	/**
149		- * Switches field ID in fields.
150		- *
151		- * @since 5.3
152		- *
153		- * @param int $form_id Form ID.
154		- */
155		- private static function switch_field_ids_in_fields( $form_id ) {
156		- global $wpdb;
157		-
158		- // Keys of fields that you want to check to replace field ID.
159		- $keys = array( 'default_value', 'field_options' );
160		- $sql_cols = 'fi.id';
161		- foreach ( $keys as $key ) {
162		- $sql_cols .= ( ',fi.' . $key );
163		- }
164		-
165		- $fields = FrmDb::get_results(
166		- "{$wpdb->prefix}frm_fields AS fi LEFT OUTER JOIN {$wpdb->prefix}frm_forms AS fr ON fi.form_id = fr.id",
167		- array(
168		- 'or' => 1,
169		- 'fi.form_id' => $form_id,
170		- 'fr.parent_form_id' => $form_id,
171		- ),
172		- $sql_cols
173		- );
174		-
175		- if ( ! $fields || ! is_array( $fields ) ) {
176		- return;
177		- }
178		-
179		- foreach ( $fields as $field ) {
180		- self::switch_field_ids_in_field( (array) $field );
181		- }
182		- }
183		-
184		- /**
185		- * Switches field ID in a field.
186		- *
187		- * @since 5.3
188		- *
189		- * @param array $field Field array.
190		- */
191		- private static function switch_field_ids_in_field( $field ) {
192		- $new_values = array();
193		- foreach ( $field as $key => $value ) {
194		- if ( 'id' === $key || ! $value ) {
195		- continue;
196		- }
197		-
198		- if ( ! is_string( $value ) && ! is_array( $value ) ) {
199		- continue;
200		- }
201		-
202		- if ( 'field_options' === $key ) {
203		- // Need to loop through field_options to prevent breaking serialized string when length changed.
204		- FrmAppHelper::unserialize_or_decode( $value );
205		- $new_val = FrmFieldsHelper::switch_field_ids( $value );
206		- $new_val = serialize( $new_val );
207		- } else {
208		- $new_val = FrmFieldsHelper::switch_field_ids( $value );
209		- }
210		-
211		- if ( $new_val !== $value ) {
212		- $new_values[ $key ] = $new_val;
213		- }
214		- }
215		-
216		- if ( ! empty( $new_values ) ) {
217		- FrmField::update( $field['id'], $new_values );
218		- }
219		- }
220		-
221		- /**
222	138	* @return int|boolean
223	139	*/
224	140	public static function update( $id, $values, $create_link = false ) {
225	141	global $wpdb;
		@@ -235,9 +151,9 @@
235	151	}
236	152
237	153	$form_fields = array( 'form_key', 'name', 'description', 'status', 'parent_form_id' );
238	154
239		- $new_values = self::set_update_options( array(), $values, array( 'form_id' => $id ) );
	155	+ $new_values = self::set_update_options( array(), $values );
240	156
241	157	foreach ( $values as $value_key => $value ) {
242	158	if ( $value_key && in_array( $value_key, $form_fields ) ) {
243	159	$new_values[ $value_key ] = $value;
		@@ -266,14 +182,11 @@
266	182	return $query_results;
267	183	}
268	184
269	185	/**
270		- * @param array $new_values
271		- * @param array $values
272		- * @param array $args
273	186	* @return array
274	187	*/
275		- public static function set_update_options( $new_values, $values, $args = array() ) {
	188	+ public static function set_update_options( $new_values, $values ) {
276	189	if ( ! isset( $values['options'] ) ) {
277	190	return $new_values;
278	191	}
279	192
		@@ -284,18 +197,9 @@
284	197	$options['before_html'] = isset( $values['options']['before_html'] ) ? $values['options']['before_html'] : FrmFormsHelper::get_default_html( 'before' );
285	198	$options['after_html'] = isset( $values['options']['after_html'] ) ? $values['options']['after_html'] : FrmFormsHelper::get_default_html( 'after' );
286	199	$options['submit_html'] = ( isset( $values['options']['submit_html'] ) && '' !== $values['options']['submit_html'] ) ? $values['options']['submit_html'] : FrmFormsHelper::get_default_html( 'submit' );
287	200
288		- /**
289		- * Allows modifying form options before updating or creating.
290		- *
291		- * @since 5.4 Added the third param.
292		- *
293		- * @param array $options Form options.
294		- * @param array $values Form data.
295		- * @param bool $update Is form updating or creating. It's `true` if is updating.
296		- */
297		- $options = apply_filters( 'frm_form_options_before_update', $options, $values, true );
	201	+ $options = apply_filters( 'frm_form_options_before_update', $options, $values );
298	202	$options = self::maybe_filter_form_options( $options );
299	203	$new_values['options'] = serialize( $options );
300	204
301	205	return $new_values;
		@@ -365,18 +269,8 @@
365	269	'field_options' => $field->field_options,
366	270	'default_value' => isset( $values[ 'default_value_' . $field_id ] ) ? FrmAppHelper::maybe_json_encode( $values[ 'default_value_' . $field_id ] ) : '',
367	271	);
368	272
369		- if ( ! FrmAppHelper::allow_unfiltered_html() && isset( $values['field_options'][ 'options_' . $field_id ] ) && is_array( $values['field_options'][ 'options_' . $field_id ] ) ) {
370		- foreach ( $values['field_options'][ 'options_' . $field_id ] as $option_key => $option ) {
371		- if ( is_array( $option ) ) {
372		- foreach ( $option as $key => $item ) {
373		- $values['field_options'][ 'options_' . $field_id ][ $option_key ][ $key ] = FrmAppHelper::kses( $item, 'all' );
374		- }
375		- }
376		- }
377		- }
378		-
379	273	self::prepare_field_update_values( $field, $values, $new_field );
380	274
381	275	FrmField::update( $field_id, $new_field );
382	276
		@@ -386,40 +280,17 @@
386	280
387	281	return $values;
388	282	}
389	283
390		- /**
391		- * @param string $opt
392		- * @param mixed $value
393		- * @return void
394		- */
395	284	private static function sanitize_field_opt( $opt, &$value ) {
396		- if ( ! is_string( $value ) ) {
397		- return;
	285	+ if ( is_string( $value ) ) {
	286	+ if ( $opt === 'calc' ) {
	287	+ $value = self::sanitize_calc( $value );
	288	+ } else {
	289	+ $value = FrmAppHelper::kses( $value, 'all' );
	290	+ }
	291	+ $value = trim( $value );
398	292	}
399		-
400		- /**
401		- * Allow the option to turn off sanitization for a field. This way a custom rule can be used instead.
402		- * Make sure to add custom sanitization using the frm_update_field_options filter as the data will no longer be sanitized.
403		- *
404		- * @since 6.0
405		- *
406		- * @param bool $should_sanitize
407		- * @param string $opt
408		- */
409		- $should_sanitize = apply_filters( 'frm_should_sanitize_field_opt_string', true, $opt );
410		-
411		- if ( ! $should_sanitize ) {
412		- return;
413		- }
414		-
415		- if ( $opt === 'calc' ) {
416		- $value = self::sanitize_calc( $value );
417		- } else {
418		- $value = FrmAppHelper::kses( $value, 'all' );
419		- }
420		-
421		- $value = trim( $value );
422	293	}
423	294
424	295	/**
425	296	* @param string $value
		@@ -510,12 +381,8 @@
510	381	'description',
511	382	'submit_value',
512	383	'submit_msg',
513	384	'success_msg',
514		- 'invalid_msg',
515		- 'failed_msg',
516		- 'login_msg',
517		- 'admin_permission',
518	385	);
519	386
520	387	return apply_filters( 'frm_form_strings', $strings, $form );
521	388	}
		@@ -754,9 +621,9 @@
754	621	if ( isset( $cache->options ) ) {
755	622	FrmAppHelper::unserialize_or_decode( $cache->options );
756	623	}
757	624
758		- return apply_filters( 'frm_form_object', wp_unslash( $cache ) );
	625	+ return wp_unslash( $cache );
759	626	}
760	627	}
761	628
762	629	if ( is_numeric( $id ) ) {
		@@ -812,13 +679,9 @@
812	679	/**
813	680	* Get all published forms
814	681	*
815	682	* @since 2.0
816		- *
817		- * @param array $query
818		- * @param int $limit
819		- * @param string $inc_children
820		- * @return array|object of forms A single form object would be passed if $limit was set to 1.
	683	+ * @return array of forms
821	684	*/
822	685	public static function get_published_forms( $query = array(), $limit = 999, $inc_children = 'exclude' ) {
823	686	$query['is_template'] = 0;
824	687	$query['status'] = array( null, '', 'published' );
		@@ -1118,39 +981,23 @@
1118	981	return admin_url( 'admin.php?page=formidable&frm_action=edit&id=' . $form_id );
1119	982	}
1120	983
1121	984	/**
1122		- * Check if the "Submit this form with AJAX" setting is toggled on.
1123		- *
1124		- * @since 6.2
1125		- *
1126		- * @param stdClass $form
1127		- * @return bool
1128		- */
1129		- public static function is_ajax_on( $form ) {
1130		- return ! empty( $form->options['ajax_submit'] );
1131		- }
1132		-
1133		- /**
1134		- * @deprecated 2.03.05 This is still referenced in a few add ons (API, locations).
	985	+ * @deprecated 3.0
1135	986	* @codeCoverageIgnore
1136	987	*
1137	988	* @param string $key
	989	+ *
1138	990	* @return int form id
1139	991	*/
1140	992	public static function getIdByKey( $key ) {
1141		- _deprecated_function( __FUNCTION__, '2.03.05', 'FrmForm::get_id_by_key' );
1142		- return self::get_id_by_key( $key );
	993	+ return FrmFormDeprecated::getIdByKey( $key );
1143	994	}
1144	995
1145	996	/**
1146		- * @deprecated 2.03.05 This is still referenced in the API add on as of v1.13.
	997	+ * @deprecated 3.0
1147	998	* @codeCoverageIgnore
1148		- *
1149		- * @param string|int $id
1150		- * @return string
1151	999	*/
1152	1000	public static function getKeyById( $id ) {
1153		- _deprecated_function( __FUNCTION__, '2.03.05', 'FrmForm::get_key_by_id' );
1154		- return self::get_key_by_id( $id );
	1001	+ return FrmFormDeprecated::getKeyById( $id );
1155	1002	}
1156	1003	}