PluginProbe
Formidable Forms – WordPress Form Builder for Contact Forms, Calculators, Quizzes & More / 5.1
Formidable Forms – WordPress Form Builder for Contact Forms, Calculators, Quizzes & More v5.1
6.35 6.34 6.33.1 6.33 6.32.1 6.32 6.31 6.25 6.25.1 6.26 6.26.1 6.27 6.28 6.29 6.3 6.3.1 6.3.2 6.30 6.4 6.4.1 6.4.2 6.5 6.5.1 6.5.2 6.5.3 All 141 releases
← All changes | classes/models/FrmField.php +163 -510 6.255.1 View file →
@@ -4,259 +4,210 @@
4 4 }
5 5
6 6 class FrmField {
7 7
8 - public static $use_cache = true;
8 + public static $use_cache = true;
9 9 public static $transient_size = 200;
10 10
11 11 public static function field_selection() {
12 12 $fields = array(
13 - 'text' => array(
13 + 'text' => array(
14 14 'name' => __( 'Text', 'formidable' ),
15 15 'icon' => 'frm_icon_font frm_text2_icon',
16 16 ),
17 - 'textarea' => array(
17 + 'textarea' => array(
18 18 'name' => __( 'Paragraph', 'formidable' ),
19 19 'icon' => 'frm_icon_font frm_paragraph_icon',
20 20 ),
21 - 'checkbox' => array(
21 + 'checkbox' => array(
22 22 'name' => __( 'Checkboxes', 'formidable' ),
23 23 'icon' => 'frm_icon_font frm_check_square_icon',
24 24 ),
25 - 'radio' => array(
25 + 'radio' => array(
26 26 'name' => __( 'Radio Buttons', 'formidable' ),
27 27 'icon' => 'frm_icon_font frm_radio_checked_icon',
28 28 ),
29 - 'select' => array(
29 + 'select' => array(
30 30 'name' => __( 'Dropdown', 'formidable' ),
31 - 'icon' => 'frm_icon_font frm_dropdown_icon',
31 + 'icon' => 'frm_icon_font frm_caret_square_down_icon',
32 32 ),
33 - 'email' => array(
33 + 'email' => array(
34 34 'name' => __( 'Email', 'formidable' ),
35 - 'icon' => 'frm_icon_font frm_email2_icon',
35 + 'icon' => 'frm_icon_font frm_email_icon',
36 36 ),
37 - 'url' => array(
37 + 'url' => array(
38 38 'name' => __( 'Website/URL', 'formidable' ),
39 - 'icon' => 'frm_icon_font frm_link2_icon',
39 + 'icon' => 'frm_icon_font frm_link_icon',
40 40 ),
41 - 'number' => array(
41 + 'number' => array(
42 42 'name' => __( 'Number', 'formidable' ),
43 43 'icon' => 'frm_icon_font frm_hashtag_icon',
44 44 ),
45 - 'name' => array(
45 + 'name' => array(
46 46 'name' => __( 'Name', 'formidable' ),
47 47 'icon' => 'frm_icon_font frm_user_name_icon',
48 48 ),
49 - 'phone' => array(
49 + 'phone' => array(
50 50 'name' => __( 'Phone', 'formidable' ),
51 51 'icon' => 'frm_icon_font frm_phone_icon',
52 52 ),
53 - 'html' => array(
53 + 'html' => array(
54 54 'name' => __( 'HTML', 'formidable' ),
55 - 'icon' => 'frm_icon_font frm_code2_icon',
55 + 'icon' => 'frm_icon_font frm_code_icon',
56 56 ),
57 - 'hidden' => array(
57 + 'hidden' => array(
58 58 'name' => __( 'Hidden', 'formidable' ),
59 - 'icon' => 'frm_icon_font frm_eye_slash2_icon',
59 + 'icon' => 'frm_icon_font frm_eye_slash_icon',
60 60 ),
61 - 'user_id' => array(
61 + 'user_id' => array(
62 62 'name' => __( 'User ID', 'formidable' ),
63 - 'icon' => 'frm_icon_font frm_user2_icon',
63 + 'icon' => 'frm_icon_font frm_user_icon',
64 64 ),
65 - 'captcha' => array(
66 - 'name' => self::get_captcha_field_name(),
67 - 'icon' => 'frm_icon_font frm_shield_check2_icon',
65 + 'captcha' => array(
66 + 'name' => __( 'reCAPTCHA', 'formidable' ),
67 + 'icon' => 'frm_icon_font frm_shield_check_icon',
68 68 ),
69 - 'credit_card' => array(
70 - 'name' => __( 'Payment', 'formidable' ),
71 - 'icon' => 'frm_icon_font frm_credit_card2_icon',
72 - ),
73 - FrmSubmitHelper::FIELD_TYPE => array(
74 - 'name' => __( 'Submit', 'formidable' ),
75 - 'hide' => true,
76 - ),
77 - FrmFieldGdprHelper::FIELD_TYPE => array(
78 - 'name' => __( 'GDPR', 'formidable' ),
79 - 'icon' => 'frm_icon_font frm-gdpr-icon',
80 - 'hide' => FrmFieldGdprHelper::hide_gdpr_field(),
81 - ),
82 69 );
83 70
84 - /**
85 - * @param array $fields
86 - */
87 71 return apply_filters( 'frm_available_fields', $fields );
88 72 }
89 73
90 - /**
91 - * Get the name of the Captcha field based on the global Captcha setting.
92 - *
93 - * @return string
94 - */
95 - private static function get_captcha_field_name() {
96 - return 'Captcha';
97 - }
98 -
99 74 public static function pro_field_selection() {
100 75 $images_url = FrmAppHelper::plugin_url() . '/images/';
101 76 $fields = array(
102 - 'file' => array(
103 - 'name' => __( 'File Upload', 'formidable' ),
104 - 'icon' => 'frm_icon_font frm_upload3_icon',
105 - 'message' => __( 'Add file uploads to save time and cut down on back-and-forth. Upgrade to Pro to get Upload fields and more.', 'formidable' ),
77 + 'file' => array(
78 + 'name' => __( 'File Upload', 'formidable' ),
79 + 'icon' => 'frm_icon_font frm_upload_icon',
80 + 'message' => 'Add file uploads to save time and cut down on back-and-forth. Upgrade to Pro to get Upload fields and more.',
106 81 ),
107 - 'ranking' => array(),
108 - 'rte' => array(
82 + 'rte' => array(
109 83 'name' => __( 'Rich Text', 'formidable' ),
110 84 'icon' => 'frm_icon_font frm_align_right_icon',
111 85 ),
112 - 'date' => array(
86 + 'date' => array(
113 87 'name' => __( 'Date', 'formidable' ),
114 - 'icon' => 'frm_icon_font frm_calendar2_icon',
88 + 'icon' => 'frm_icon_font frm_calendar_icon',
115 89 ),
116 - 'time' => array(
90 + 'time' => array(
117 91 'name' => __( 'Time', 'formidable' ),
118 92 'icon' => 'frm_icon_font frm_clock_icon',
119 93 ),
120 - 'scale' => array(
121 - 'name' => __( 'Scale', 'formidable' ),
122 - 'icon' => 'frm_icon_font frm_linear_scale_icon',
123 - 'message' => esc_html__( 'Add a set of radio buttons with whatever range you choose.', 'formidable' ) . '<img src="' . esc_url( $images_url ) . 'scale_field.png" alt="' . esc_attr__( 'Scale Field', 'formidable' ) . '" />',
94 + 'scale' => array(
95 + 'name' => __( 'Scale', 'formidable' ),
96 + 'icon' => 'frm_icon_font frm_linear_scale_icon',
97 + 'message' => 'Add a set of radio buttons with whatever range you choose. <img src="' . esc_attr( $images_url ) . 'scale_field.png" alt="Scale Field" />',
124 98 ),
125 - 'star' => array(
99 + 'star' => array(
126 100 'name' => __( 'Star Rating', 'formidable' ),
127 - 'icon' => 'frm_icon_font frm_star2_icon',
101 + 'icon' => 'frm_icon_font frm_star_icon',
128 102 ),
129 - 'range' => array(
103 + 'range' => array(
130 104 'name' => __( 'Slider', 'formidable' ),
131 105 'icon' => 'frm_icon_font frm_code_commit_icon',
132 106 ),
133 - 'toggle' => array(
107 + 'toggle' => array(
134 108 'name' => __( 'Toggle', 'formidable' ),
135 109 'icon' => 'frm_icon_font frm_toggle_on_icon',
136 110 ),
137 - 'data' => array(
138 - 'name' => __( 'Dynamic', 'formidable' ),
139 - 'icon' => 'frm_icon_font frm_dynamic_icon',
140 - 'message' => __( 'Create relationships between multiple forms. You can link a member to a team, a rating to a product, a comment to a submission, and much more.', 'formidable' ),
111 + 'data' => array(
112 + 'name' => __( 'Dynamic', 'formidable' ),
113 + 'icon' => 'frm_icon_font frm_sitemap_icon',
114 + 'message' => 'Create relationships between multiple forms. You can link a member to a team, a rating to a product, a comment to a submission, and much more.',
141 115 ),
142 - 'lookup' => array(
143 - 'name' => __( 'Lookup', 'formidable' ),
144 - 'icon' => 'frm_icon_font frm_search_icon',
145 - 'message' => esc_html__( 'Filter the options in the next field and automatically add values to other fields. Upgrade to Pro to get Lookup fields and more.', 'formidable' ) . ' <img src="' . esc_url( $images_url ) . 'look-up_year-make-model.gif" alt="' . esc_attr__( 'cascading lookup fields', 'formidable' ) . '" />',
116 + 'lookup' => array(
117 + 'name' => __( 'Lookup', 'formidable' ),
118 + 'icon' => 'frm_icon_font frm_search_icon',
119 + 'message' => 'Filter the options in the next field and automatically add values to other fields. Upgrade to Pro to get Lookup fields and more. <img src="' . esc_attr( $images_url ) . 'look-up_year-make-model.gif" alt="cascading lookup fields" />',
146 120 ),
147 - 'divider|repeat' => array(
148 - 'name' => __( 'Repeater', 'formidable' ),
149 - 'icon' => 'frm_icon_font frm_refresh_icon',
150 - 'message' => esc_html__( 'Allow your visitors to add new sets of fields while filling out forms. Increase conversions while saving building time and server resources.', 'formidable' ) . ' <img src="' . esc_url( $images_url ) . 'repeatable-section_frontend.gif" alt="' . esc_attr__( 'Dynamically Add Form Fields with repeatable sections', 'formidable' ) . '" />',
121 + 'divider|repeat' => array(
122 + 'name' => __( 'Repeater', 'formidable' ),
123 + 'icon' => 'frm_icon_font frm_repeater_icon',
124 + 'message' => 'Allow your visitors to add new sets of fields while filling out forms. Increase conversions while saving building time and server resources. <img src="' . esc_attr( $images_url ) . 'repeatable-section_frontend.gif" alt="Dynamically Add Form Fields with repeatable sections" />',
151 125 ),
152 - 'end_divider' => array(
126 + 'end_divider' => array(
153 127 'name' => __( 'Section Buttons', 'formidable' ),
154 128 'switch_from' => 'divider',
155 129 ),
156 - 'divider' => array(
130 + 'divider' => array(
157 131 'name' => __( 'Section', 'formidable' ),
158 132 'icon' => 'frm_icon_font frm_header_icon',
159 133 ),
160 - 'break' => array(
161 - 'name' => __( 'Page Break', 'formidable' ),
162 - 'icon' => 'frm_icon_font frm_page_break_icon',
163 - 'message' => __( 'Get multi-paged forms with progress bars. Did you know you can upgrade to PRO to unlock multi-step forms with more awesome features?', 'formidable' ),
134 + 'break' => array(
135 + 'name' => __( 'Page Break', 'formidable' ),
136 + 'icon' => 'frm_icon_font frm_page_break_icon',
137 + 'message' => 'Get multi-paged forms with progress bars. Did you know you can upgrade to PRO to unlock multi-step forms with more awesome features?',
164 138 ),
165 - 'form' => array(
139 + 'form' => array(
166 140 'name' => __( 'Embed Form', 'formidable' ),
167 - 'icon' => 'frm_icon_font frm_file_text2_icon',
141 + 'icon' => 'frm_icon_font frm_file_text_icon',
168 142 ),
169 - 'likert' => array(
143 + 'likert' => array(
170 144 'name' => __( 'Likert Scale', 'formidable' ),
171 145 'icon' => 'frm_icon_font frm_likert_scale frm_show_upgrade',
172 146 'addon' => 'surveys',
173 147 ),
174 - 'nps' => array(
148 + 'nps' => array(
175 149 'name' => __( 'NPS', 'formidable' ),
176 150 'icon' => 'frm_icon_font frm_nps frm_show_upgrade',
177 151 'addon' => 'surveys',
178 152 ),
179 - 'password' => array(
153 + 'password' => array(
180 154 'name' => __( 'Password', 'formidable' ),
181 - 'icon' => 'frm_icon_font frm_lock_closed2_icon',
155 + 'icon' => 'frm_icon_font frm_lock_open_icon',
182 156 ),
183 - 'tag' => array(
157 + 'tag' => array(
184 158 'name' => __( 'Tags', 'formidable' ),
185 - 'icon' => 'frm_icon_font frm_price_tags2_icon',
159 + 'icon' => 'frm_icon_font frm_price_tags_icon',
186 160 ),
187 - // This is no longer a Pro field, but without this here, Pro triggers "undefined index" notices.
188 - // Right now it leaves a gap. Maybe we can skip anything without a name or something.
189 - 'credit_card' => array(
190 - 'name' => '',
191 - 'icon' => '',
161 + 'credit_card' => array(
162 + 'name' => __( 'Credit Card', 'formidable' ),
163 + 'icon' => 'frm_icon_font frm_credit_card_icon frm_show_upgrade',
164 + 'addon' => 'stripe',
192 165 ),
193 - 'address' => array(
166 + 'address' => array(
194 167 'name' => __( 'Address', 'formidable' ),
195 - 'icon' => 'frm_icon_font frm_location2_icon',
168 + 'icon' => 'frm_icon_font frm_location_icon',
196 169 ),
197 - 'summary' => array(
198 - 'name' => __( 'Summary', 'formidable' ),
199 - 'icon' => 'frm_icon_font frm_file_text3_icon',
200 - 'message' => __( 'Allow visitors to review their responses before a form is submitted. Upgrade to Pro to get Summary fields and more.', 'formidable' ),
170 + 'summary' => array(
171 + 'name' => __( 'Summary', 'formidable' ),
172 + 'icon' => 'frm_icon_font frm_file_text_icon',
173 + 'message' => 'Allow visitors to review their responses before a form is submitted. Upgrade to Pro to get Summary fields and more.',
201 174 ),
202 - 'signature' => array(
175 + 'signature' => array(
203 176 'name' => __( 'Signature', 'formidable' ),
204 177 'icon' => 'frm_icon_font frm_signature_icon frm_show_upgrade',
205 178 'addon' => 'signature',
206 179 ),
207 - 'ai' => array(
208 - 'name' => __( 'AI', 'formidable' ),
209 - 'icon' => 'frm_icon_font frm-ai-icon frm_show_upgrade',
210 - 'addon' => 'ai',
211 - 'message' => __( 'Streamline workflows and reclaim valuable time with the power of AI. You can effortlessly respond to your visitors in real-time with ChatGPT as your automated assistant. Upgrade to Pro and unlock AI-powered fields.', 'formidable' ),
180 + 'quiz_score' => array(
181 + 'name' => __( 'Quiz Score', 'formidable' ),
182 + 'icon' => 'frm_icon_font frm_percent_icon frm_show_upgrade',
183 + 'addon' => 'quizzes',
212 184 ),
213 185 'ssa-appointment' => array(
214 186 'name' => __( 'Appointment', 'formidable' ),
215 - 'icon' => 'frm_icon_font frm_schedule_icon frm_show_upgrade',
187 + 'icon' => 'frm_icon_font frm_calendar_icon frm_show_upgrade',
216 188 'require' => 'Simply Schedule Appointments',
217 - 'message' => sprintf(
218 - /* translators: %1$s: Link opening HTML, %2$s: Link tag closing */
219 - esc_html__( 'Appointment fields are an integration with %1$sSimply Schedule Appointments%2$s. Get started now to schedule appointments directly from your forms.', 'formidable' ),
220 - '<a href="https://simplyscheduleappointments.com/meet/formidable/">',
221 - '</a>'
222 - ) . '<img src="' . esc_url( $images_url ) . 'appointments.png" alt="' . esc_attr__( 'Scheduling', 'formidable' ) . '" />',
189 + 'message' => 'Appointment fields are an integration with <a href="https://simplyscheduleappointments.com/meet/formidable/">Simply Schedule Appointments</a>. Get started now to schedule appointments directly from your forms.
190 + <img src="' . esc_attr( $images_url ) . 'appointments.png" alt="Scheduling" />',
223 191 'link' => 'https://simplyscheduleappointments.com/meet/formidable/',
224 192 ),
225 - 'product' => array(
193 + 'product' => array(
226 194 'name' => __( 'Product', 'formidable' ),
227 - 'icon' => 'frm_icon_font frm_product2_icon',
195 + 'icon' => 'frm_icon_font frm_product_icon',
228 196 'section' => 'pricing',
229 197 ),
230 - 'quantity' => array(
198 + 'quantity' => array(
231 199 'name' => __( 'Quantity', 'formidable' ),
232 200 'icon' => 'frm_icon_font frm_quantity_icon',
233 201 'section' => 'pricing',
234 202 ),
235 - 'total' => array(
203 + 'total' => array(
236 204 'name' => __( 'Total', 'formidable' ),
237 - 'icon' => 'frm_icon_font frm_total2_icon',
205 + 'icon' => 'frm_icon_font frm_total_icon',
238 206 'section' => 'pricing',
239 207 ),
240 208 );
241 209
242 - if ( self::include_ranking_fields() ) {
243 - $fields['ranking'] = array(
244 - 'name' => __( 'Ranking', 'formidable' ),
245 - 'icon' => 'frm_icon_font frm_chart_bar_icon frm_show_upgrade',
246 - 'message' => __( 'Now you can effortlessly gather insights, preferences, and opinions by allowing users to rank options.', 'formidable' ),
247 - 'upsell_image' => esc_url( $images_url ) . 'ranking-field.svg',
248 - 'addon' => 'surveys',
249 - 'is_new' => self::field_is_new( 'ranking' ),
250 - );
251 - } else {
252 - unset( $fields['ranking'] );
253 - }
254 -
255 - if ( ! FrmAppHelper::show_new_feature( 'ai' ) ) {
256 - unset( $fields['ai'] );
257 - }
258 -
259 210 // Since the signature field may be in a different section, don't show it twice.
260 211 $lite_fields = self::field_selection();
261 212 if ( isset( $lite_fields['signature'] ) ) {
262 213 unset( $fields['signature'] );
@@ -265,102 +216,9 @@
265 216 return apply_filters( 'frm_pro_available_fields', $fields );
266 217 }
267 218
268 219 /**
269 - * Check if we should show ranking fields in the builder.
270 - * This is based on the active version coming from our API data.
271 - * If Surveys v1.1 is not released yet, we don't want to display ranking fields yet.
272 - *
273 - * @since 6.8.3
274 - *
275 - * @return bool
276 - */
277 - private static function include_ranking_fields() {
278 - if ( class_exists( 'FrmSurveys\models\fields\Ranking' ) ) {
279 - // Always return true if Ranking fields exist.
280 - return true;
281 - }
282 -
283 - $plugin = 'formidable-surveys/formidable-surveys.php';
284 - $expected_version = '1.1';
285 -
286 - return self::installed_plugin_meets_version( $plugin, $expected_version ) || self::api_meets_version( $plugin, $expected_version );
287 - }
288 -
289 - /**
290 - * @since 6.8.3
291 - *
292 - * @param string $plugin
293 - * @param string $expected_version
294 - * @return bool
295 - */
296 - private static function installed_plugin_meets_version( $plugin, $expected_version ) {
297 - $installed_version = self::get_installed_version( $plugin );
298 - return $installed_version && version_compare( $installed_version, $expected_version, '>=' );
299 - }
300 -
301 - /**
302 - * @since 6.8.3
303 - *
304 - * @param string $plugin
305 - * @return false|string String version. False if the plugin is not installed.
306 - */
307 - private static function get_installed_version( $plugin ) {
308 - if ( ! function_exists( 'get_plugins' ) ) {
309 - require_once ABSPATH . 'wp-admin/includes/plugin.php';
310 - }
311 - $plugins = get_plugins();
312 - if ( isset( $plugins[ $plugin ] ) && ! empty( $plugins[ $plugin ]['Version'] ) ) {
313 - return $plugins[ $plugin ]['Version'];
314 - }
315 - return false;
316 - }
317 -
318 - /**
319 - * @since 6.8.3
320 - *
321 - * @param string $plugin
322 - * @param string $expected_version
323 - * @return bool
324 - */
325 - private static function api_meets_version( $plugin, $expected_version ) {
326 - $api = new FrmFormApi();
327 - $addons = $api->get_api_info();
328 - $matches = wp_list_filter( $addons, array( 'plugin' => $plugin ) );
329 - if ( ! $matches ) {
330 - return false;
331 - }
332 -
333 - $match = reset( $matches );
334 - if ( empty( $match['new_version'] ) ) {
335 - return false;
336 - }
337 -
338 - $api_version = $match['new_version'];
339 - return version_compare( $api_version, $expected_version, '>=' );
340 - }
341 -
342 - /**
343 - * Consider a field new for 90 days after the release date.
344 - *
345 - * @since 6.8.3
346 - *
347 - * @param string $type
348 - * @return bool
349 - */
350 - private static function field_is_new( $type ) {
351 - if ( 'ranking' === $type ) {
352 - $ranking_release_date = '2024-03-12';
353 - $three_months_after_release = gmdate( 'Y-m-d', strtotime( $ranking_release_date . ' + 90 days' ) );
354 - return gmdate( 'Y-m-d' ) < $three_months_after_release;
355 - }
356 - return false;
357 - }
358 -
359 - /**
360 220 * @since 4.0
361 - *
362 - * @return array
363 221 */
364 222 public static function all_field_selection() {
365 223 $pro_field_selection = self::pro_field_selection();
366 224 return array_merge( $pro_field_selection, self::field_selection() );
@@ -365,28 +223,19 @@
365 223 $pro_field_selection = self::pro_field_selection();
366 224 return array_merge( $pro_field_selection, self::field_selection() );
367 225 }
368 226
369 - /**
370 - * Create a field.
371 - *
372 - * @param array $values
373 - * @param bool $return
374 - * @return false|int
375 - */
376 227 public static function create( $values, $return = true ) {
377 228 global $wpdb, $frm_duplicate_ids;
378 229
379 230 $new_values = array();
380 - $key = $values['field_key'] ?? $values['name'];
231 + $key = isset( $values['field_key'] ) ? $values['field_key'] : $values['name'];
381 232 $new_values['field_key'] = FrmAppHelper::get_unique_key( $key, $wpdb->prefix . 'frm_fields', 'field_key' );
382 233
383 234 $values = FrmAppHelper::maybe_filter_array( $values, array( 'name', 'description' ) );
384 235
385 236 foreach ( array( 'name', 'description', 'type', 'default_value' ) as $col ) {
386 - if ( isset( $values[ $col ] ) ) {
387 - $new_values[ $col ] = $values[ $col ];
388 - }
237 + $new_values[ $col ] = $values[ $col ];
389 238 }
390 239
391 240 $new_values['options'] = self::maybe_filter_options( $values['options'] );
392 241 $new_values['field_order'] = isset( $values['field_order'] ) ? (int) $values['field_order'] : null;
@@ -413,32 +262,30 @@
413 262 unset( $k, $v );
414 263 }
415 264
416 265 $query_results = $wpdb->insert( $wpdb->prefix . 'frm_fields', $new_values );
266 + $new_id = 0;
267 + if ( $query_results ) {
268 + self::delete_form_transient( $new_values['form_id'] );
269 + $new_id = $wpdb->insert_id;
270 + }
417 271
418 - if ( ! $query_results ) {
272 + if ( ! $return ) {
419 273 return false;
420 274 }
421 275
422 - self::delete_form_transient( $new_values['form_id'] );
423 - $new_id = $wpdb->insert_id;
276 + if ( $query_results ) {
277 + if ( isset( $values['id'] ) ) {
278 + $frm_duplicate_ids[ $values['id'] ] = $new_id;
279 + }
424 280
425 - if ( ! $return ) {
281 + return $new_id;
282 + } else {
426 283 return false;
427 284 }
428 -
429 - if ( isset( $values['id'] ) ) {
430 - $frm_duplicate_ids[ $values['id'] ] = $new_id;
431 - }
432 -
433 - return $new_id;
434 285 }
435 286
436 287 /**
437 - * Maybe filter HTML in field options data.
438 - * HTML is only filtered when unsafe HTML is disallowed.
439 - * See FrmAppHelper::allow_unfiltered_html.
440 - *
441 288 * @since 5.0.08
442 289 *
443 290 * @param array $options
444 291 * @return array
@@ -443,82 +290,12 @@
443 290 * @param array $options
444 291 * @return array
445 292 */
446 293 private static function maybe_filter_options( $options ) {
447 - $options = FrmAppHelper::maybe_filter_array( $options, array( 'custom_html' ) );
448 -
449 - if ( ! empty( $options['custom_html'] ) ) {
450 - $options['custom_html'] = self::maybe_filter_custom_html_input_attributes( $options['custom_html'] );
451 - }
452 -
453 - if ( ! empty( $options['classes'] ) ) {
454 - $options['classes'] = implode( ' ', array_map( 'FrmFormsHelper::sanitize_layout_class', explode( ' ', $options['classes'] ) ) );
455 - }
456 -
457 - return $options;
294 + return FrmAppHelper::maybe_filter_array( $options, array( 'custom_html' ) );
458 295 }
459 296
460 297 /**
461 - * Prevent users who do not have permission to insert JavaScript attributes in input elements.
462 - * This is triggered when a field is updated.
463 - *
464 - * @since 6.11.2
465 - *
466 - * @param string $html
467 - * @return string
468 - */
469 - private static function maybe_filter_custom_html_input_attributes( $html ) {
470 - if ( FrmAppHelper::allow_unfiltered_html() ) {
471 - return $html;
472 - }
473 -
474 - $pattern = get_shortcode_regex( array( 'input' ) );
475 - return preg_replace_callback(
476 - "/$pattern/",
477 - /**
478 - * @param array $match Shortcode data.
479 - * @return string
480 - */
481 - function ( $match ) {
482 - $attr = shortcode_parse_atts( $match[3] );
483 -
484 - if ( ! is_array( $attr ) ) {
485 - // In old versions of WordPress (older than 6.5), this might not be an array.
486 - return '[input]';
487 - }
488 -
489 - $safe_atts = array();
490 - foreach ( $attr as $attr_key => $att ) {
491 - if ( ! is_numeric( $attr_key ) ) {
492 - // opt=1 without parentheses for example is mapped like 'opt' => 1.
493 - $key = $attr_key;
494 - $value = $att;
495 - } else {
496 - // Some data is mapped like 0 => 'placeholder="Placeholder"'.
497 - $split = explode( '=', $att, 2 );
498 - if ( 2 !== count( $split ) ) {
499 - continue;
500 - }
501 - $key = trim( $split[0] );
502 - $value = trim( $split[1], '"' );
503 - }
504 -
505 - if ( FrmAppHelper::input_key_is_safe( $key, 'update' ) ) {
506 - $safe_atts[ $key ] = $value;
507 - }
508 - }
509 -
510 - if ( ! $safe_atts ) {
511 - return '[input]';
512 - }
513 -
514 - return '[input ' . FrmAppHelper::array_to_html_params( $safe_atts ) . ']';
515 - },
516 - $html
517 - );
518 - }
519 -
520 - /**
521 298 * Process the field duplication.
522 299 *
523 300 * @since 5.0.05
524 301 */
@@ -609,16 +386,11 @@
609 386 $new_id = self::create( $values );
610 387 $frm_duplicate_ids[ $field->id ] = $new_id;
611 388 $frm_duplicate_ids[ $field->field_key ] = $new_id;
612 389 unset( $field );
613 - }//end foreach
390 + }
614 391 }
615 392
616 - /**
617 - * @param int|string $id
618 - * @param array $values
619 - * @return false|int
620 - */
621 393 public static function update( $id, $values ) {
622 394 global $wpdb;
623 395
624 396 $id = absint( $id );
@@ -634,22 +406,10 @@
634 406
635 407 self::preserve_format_option_backslashes( $values );
636 408
637 409 if ( isset( $values['type'] ) ) {
638 - if ( 'dropdown' === $values['type'] ) {
639 - // To avoid conflicts with security plugins the value "dropdown" is sent for select fields.
640 - // This is because "select" gets matched for SQL injection attempts.
641 - $values['type'] = 'select';
642 - }
410 + $values = apply_filters( 'frm_clean_' . $values['type'] . '_field_options_before_update', $values );
643 411
644 - /**
645 - * @since 6.9 The Field ID param was added.
646 - *
647 - * @param array $values
648 - * @param int $id Field ID.
649 - */
650 - $values = apply_filters( 'frm_clean_' . $values['type'] . '_field_options_before_update', $values, $id );
651 -
652 412 if ( $values['type'] === 'hidden' && isset( $values['field_options'] ) && isset( $values['field_options']['clear_on_focus'] ) ) {
653 413 // don't keep the old placeholder setting for hidden fields
654 414 $values['field_options']['clear_on_focus'] = 0;
655 415 }
@@ -696,9 +456,9 @@
696 456 * Keep backslashes in the phone format option
697 457 *
698 458 * @since 2.0.8
699 459 *
700 - * @param array $values Pass by reference.
460 + * @param $values array - pass by reference
701 461 */
702 462 private static function preserve_format_option_backslashes( &$values ) {
703 463 if ( isset( $values['field_options']['format'] ) ) {
704 464 $values['field_options']['format'] = FrmAppHelper::preserve_backslashes( $values['field_options']['format'] );
@@ -742,11 +502,8 @@
742 502 }
743 503
744 504 /**
745 505 * If $field is numeric, get the field object
746 - *
747 - * @param int|object|string $field
748 - * @return void
749 506 */
750 507 public static function maybe_get_field( &$field ) {
751 508 if ( ! is_object( $field ) ) {
752 509 $field = self::getOne( $field );
@@ -753,10 +510,10 @@
753 510 }
754 511 }
755 512
756 513 /**
757 - * @param int|string $id The field id or key.
758 - * @param bool $filter When true, run the frm_field filter.
514 + * @param string|int $id The field id or key.
515 + * @param bool $filter When true, run the frm_field filter.
759 516 */
760 517 public static function getOne( $id, $filter = false ) {
761 518 if ( empty( $id ) ) {
762 519 return null;
@@ -802,10 +559,10 @@
802 559
803 560 /**
804 561 * Get the field type by key or id
805 562 *
806 - * @param int|string $id The field id or key.
807 - * @param mixed $col The name of the column in the fields database table.
563 + * @param int|string The field id or key
564 + * @param mixed $col The name of the column in the fields database table
808 565 */
809 566 public static function get_type( $id, $col = 'type' ) {
810 567 $field = FrmDb::check_cache( $id, 'frm_field' );
811 568 if ( $field ) {
@@ -810,25 +567,19 @@
810 567 $field = FrmDb::check_cache( $id, 'frm_field' );
811 568 if ( $field ) {
812 569 $type = $field->{$col};
813 570 } else {
814 - if ( is_numeric( $id ) ) {
815 - $where = array( 'id' => $id );
816 - } else {
817 - $where = array( 'field_key' => $id );
818 - }
819 - $type = FrmDb::get_var( 'frm_fields', $where, $col );
571 + $where = array(
572 + 'or' => 1,
573 + 'id' => $id,
574 + 'field_key' => $id,
575 + );
576 + $type = FrmDb::get_var( 'frm_fields', $where, $col );
820 577 }
821 578
822 579 return $type;
823 580 }
824 581
825 - /**
826 - * @param int|string $form_id
827 - * @param string $type
828 - * @param int|string $limit
829 - * @param string $inc_sub
830 - */
831 582 public static function get_all_types_in_form( $form_id, $type, $limit = '', $inc_sub = 'exclude' ) {
832 583 if ( ! $form_id ) {
833 584 return array();
834 585 }
@@ -848,9 +599,9 @@
848 599 continue;
849 600 }
850 601
851 602 $fields[ $result->id ] = $result;
852 - ++$count;
603 + $count ++;
853 604 if ( $limit == 1 ) {
854 605 $fields = $result;
855 606 break;
856 607 }
@@ -862,9 +613,9 @@
862 613 unset( $result );
863 614 }
864 615
865 616 return wp_unslash( $fields );
866 - }//end if
617 + }
867 618
868 619 self::$use_cache = false;
869 620
870 621 $where = array(
@@ -878,15 +629,8 @@
878 629
879 630 return $results;
880 631 }
881 632
882 - /**
883 - * @param int|string $form_id
884 - * @param int|string $limit
885 - * @param string $inc_embed
886 - * @param string $inc_repeat
887 - * @return array
888 - */
889 633 public static function get_all_for_form( $form_id, $limit = '', $inc_embed = 'exclude', $inc_repeat = 'include' ) {
890 634 if ( ! (int) $form_id ) {
891 635 return array();
892 636 }
@@ -899,9 +643,9 @@
899 643
900 644 $fields = array();
901 645 $count = 0;
902 646 foreach ( $results as $result ) {
903 - ++$count;
647 + $count ++;
904 648 $fields[ $result->id ] = $result;
905 649 if ( ! empty( $limit ) && $count >= $limit ) {
906 650 break;
907 651 }
@@ -930,12 +674,12 @@
930 674 /**
931 675 * If repeating fields should be included, adjust $where accordingly
932 676 *
933 677 * @param string $inc_repeat
934 - * @param array $where Pass by reference.
678 + * @param array $where - pass by reference
935 679 */
936 680 private static function maybe_include_repeating_fields( $inc_repeat, &$where ) {
937 - if ( $inc_repeat === 'include' ) {
681 + if ( $inc_repeat == 'include' ) {
938 682 $form_id = $where['fi.form_id'];
939 683 $where[] = array(
940 684 'or' => 1,
941 685 'fi.form_id' => $form_id,
@@ -950,9 +694,9 @@
950 694 if ( 'include' != $inc_embed || $no_sub_forms ) {
951 695 return;
952 696 }
953 697
954 - $form_fields = $results;
698 + $form_fields = $results;
955 699 $should_get_subforms = ( $type !== 'all' && $type !== 'form' && ! empty( $form_id ) );
956 700 if ( $should_get_subforms ) {
957 701 $form_fields = self::get_all_types_in_form( $form_id, 'form' );
958 702 }
@@ -962,9 +706,9 @@
962 706 if ( 'form' != $field->type || ! isset( $field->field_options['form_select'] ) ) {
963 707 continue;
964 708 }
965 709
966 - if ( $type === 'all' ) {
710 + if ( $type == 'all' ) {
967 711 $sub_fields = self::get_all_for_form( $field->field_options['form_select'] );
968 712 } else {
969 713 $sub_fields = self::get_all_types_in_form( $field->field_options['form_select'], $type );
970 714 }
@@ -969,9 +713,9 @@
969 713 $sub_fields = self::get_all_types_in_form( $field->field_options['form_select'], $type );
970 714 }
971 715
972 716 if ( ! empty( $sub_fields ) ) {
973 - $index = $k + $index_offset;
717 + $index = $k + $index_offset;
974 718 $index_offset += count( $sub_fields );
975 719 array_splice( $results, $index, 0, $sub_fields );
976 720 }
977 721 unset( $field, $sub_fields );
@@ -1010,10 +754,10 @@
1010 754 }
1011 755
1012 756 $limit = FrmDb::esc_limit( $limit );
1013 757
1014 - $query = "SELECT fi.*, fr.name as form_name FROM {$table_name} fi JOIN {$form_table_name} fr ON fi.form_id=fr.id";
1015 - $query_type = $limit === ' LIMIT 1' || $limit == 1 ? 'row' : 'results';
758 + $query = "SELECT fi.*, fr.name as form_name FROM {$table_name} fi LEFT OUTER JOIN {$form_table_name} fr ON fi.form_id=fr.id";
759 + $query_type = ( $limit == ' LIMIT 1' || $limit == 1 ) ? 'row' : 'results';
1016 760
1017 761 if ( is_array( $where ) ) {
1018 762 $args = array(
1019 763 'order_by' => $order_by,
@@ -1018,14 +762,14 @@
1018 762 $args = array(
1019 763 'order_by' => $order_by,
1020 764 'limit' => $limit,
1021 765 );
1022 - $results = FrmDb::get_var( $table_name . ' fi JOIN ' . $form_table_name . ' fr ON fi.form_id=fr.id', $where, 'fi.*, fr.name as form_name', $args, '', $query_type );
766 + $results = FrmDb::get_var( $table_name . ' fi LEFT OUTER JOIN ' . $form_table_name . ' fr ON fi.form_id=fr.id', $where, 'fi.*, fr.name as form_name', $args, '', $query_type );
1023 767 } else {
1024 768 // if the query is not an array, then it has already been prepared
1025 769 $query .= FrmDb::prepend_and_or_where( ' WHERE ', $where ) . $order_by . $limit;
1026 770
1027 - $function_name = $query_type === 'row' ? 'get_row' : 'get_results';
771 + $function_name = ( $query_type == 'row' ) ? 'get_row' : 'get_results';
1028 772 $results = $wpdb->$function_name( $query );
1029 773 }
1030 774 unset( $where );
1031 775
@@ -1041,10 +785,8 @@
1041 785 */
1042 786 private static function format_field_results( &$results ) {
1043 787 if ( is_array( $results ) ) {
1044 788 foreach ( $results as $r_key => $result ) {
1045 - self::add_slashes_to_format_before_setting_field_cache( $result );
1046 -
1047 789 FrmDb::set_cache( $result->id, $result, 'frm_field' );
1048 790 FrmDb::set_cache( $result->field_key, $result, 'frm_field' );
1049 791
1050 792 self::prepare_options( $result );
@@ -1062,26 +804,8 @@
1062 804 }
1063 805 }
1064 806
1065 807 /**
1066 - * When $result->field_options is an array and not a serialized string there is only a single backslash.
1067 - * Cached results are unslashed in FrmField::getAll, so we need to make sure that the cached object has an extra backslash.
1068 - * Otherwise the backslash is stripped away on load.
1069 - *
1070 - * @since 6.15
1071 - *
1072 - * @param stdClass $result
1073 - * @return void
1074 - */
1075 - private static function add_slashes_to_format_before_setting_field_cache( $result ) {
1076 - if ( ! isset( $result->field_options ) || ! is_array( $result->field_options ) || empty( $result->field_options['format'] ) ) {
1077 - return;
1078 - }
1079 -
1080 - $result->field_options['format'] = addslashes( $result->field_options['format'] );
1081 - }
1082 -
1083 - /**
1084 808 * Unserialize all the serialized field data
1085 809 *
1086 810 * @since 2.0
1087 811 */
@@ -1090,21 +814,16 @@
1090 814 FrmAppHelper::unserialize_or_decode( $results->options );
1091 815
1092 816 // Allow a single box to be checked for the default value.
1093 817 $before = $results->default_value;
1094 -
1095 - $field_object = FrmFieldFactory::get_field_type( $results->type );
1096 -
1097 - if ( $field_object->should_unserialize_value() ) {
1098 - FrmAppHelper::unserialize_or_decode( $results->default_value );
1099 - if ( $before === $results->default_value && is_string( $before ) && strpos( $before, '["' ) === 0 ) {
1100 - $results->default_value = FrmAppHelper::maybe_json_decode( $results->default_value );
1101 - }
818 + FrmAppHelper::unserialize_or_decode( $results->default_value );
819 + if ( $before === $results->default_value && ! is_array( $before ) && strpos( $before, '["' ) === 0 ) {
820 + $results->default_value = FrmAppHelper::maybe_json_decode( $results->default_value );
1102 821 }
1103 822 }
1104 823
1105 824 /**
1106 - * If a form has too many fields, they won't all save into a single transient.
825 + * If a form has too many fields, thay won't all save into a single transient.
1107 826 * We'll break them into groups of 200
1108 827 *
1109 828 * @since 2.0.1
1110 829 */
@@ -1128,9 +847,9 @@
1128 847 $fields = array_merge( $fields, $next_fields );
1129 848
1130 849 if ( count( $next_fields ) >= self::$transient_size ) {
1131 850 // if this transient is full, check for another
1132 - ++$next;
851 + $next ++;
1133 852 self::get_next_transient( $fields, $base_name, $next );
1134 853 }
1135 854 }
1136 855 }
@@ -1149,9 +868,9 @@
1149 868 $set = set_transient( $name, $field, 60 * 60 * 6 );
1150 869 if ( ! $set ) {
1151 870 // the transient didn't save
1152 871 if ( $name != $base_name ) {
1153 - // if the first saved an others fail, this will show an incomplete form
872 + // if the first saved an others fail, this will show an incmoplete form
1154 873 self::delete_form_transient( $form_id );
1155 874 }
1156 875
1157 876 return;
@@ -1156,25 +875,18 @@
1156 875
1157 876 return;
1158 877 }
1159 878
1160 - ++$next;
879 + $next ++;
1161 880 }
1162 881 }
1163 882
1164 - /**
1165 - * @param string $type
1166 - * @return bool
1167 - */
1168 883 public static function is_no_save_field( $type ) {
1169 - return in_array( $type, self::no_save_fields(), true );
884 + return in_array( $type, self::no_save_fields() );
1170 885 }
1171 886
1172 - /**
1173 - * @return string[]
1174 - */
1175 887 public static function no_save_fields() {
1176 - return array( 'divider', 'end_divider', 'captcha', 'break', 'html', 'form', 'summary', FrmSubmitHelper::FIELD_TYPE );
888 + return array( 'divider', 'end_divider', 'captcha', 'break', 'html', 'form', 'summary' );
1177 889 }
1178 890
1179 891 /**
1180 892 * Check if this field can hold an array of values
@@ -1182,9 +894,9 @@
1182 894 * @since 2.0.9
1183 895 *
1184 896 * @param array|object $field
1185 897 *
1186 - * @return bool
898 + * @return boolean
1187 899 */
1188 900 public static function is_field_with_multiple_values( $field ) {
1189 901 if ( ! $field ) {
1190 902 return false;
@@ -1193,9 +905,9 @@
1193 905 $field_type = self::get_original_field_type( $field );
1194 906
1195 907 $is_multi_value_field = (
1196 908 self::is_checkbox( $field ) ||
1197 - $field_type === 'address' ||
909 + $field_type == 'address' ||
1198 910 self::is_multiple_select( $field )
1199 911 );
1200 912
1201 913 return $is_multi_value_field;
@@ -1202,9 +914,8 @@
1202 914 }
1203 915
1204 916 /**
1205 917 * @since 3.0
1206 - * @param array|object $field
1207 918 * @return string
1208 919 */
1209 920 public static function get_field_type( $field ) {
1210 921 return is_array( $field ) ? $field['type'] : $field->type;
@@ -1218,10 +929,9 @@
1218 929 $field_type = self::get_field_type( $field );
1219 930 $original_type = self::get_option( $field, 'original_type' );
1220 931
1221 932 if ( ! empty( $original_type ) && $original_type != $field_type ) {
1222 - // Check the original type for arrays.
1223 - $field_type = $original_type;
933 + $field_type = $original_type; // check the original type for arrays
1224 934 }
1225 935
1226 936 return $field_type;
1227 937 }
@@ -1229,9 +939,9 @@
1229 939 /**
1230 940 * Check if this is a multiselect dropdown field
1231 941 *
1232 942 * @since 2.0.9
1233 - * @return bool
943 + * @return boolean
1234 944 */
1235 945 public static function is_multiple_select( $field ) {
1236 946 $field_type = self::get_field_type( $field );
1237 947 $is_multiple = self::is_option_true( $field, 'multiple' ) && self::is_field_type( $field, 'select' ) && $field_type !== 'hidden';
@@ -1243,104 +953,63 @@
1243 953 * Check if a field is read only. Read only can be set in the field options,
1244 954 * but disabled with the shortcode options
1245 955 *
1246 956 * @since 2.0.9
1247 - *
1248 - * @param array|object $field
1249 - * @return bool
1250 957 */
1251 958 public static function is_read_only( $field ) {
1252 959 global $frm_vars;
1253 - return self::is_option_true( $field, 'read_only' ) && ( ! isset( $frm_vars['readonly'] ) || $frm_vars['readonly'] !== 'disabled' );
960 +
961 + return ( self::is_option_true( $field, 'read_only' ) && ( ! isset( $frm_vars['readonly'] ) || $frm_vars['readonly'] != 'disabled' ) );
1254 962 }
1255 963
1256 964 /**
1257 965 * @since 2.0.9
1258 - *
1259 - * @param array $field
1260 - * @return bool
1261 966 */
1262 967 public static function is_required( $field ) {
1263 - $required = $field['required'] != '0';
968 + $required = ( $field['required'] != '0' );
969 + $required = apply_filters( 'frm_is_field_required', $required, $field );
1264 970
1265 - /**
1266 - * @param bool $required
1267 - * @param array $field
1268 - */
1269 - $required = (bool) apply_filters( 'frm_is_field_required', $required, $field );
1270 -
1271 971 return $required;
1272 972 }
1273 973
1274 974 /**
1275 975 * @since 2.0.9
1276 - *
1277 - * @param array|object $field
1278 - * @param string $option
1279 - * @return bool
1280 976 */
1281 977 public static function is_option_true( $field, $option ) {
1282 978 if ( is_array( $field ) ) {
1283 979 return self::is_option_true_in_array( $field, $option );
980 + } else {
981 + return self::is_option_true_in_object( $field, $option );
1284 982 }
1285 - return self::is_option_true_in_object( $field, $option );
1286 983 }
1287 984
1288 985 /**
1289 986 * @since 2.0.9
1290 - *
1291 - * @param array|object $field
1292 - * @param string $option
1293 - * @return bool
1294 987 */
1295 988 public static function is_option_empty( $field, $option ) {
1296 989 if ( is_array( $field ) ) {
1297 990 return self::is_option_empty_in_array( $field, $option );
991 + } else {
992 + return self::is_option_empty_in_object( $field, $option );
1298 993 }
1299 - return self::is_option_empty_in_object( $field, $option );
1300 994 }
1301 995
1302 - /**
1303 - * @param array $field
1304 - * @param string $option
1305 - * @return bool
1306 - */
1307 996 public static function is_option_true_in_array( $field, $option ) {
1308 - return ! empty( $field[ $option ] );
997 + return isset( $field[ $option ] ) && $field[ $option ];
1309 998 }
1310 999
1311 - /**
1312 - * @param object $field
1313 - * @param string $option
1314 - * @return bool
1315 - */
1316 1000 public static function is_option_true_in_object( $field, $option ) {
1317 1001 return isset( $field->field_options[ $option ] ) && $field->field_options[ $option ];
1318 1002 }
1319 1003
1320 - /**
1321 - * @param array $field
1322 - * @param string $option
1323 - * @return bool
1324 - */
1325 1004 public static function is_option_empty_in_array( $field, $option ) {
1326 - return empty( $field[ $option ] );
1005 + return ! isset( $field[ $option ] ) || empty( $field[ $option ] );
1327 1006 }
1328 1007
1329 - /**
1330 - * @param object $field
1331 - * @param string $option
1332 - * @return bool
1333 - */
1334 1008 public static function is_option_empty_in_object( $field, $option ) {
1335 - return empty( $field->field_options[ $option ] );
1009 + return ! isset( $field->field_options[ $option ] ) || empty( $field->field_options[ $option ] );
1336 1010 }
1337 1011
1338 - /**
1339 - * @param stdClass $field
1340 - * @param string $option
1341 - * @return bool
1342 - */
1343 1012 public static function is_option_value_in_object( $field, $option ) {
1344 1013 return isset( $field->field_options[ $option ] ) && $field->field_options[ $option ] != '';
1345 1014 }
1346 1015
@@ -1345,12 +1014,8 @@
1345 1014 }
1346 1015
1347 1016 /**
1348 1017 * @since 2.0.18
1349 - *
1350 - * @param array|object $field
1351 - * @param string $option
1352 - * @return mixed
1353 1018 */
1354 1019 public static function get_option( $field, $option ) {
1355 1020 if ( is_array( $field ) ) {
1356 1021 $option = self::get_option_in_array( $field, $option );
@@ -1360,14 +1025,10 @@
1360 1025
1361 1026 return $option;
1362 1027 }
1363 1028
1364 - /**
1365 - * @param array $field
1366 - * @param string $option
1367 - * @return mixed
1368 - */
1369 1029 public static function get_option_in_array( $field, $option ) {
1030 +
1370 1031 if ( isset( $field[ $option ] ) ) {
1371 1032 $this_option = $field[ $option ];
1372 1033 } elseif ( isset( $field['field_options'] ) && is_array( $field['field_options'] ) && isset( $field['field_options'][ $option ] ) ) {
1373 1034 $this_option = $field['field_options'][ $option ];
@@ -1377,31 +1038,23 @@
1377 1038
1378 1039 return $this_option;
1379 1040 }
1380 1041
1381 - /**
1382 - * @param object $field
1383 - * @param string $option
1384 - * @return mixed
1385 - */
1386 1042 public static function get_option_in_object( $field, $option ) {
1387 - return $field->field_options[ $option ] ?? '';
1043 + return isset( $field->field_options[ $option ] ) ? $field->field_options[ $option ] : '';
1388 1044 }
1389 1045
1390 1046 /**
1391 1047 * @since 2.0.09
1392 - *
1393 - * @param array|object $field
1394 - * @return bool
1395 1048 */
1396 1049 public static function is_repeating_field( $field ) {
1397 1050 if ( is_array( $field ) ) {
1398 - $is_repeating_field = ( 'divider' === $field['type'] );
1051 + $is_repeating_field = ( 'divider' == $field['type'] );
1399 1052 } else {
1400 - $is_repeating_field = ( 'divider' === $field->type );
1053 + $is_repeating_field = ( 'divider' == $field->type );
1401 1054 }
1402 1055
1403 - return $is_repeating_field && self::is_option_true( $field, 'repeat' );
1056 + return ( $is_repeating_field && self::is_option_true( $field, 'repeat' ) );
1404 1057 }
1405 1058
1406 1059 /**
1407 1060 * @param string $key
@@ -1416,9 +1069,9 @@
1416 1069
1417 1070 /**
1418 1071 * @param string $id
1419 1072 *
1420 - * @return string|null
1073 + * @return string
1421 1074 */
1422 1075 public static function get_key_by_id( $id ) {
1423 1076 return FrmDb::get_var( 'frm_fields', array( 'id' => $id ), 'field_key' );
1424 1077 }
@@ -1425,9 +1078,9 @@
1425 1078
1426 1079 public static function is_image( $field ) {
1427 1080 $type = self::get_field_type( $field );
1428 1081
1429 - return ( $type === 'url' && self::get_option( $field, 'show_image' ) );
1082 + return ( $type == 'url' && self::get_option( $field, 'show_image' ) );
1430 1083 }
1431 1084
1432 1085 /**
1433 1086 * Check if field is radio or Dynamic radio
@@ -1435,9 +1088,9 @@
1435 1088 * @since 3.0
1436 1089 *
1437 1090 * @param array|object $field
1438 1091 *
1439 - * @return bool true if field type is radio or Dynamic radio
1092 + * @return boolean true if field type is radio or Dynamic radio
1440 1093 */
1441 1094 public static function is_radio( $field ) {
1442 1095 return self::is_field_type( $field, 'radio' );
1443 1096 }
@@ -1448,9 +1101,9 @@
1448 1101 * @since 3.0
1449 1102 *
1450 1103 * @param array|object $field
1451 1104 *
1452 - * @return bool true if field type is checkbox or Dynamic checkbox
1105 + * @return boolean true if field type is checkbox or Dynamic checkbox
1453 1106 */
1454 1107 public static function is_checkbox( $field ) {
1455 1108 return self::is_field_type( $field, 'checkbox' );
1456 1109 }
@@ -1460,11 +1113,11 @@
1460 1113 *
1461 1114 * @since 3.0
1462 1115 *
1463 1116 * @param array|object $field
1464 - * @param string $is_type Options include radio, checkbox, text.
1117 + * @param string $is_type Options include radio, checkbox, text
1465 1118 *
1466 - * @return bool true if field type is checkbox or Dynamic checkbox
1119 + * @return boolean true if field type is checkbox or Dynamic checkbox
1467 1120 */
1468 1121 public static function is_field_type( $field, $is_type ) {
1469 1122 $field_type = self::get_original_field_type( $field );
1470 1123 $data_type = self::get_option( $field, 'data_type' );