PluginProbe
Formidable Forms – WordPress Form Builder for Contact Forms, Calculators, Quizzes & More / 5.0.10
Formidable Forms – WordPress Form Builder for Contact Forms, Calculators, Quizzes & More v5.0.10
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/controllers/FrmAddonsController.php +500 -801 6.285.0.10 View file →
@@ -4,98 +4,8 @@
4 4 }
5 5
6 6 class FrmAddonsController {
7 7
8 - /**
9 - * @var string
10 - */
11 - const SCRIPT_HANDLE = 'frm-addons-page';
12 -
13 - /**
14 - * @var array
15 - */
16 - private static $categories = array();
17 -
18 - /**
19 - * @var string
20 - */
21 - private static $request_addon_url;
22 -
23 - /**
24 - * @var string
25 - */
26 - protected static $plugin;
27 -
28 - /**
29 - * @since 6.15
30 - *
31 - * @return void
32 - */
33 - public static function load_admin_hooks() {
34 - add_action( 'admin_menu', self::class . '::menu', 100 );
35 - add_filter( 'pre_set_site_transient_update_plugins', self::class . '::check_update' );
36 -
37 - if ( ! FrmAppHelper::is_admin_page( 'formidable-addons' ) ) {
38 - return;
39 - }
40 -
41 - self::$request_addon_url = 'https://connect.formidableforms.com/add-on-request/';
42 -
43 - add_action( 'admin_enqueue_scripts', self::class . '::enqueue_assets', 15 );
44 - add_filter( 'frm_show_footer_links', '__return_false' );
45 - }
46 -
47 - /**
48 - * Enqueues the Add-Ons page scripts and styles.
49 - *
50 - * @since 6.15
51 - *
52 - * @return void
53 - */
54 - public static function enqueue_assets() {
55 - $plugin_url = FrmAppHelper::plugin_url();
56 - $version = FrmAppHelper::plugin_version();
57 - $js_dependencies = array(
58 - 'wp-i18n',
59 - // This prevents a console error "wp.hooks is undefined" in WP versions older than 5.7.
60 - 'wp-hooks',
61 - 'formidable_dom',
62 - );
63 -
64 - // Enqueue styles that needed.
65 - wp_enqueue_style( 'formidable-admin' );
66 - wp_enqueue_style( 'formidable-grids' );
67 -
68 - // Register and enqueue Add-Ons page style.
69 - wp_register_style( self::SCRIPT_HANDLE, $plugin_url . '/css/admin/addons-page.css', array(), $version );
70 - wp_enqueue_style( self::SCRIPT_HANDLE );
71 -
72 - // Register and enqueue Add-Ons page script.
73 - wp_register_script( self::SCRIPT_HANDLE, $plugin_url . '/js/addons-page.js', $js_dependencies, $version, true );
74 - wp_localize_script( self::SCRIPT_HANDLE, 'frmAddonsVars', self::get_js_variables() );
75 - wp_enqueue_script( self::SCRIPT_HANDLE );
76 - wp_set_script_translations( self::SCRIPT_HANDLE, 'formidable' );
77 -
78 - FrmAppHelper::dequeue_extra_global_scripts();
79 - }
80 -
81 - /**
82 - * Get the Add-Ons page JS variables as an array.
83 - *
84 - * @since 6.15
85 - *
86 - * @return array
87 - */
88 - private static function get_js_variables() {
89 - return array(
90 - 'proIsIncluded' => FrmAppHelper::pro_is_included(),
91 - 'addonRequestURL' => self::$request_addon_url,
92 - );
93 - }
94 -
95 - /**
96 - * @return void
97 - */
98 8 public static function menu() {
99 9 if ( ! current_user_can( 'activate_plugins' ) ) {
100 10 return;
101 11 }
@@ -100,67 +10,49 @@
100 10 return;
101 11 }
102 12
103 13 $label = __( 'Add-Ons', 'formidable' );
104 - $label = '<span style="color:#3FCA89">' . esc_html( $label ) . '</span>';
14 + $label = '<span style="color:#fe5a1d">' . $label . '</span>';
105 15
106 16 add_submenu_page( 'formidable', 'Formidable | ' . __( 'Add-Ons', 'formidable' ), $label, 'frm_view_forms', 'formidable-addons', 'FrmAddonsController::list_addons' );
107 17
108 - // Remove default created subpage, make the page with highest priority as default.
109 - remove_submenu_page( 'formidable', 'formidable' );
110 -
111 18 if ( ! FrmAppHelper::pro_is_installed() ) {
112 - $cta_text = FrmSalesApi::get_best_sale_value( 'menu_cta_text' );
113 -
114 - if ( ! $cta_text ) {
115 - $cta_text = __( 'Upgrade', 'formidable' );
116 - }
117 -
118 19 add_submenu_page(
119 20 'formidable',
120 21 'Formidable | ' . __( 'Upgrade', 'formidable' ),
121 - '<span class="frm-upgrade-submenu">' . esc_html( $cta_text ) . '</span>',
22 + '<span class="frm-upgrade-submenu">' . __( 'Upgrade', 'formidable' ) . '</span>',
122 23 'frm_view_forms',
123 24 'formidable-pro-upgrade',
124 - function () {
125 - // This function doesn't need to do anything.
126 - // The redirect is handled earlier to avoid issues with the headers being sent.
127 - }
25 + 'FrmAddonsController::upgrade_to_pro'
128 26 );
129 27 } elseif ( 'formidable-pro-upgrade' === FrmAppHelper::get_param( 'page' ) ) {
130 28 wp_safe_redirect( admin_url( 'admin.php?page=formidable' ) );
131 29 exit;
132 - }//end if
30 + }
133 31 }
134 32
135 - /**
136 - * @return void
137 - */
138 33 public static function list_addons() {
139 34 FrmAppHelper::include_svg();
35 + $installed_addons = apply_filters( 'frm_installed_addons', array() );
36 + $license_type = '';
140 37
141 - $view_path = FrmAppHelper::plugin_path() . '/classes/views/addons/';
142 - $installed_addons = apply_filters( 'frm_installed_addons', array() );
143 - $addons = self::get_api_addons();
144 - $errors = array();
145 - $license_type = '';
146 - $request_addon_url = self::$request_addon_url;
38 + $addons = self::get_api_addons();
39 + $errors = array();
147 40
148 41 if ( isset( $addons['error'] ) ) {
149 - $api = new FrmFormApi();
150 - $errors = $api->get_error_from_response( $addons );
151 - $license_type = $addons['error']['type'] ?? '';
42 + $api = new FrmFormApi();
43 + $errors = $api->get_error_from_response( $addons );
44 + $license_type = isset( $addons['error']['type'] ) ? $addons['error']['type'] : '';
152 45 unset( $addons['error'] );
153 46 }
154 47
155 - $pro = array(
48 + $pro = array(
156 49 'pro' => array(
157 - 'title' => 'Formidable Forms Pro',
158 - 'slug' => 'formidable-pro',
159 - 'released' => '2011-02-05',
160 - 'docs' => 'knowledgebase/',
161 - 'categories' => array( 'basic', 'plus', 'business', 'elite' ),
162 - 'excerpt' => 'Create calculators, surveys, smart forms, and data-driven applications. Build directories, real estate listings, job boards, and much more.',
50 + 'title' => 'Formidable Forms Pro',
51 + 'slug' => 'formidable-pro',
52 + 'released' => '2011-02-05',
53 + 'docs' => 'knowledgebase/',
54 + 'excerpt' => 'Create calculators, surveys, smart forms, and data-driven applications. Build directories, real estate listings, job boards, and much more.',
163 55 ),
164 56 );
165 57 $addons = $pro + $addons;
166 58 self::prepare_addons( $addons );
@@ -166,128 +58,29 @@
166 58 self::prepare_addons( $addons );
167 59
168 60 $pricing = FrmAppHelper::admin_upgrade_link( 'addons' );
169 61
170 - self::organize_and_get_categories();
171 - $categories = self::$categories;
172 -
173 - include $view_path . 'index.php';
62 + include( FrmAppHelper::plugin_path() . '/classes/views/addons/list.php' );
174 63 }
175 64
176 - /**
177 - * Organize and set categories.
178 - *
179 - * @since 6.15
180 - *
181 - * @return void
182 - */
183 - protected static function organize_and_get_categories() {
184 - unset( self::$categories['strategy11'] );
185 - ksort( self::$categories );
186 -
187 - $bottom_categories = array();
188 - $plans = FrmFormsHelper::get_license_types(
189 - array(
190 - 'include_all' => false,
191 - 'case_lower' => true,
192 - )
193 - );
194 -
195 - // Extract the elements to move
196 - foreach ( $plans as $plan ) {
197 - if ( isset( self::$categories[ $plan ] ) ) {
198 - $bottom_categories[ $plan ] = self::$categories[ $plan ];
199 - unset( self::$categories[ $plan ] );
200 - }
201 - }
202 -
203 - $special_categories = array();
204 -
205 - if ( 'elite' !== self::license_type() ) {
206 - $special_categories['available-addons'] = array(
207 - 'name' => __( 'Available', 'formidable' ),
208 - // To be assigned via JavaScript.
209 - 'count' => 0,
210 - );
211 - }
212 -
213 - $special_categories['active-addons'] = array(
214 - 'name' => __( 'Active', 'formidable' ),
215 - // To be assigned via JavaScript.
216 - 'count' => 0,
217 - );
218 -
219 - $special_categories['all-items'] = array(
220 - 'name' => __( 'All Add-Ons', 'formidable' ),
221 - // To be assigned via JavaScript.
222 - 'count' => 0,
223 - );
224 -
225 - self::$categories = array_merge(
226 - $special_categories,
227 - self::$categories,
228 - $bottom_categories
229 - );
230 - }
231 -
232 - /**
233 - * Organize and set categories.
234 - *
235 - * @since 6.15
236 - *
237 - * @param array $addon The addon array that will be modified by reference.
238 - *
239 - * @return void
240 - */
241 - protected static function set_categories( &$addon ) {
242 - if ( ! isset( $addon['categories'] ) ) {
243 - return;
244 - }
245 -
246 - $addon['category-slugs'] = array();
247 -
248 - foreach ( $addon['categories'] as $category ) {
249 - $category = FrmFormsHelper::convert_legacy_package_names( $category );
250 - $category_slug = sanitize_title( $category );
251 -
252 - // Add the slug to the new array.
253 - $addon['category-slugs'][] = $category_slug;
254 -
255 - if ( ! isset( self::$categories[ $category_slug ] ) ) {
256 - self::$categories[ $category_slug ] = array(
257 - 'name' => $category,
258 - 'count' => 0,
259 - );
260 - }
261 -
262 - ++self::$categories[ $category_slug ]['count'];
263 - }
264 - }
265 -
266 - /**
267 - * @return void
268 - */
269 65 public static function license_settings() {
270 66 $plugins = apply_filters( 'frm_installed_addons', array() );
67 + if ( empty( $plugins ) ) {
68 + esc_html_e( 'There are no plugins on your site that require a license', 'formidable' );
271 69
272 - if ( ! $plugins ) {
273 - esc_html_e( 'There are no plugins on your site that require a license', 'formidable' );
274 70 return;
275 71 }
276 72
277 73 ksort( $plugins );
278 74
279 - include FrmAppHelper::plugin_path() . '/classes/views/addons/settings.php';
75 + include( FrmAppHelper::plugin_path() . '/classes/views/addons/settings.php' );
280 76 }
281 77
282 - /**
283 - * @return array
284 - */
285 78 protected static function get_api_addons() {
286 79 $api = new FrmFormApi();
287 80 $addons = $api->get_api_info();
288 81
289 - if ( ! $addons ) {
82 + if ( empty( $addons ) ) {
290 83 $addons = self::fallback_plugin_list();
291 84 } else {
292 85 foreach ( $addons as $k => $addon ) {
293 86 if ( empty( $addon['excerpt'] ) && $k !== 'error' ) {
@@ -299,24 +92,11 @@
299 92 return $addons;
300 93 }
301 94
302 95 /**
303 - * Retrieves the count of available addons.
304 - *
305 - * @since 6.9
306 - *
307 - * @return int Count of addons.
308 - */
309 - public static function get_addons_count() {
310 - $addons = self::get_api_addons();
311 - return count( $addons );
312 - }
313 -
314 - /**
315 96 * If the API is unable to connect, show something on the addons page
316 97 *
317 98 * @since 3.04.03
318 - *
319 99 * @return array
320 100 */
321 101 protected static function fallback_plugin_list() {
322 102 $list = array(
@@ -326,20 +106,20 @@
326 106 'docs' => '',
327 107 'excerpt' => 'Enhance your basic Formidable forms with a plethora of Pro field types and features. Create advanced forms and data-driven applications in minutes.',
328 108 ),
329 109 'mailchimp' => array(
330 - 'title' => 'Mailchimp Forms',
331 - 'excerpt' => 'Get on the path to more sales and leads in a matter of minutes. Add leads to a Mailchimp mailing list when they submit forms and update their information along with the entry.', // phpcs:ignore SlevomatCodingStandard.Files.LineLength.LineTooLong
110 + 'title' => 'MailChimp Forms',
111 + 'excerpt' => 'Get on the path to more sales and leads in a matter of minutes. Add leads to a MailChimp mailing list when they submit forms and update their information along with the entry.',
332 112 ),
333 113 'registration' => array(
334 114 'title' => 'User Registration Forms',
335 115 'link' => 'downloads/user-registration/',
336 - 'excerpt' => 'Give new users access to your site as quickly and painlessly as possible. Allow users to register, edit and be able to login to their profiles on your site from the front end in a clean, customized registration form.', // phpcs:ignore SlevomatCodingStandard.Files.LineLength.LineTooLong
116 + 'excerpt' => 'Give new users access to your site as quickly and painlessly as possible. Allow users to register, edit and be able to login to their profiles on your site from the front end in a clean, customized registration form.',
337 117 ),
338 118 'paypal' => array(
339 119 'title' => 'PayPal Standard Forms',
340 120 'link' => 'downloads/paypal-standard/',
341 - 'excerpt' => 'Automate your business by collecting instant payments from your clients. Collect information, calculate a total, and send them on to PayPal. Require a payment before publishing content on your site.', // phpcs:ignore SlevomatCodingStandard.Files.LineLength.LineTooLong
121 + 'excerpt' => 'Automate your business by collecting instant payments from your clients. Collect information, calculate a total, and send them on to PayPal. Require a payment before publishing content on your site.',
342 122 ),
343 123 'stripe' => array(
344 124 'title' => 'Stripe Forms',
345 125 'docs' => 'knowledgebase/stripe/',
@@ -371,9 +151,9 @@
371 151 'excerpt' => 'Instantly add Bootstrap styling to all your Formidable forms.',
372 152 ),
373 153 'zapier' => array(
374 154 'title' => 'Zapier Forms',
375 - 'excerpt' => 'Connect with hundreds of different applications through Zapier. Insert a new row in a Google docs spreadsheet, post on Twitter, or add a new Dropbox file with your form.', // phpcs:ignore SlevomatCodingStandard.Files.LineLength.LineTooLong
155 + 'excerpt' => 'Connect with hundreds of different applications through Zapier. Insert a new row in a Google docs spreadsheet, post on Twitter, or add a new Dropbox file with your form.',
376 156 ),
377 157 'signature' => array(
378 158 'title' => 'Digital Signature Forms',
379 159 'excerpt' => 'Add a signature field to your form. The user may write their signature with a trackpad/mouse or just type it.',
@@ -391,13 +171,8 @@
391 171 'views' => array(
392 172 'title' => 'Formidable Views',
393 173 'excerpt' => 'Add the power of views to your Formidable Forms to display your form submissions in listings, tables, calendars, and more.',
394 174 ),
395 - 'quiz_maker' => array(
396 - 'title' => 'Quiz Maker',
397 - 'link' => 'downloads/quiz-maker/',
398 - 'excerpt' => 'Make quizzes, automatically score them and show user scores.',
399 - ),
400 175 );
401 176
402 177 $defaults = array(
403 178 'released' => '',
@@ -406,9 +181,8 @@
406 181 foreach ( $list as $k => $info ) {
407 182 $info['slug'] = $k;
408 183 $list[ $k ] = array_merge( $defaults, $info );
409 184 }
410 -
411 185 return $list;
412 186 }
413 187
414 188 /**
@@ -414,9 +188,8 @@
414 188 /**
415 189 * If Pro is missing but has been authenticated, include a download URL
416 190 *
417 191 * @since 3.04.03
418 - *
419 192 * @return string
420 193 */
421 194 public static function get_pro_download_url() {
422 195 $license = self::get_pro_license();
@@ -423,20 +196,17 @@
423 196 $api = new FrmFormApi( $license );
424 197 $downloads = $api->get_api_info();
425 198 $pro = self::get_pro_from_addons( $downloads );
426 199
427 - return $pro['url'] ?? '';
200 + return isset( $pro['url'] ) ? $pro['url'] : '';
428 201 }
429 202
430 203 /**
431 204 * @since 4.08
432 - *
433 - * @return string
434 205 */
435 206 public static function get_pro_license() {
436 207 $pro_cred_store = 'frmpro-credentials';
437 208 $pro_wpmu_store = 'frmpro-wpmu-sitewide';
438 -
439 209 if ( is_multisite() && get_site_option( $pro_wpmu_store ) ) {
440 210 $creds = get_site_option( $pro_cred_store );
441 211 } else {
442 212 $creds = get_option( $pro_cred_store );
@@ -446,36 +216,28 @@
446 216 return '';
447 217 }
448 218
449 219 $license = $creds['license'];
450 -
451 - if ( ! $license ) {
220 + if ( empty( $license ) ) {
452 221 return '';
453 222 }
454 223
455 - if ( str_contains( $license, '-' ) ) {
456 - // This is a fix for licenses saved in the past
457 - return strtoupper( $license );
224 + if ( strpos( $license, '-' ) ) {
225 + // this is a fix for licenses saved in the past
226 + $license = strtoupper( $license );
458 227 }
459 -
460 228 return $license;
461 229 }
462 230
463 231 /**
464 232 * @since 4.08
465 - *
466 - * @param array $addons
467 - *
468 - * @return array
469 233 */
470 234 protected static function get_pro_from_addons( $addons ) {
471 - return $addons['93790'] ?? array();
235 + return isset( $addons['93790'] ) ? $addons['93790'] : array();
472 236 }
473 237
474 238 /**
475 239 * @since 4.06
476 - *
477 - * @return string
478 240 */
479 241 public static function license_type() {
480 242 if ( is_callable( 'FrmProAddonsController::license_type' ) ) {
481 243 return FrmProAddonsController::license_type();
@@ -485,47 +247,39 @@
485 247 }
486 248
487 249 /**
488 250 * @since 4.0.01
489 - *
490 - * @return bool
491 251 */
492 252 public static function is_license_expired() {
493 253 $version_info = self::get_primary_license_info();
494 -
495 254 if ( ! isset( $version_info['error'] ) ) {
496 255 return false;
497 256 }
498 257
499 - $expires = $version_info['error']['expires'] ?? 0;
258 + return $version_info['error'];
259 + }
500 260
501 - if ( ! $expires || $expires > time() ) {
502 - return false;
261 + /**
262 + * @since 4.08
263 + *
264 + * @return boolean|int false or the number of days until expiration.
265 + */
266 + public static function is_license_expiring() {
267 + if ( is_callable( 'FrmProAddonsController::is_license_expiring' ) ) {
268 + return FrmProAddonsController::is_license_expiring();
503 269 }
504 270
505 - $rate_limited = ! empty( $version_info['response_code'] ) && 429 === (int) $version_info['response_code'];
506 -
507 - if ( $rate_limited ) {
508 - // Do not return false positives for rate limited responses.
509 - return false;
510 - }
511 -
512 - return $version_info['error'];
271 + return false;
513 272 }
514 273
515 274 /**
516 275 * @since 4.08
517 - * @since 6.7 This is public.
518 - *
519 - * @return array|false
520 276 */
521 - public static function get_primary_license_info() {
277 + protected static function get_primary_license_info() {
522 278 $installed_addons = apply_filters( 'frm_installed_addons', array() );
523 -
524 - if ( ! $installed_addons || ! isset( $installed_addons['formidable_pro'] ) ) {
279 + if ( empty( $installed_addons ) || ! isset( $installed_addons['formidable_pro'] ) ) {
525 280 return false;
526 281 }
527 -
528 282 $installed_addons = array(
529 283 'formidable_pro' => $installed_addons['formidable_pro'],
530 284 );
531 285
@@ -533,12 +287,8 @@
533 287 }
534 288
535 289 /**
536 290 * @since 3.04.03
537 - *
538 - * @param mixed $transient
539 - *
540 - * @return object
541 291 */
542 292 public static function check_update( $transient ) {
543 293 if ( ! FrmAppHelper::pro_is_installed() ) {
544 294 // Don't make any changes if only Lite is installed.
@@ -549,18 +299,22 @@
549 299 $transient = new stdClass();
550 300 }
551 301
552 302 $installed_addons = apply_filters( 'frm_installed_addons', array() );
553 -
554 - if ( ! $installed_addons ) {
303 + if ( empty( $installed_addons ) ) {
555 304 return $transient;
556 305 }
557 306
558 - $version_info = self::fill_update_addon_info( $installed_addons );
307 + $version_info = self::fill_update_addon_info( $installed_addons );
308 +
559 309 $transient->last_checked = time();
560 - $wp_plugins = self::get_plugins();
561 310
562 - foreach ( $version_info as $plugin ) {
311 + if ( ! function_exists( 'get_plugins' ) ) {
312 + require_once ABSPATH . 'wp-admin/includes/plugin.php';
313 + }
314 + $wp_plugins = get_plugins();
315 +
316 + foreach ( $version_info as $id => $plugin ) {
563 317 $plugin = (object) $plugin;
564 318
565 319 if ( ! isset( $plugin->new_version ) || ! isset( $plugin->package ) ) {
566 320 continue;
@@ -566,61 +320,49 @@
566 320 continue;
567 321 }
568 322
569 323 $folder = $plugin->plugin;
570 -
571 - if ( ! $folder ) {
324 + if ( empty( $folder ) ) {
572 325 continue;
573 326 }
574 327
575 328 if ( ! self::is_installed( $folder ) ) {
576 - // Don't show an update if the plugin isn't installed
329 + // don't show an update if the plugin isn't installed
577 330 continue;
578 331 }
579 332
580 - $wp_plugin = $wp_plugins[ $folder ] ?? array();
581 - $wp_version = $wp_plugin['Version'] ?? '1.0';
582 - $plugin->slug = explode( '/', $folder )[0];
333 + $wp_plugin = isset( $wp_plugins[ $folder ] ) ? $wp_plugins[ $folder ] : array();
334 + $wp_version = isset( $wp_plugin['Version'] ) ? $wp_plugin['Version'] : '1.0';
583 335
584 336 if ( version_compare( $wp_version, $plugin->new_version, '<' ) ) {
337 + $slug = explode( '/', $folder );
338 + $plugin->slug = $slug[0];
585 339 $transient->response[ $folder ] = $plugin;
586 - } else {
587 - $transient->no_update[ $folder ] = $plugin;
588 340 }
589 341
590 342 $transient->checked[ $folder ] = $wp_version;
591 - }//end foreach
592 343
344 + }
345 +
593 346 return $transient;
594 347 }
595 348
596 349 /**
597 - * Copy of FrmAppHelper::get_plugins.
598 - * Because this gets called on "pre_set_site_transient_update_plugins" an old version of FrmAppHelper may be loaded on plugin update.
599 - * This means that trying to access FrmAppHelper::get_plugins when upgrading from a Lite version before v5.5 results in a one-off error.
600 - *
601 - * @since 5.5.2
602 - *
603 - * @return array
604 - */
605 - protected static function get_plugins() {
606 - if ( ! function_exists( 'get_plugins' ) ) {
607 - require_once ABSPATH . 'wp-admin/includes/plugin.php';
608 - }
609 - return get_plugins();
610 - }
611 -
612 - /**
613 350 * Check if a plugin is installed before showing an update for it
614 351 *
615 352 * @since 3.05
616 353 *
617 - * @param string $plugin The folder/filename.php for a plugin.
354 + * @param string $plugin - the folder/filename.php for a plugin
618 355 *
619 356 * @return bool - True if installed
620 357 */
621 358 protected static function is_installed( $plugin ) {
622 - $all_plugins = self::get_plugins();
359 + if ( ! function_exists( 'get_plugins' ) ) {
360 + require_once ABSPATH . 'wp-admin/includes/plugin.php';
361 + }
362 +
363 + $all_plugins = get_plugins();
364 +
623 365 return isset( $all_plugins[ $plugin ] );
624 366 }
625 367
626 368 /**
@@ -635,51 +377,45 @@
635 377 $version_info = array();
636 378
637 379 foreach ( $installed_addons as $addon ) {
638 380 if ( $addon->store_url !== 'https://formidableforms.com' ) {
639 - // Check if this is a third-party addon
381 + // check if this is a third-party addon
640 382 continue;
641 383 }
642 384
643 385 $new_license = $addon->license;
644 -
645 - if ( ! $new_license || in_array( $new_license, $checked_licenses, true ) ) {
386 + if ( empty( $new_license ) || in_array( $new_license, $checked_licenses ) ) {
646 387 continue;
647 388 }
648 389
649 390 $checked_licenses[] = $new_license;
650 - $api = new FrmFormApi( $new_license );
651 391
652 - if ( ! $version_info ) {
392 + $api = new FrmFormApi( $new_license );
393 + if ( empty( $version_info ) ) {
653 394 $version_info = $api->get_api_info();
654 395 continue;
655 396 }
656 397
657 398 $plugin = $api->get_addon_for_license( $addon, $version_info );
658 -
659 - if ( ! $plugin ) {
399 + if ( empty( $plugin ) ) {
660 400 continue;
661 401 }
662 402
663 - $download_id = $plugin['id'] ?? 0;
403 + $download_id = isset( $plugin['id'] ) ? $plugin['id'] : 0;
404 + if ( ! empty( $download_id ) && ! isset( $version_info[ $download_id ]['package'] ) ) {
405 + // if this addon is using its own license, get the update url
406 + $addon_info = $api->get_api_info();
664 407
665 - if ( ! $download_id || isset( $version_info[ $download_id ]['package'] ) ) {
666 - continue;
408 + $version_info[ $download_id ] = $addon_info[ $download_id ];
409 + if ( isset( $addon_info['error'] ) ) {
410 + $version_info[ $download_id ]['error'] = array(
411 + 'message' => $addon_info['error']['message'],
412 + 'code' => $addon_info['error']['code'],
413 + );
414 + }
667 415 }
416 + }
668 417
669 - // If this addon is using its own license, get the update url
670 - $addon_info = $api->get_api_info();
671 -
672 - $version_info[ $download_id ] = $addon_info[ $download_id ];
673 -
674 - if ( isset( $addon_info['error'] ) ) {
675 - $version_info[ $download_id ]['error'] = array(
676 - 'message' => $addon_info['error']['message'],
677 - 'code' => $addon_info['error']['code'],
678 - );
679 - }
680 - }//end foreach
681 -
682 418 return $version_info;
683 419 }
684 420
685 421 /**
@@ -685,11 +421,9 @@
685 421 /**
686 422 * Get the action link for an addon that isn't active.
687 423 *
688 424 * @since 3.06.03
689 - *
690 - * @param string $plugin The plugin slug.
691 - *
425 + * @param string $plugin The plugin slug
692 426 * @return array
693 427 */
694 428 public static function install_link( $plugin ) {
695 429 $link = array();
@@ -700,28 +434,23 @@
700 434 $link = array(
701 435 'url' => $addon['plugin'],
702 436 'class' => 'frm-activate-addon',
703 437 );
704 - } elseif ( ! empty( $addon['url'] ) ) {
438 + } elseif ( isset( $addon['url'] ) && ! empty( $addon['url'] ) ) {
705 439 $link = array(
706 440 'url' => $addon['url'],
707 441 'class' => 'frm-install-addon',
708 442 );
709 - } elseif ( ! empty( $addon['categories'] ) ) {
443 + } elseif ( isset( $addon['categories'] ) && ! empty( $addon['categories'] ) ) {
710 444 $link = array(
711 445 'categories' => $addon['categories'],
712 446 );
713 447 }
714 448
715 - if ( $link ) {
449 + if ( ! empty( $link ) ) {
716 450 $link['status'] = $addon['status']['type'];
717 451 }
718 - } elseif ( current_user_can( 'activate_plugins' ) && self::is_installed( 'formidable-' . $plugin . '/formidable-' . $plugin . '.php' ) ) {
719 - $link = array(
720 - 'url' => 'formidable-' . $plugin . '/formidable-' . $plugin . '.php',
721 - 'class' => 'frm-activate-addon',
722 - );
723 - }//end if
452 + }
724 453
725 454 return $link;
726 455 }
727 456
@@ -726,41 +455,33 @@
726 455 }
727 456
728 457 /**
729 458 * @since 4.09
730 - *
731 - * @param string $plugin The plugin slug.
732 - *
459 + * @param string $plugin The plugin slug
733 460 * @return array|false
734 461 */
735 - public static function get_addon( $plugin ) {
462 + protected static function get_addon( $plugin ) {
736 463 $addons = self::get_api_addons();
737 464 self::prepare_addons( $addons );
738 -
739 465 foreach ( $addons as $addon ) {
740 466 $slug = explode( '/', $addon['plugin'] );
741 -
742 467 if ( $slug[0] === 'formidable-' . $plugin ) {
743 468 return $addon;
744 469 }
745 470 }
746 -
747 471 return false;
748 472 }
749 473
750 474 /**
751 475 * @since 4.09
752 - *
753 476 * @return string
754 477 */
755 478 protected static function get_license_type() {
756 479 $license_type = '';
757 480 $addons = self::get_api_addons();
758 -
759 481 if ( isset( $addons['error'] ) && isset( $addons['error']['type'] ) ) {
760 - return $addons['error']['type'];
482 + $license_type = $addons['error']['type'];
761 483 }
762 -
763 484 return $license_type;
764 485 }
765 486
766 487 /**
@@ -765,10 +486,10 @@
765 486
766 487 /**
767 488 * @since 3.04.03
768 489 *
769 - * @param array $addons
770 - * @param object $license The FrmAddon object.
490 + * @param array $addons
491 + * @param object $license The FrmAddon object
771 492 *
772 493 * @return array
773 494 */
774 495 public static function get_addon_for_license( $addons, $license ) {
@@ -773,12 +494,11 @@
773 494 */
774 495 public static function get_addon_for_license( $addons, $license ) {
775 496 $download_id = $license->download_id;
776 497 $plugin = array();
777 -
778 - if ( ! $download_id && $addons ) {
498 + if ( empty( $download_id ) && ! empty( $addons ) ) {
779 499 foreach ( $addons as $addon ) {
780 - if ( 0 === strcasecmp( $license->plugin_name, $addon['title'] ) ) {
500 + if ( strtolower( $license->plugin_name ) == strtolower( $addon['title'] ) ) {
781 501 return $addon;
782 502 }
783 503 }
784 504 } elseif ( isset( $addons[ $download_id ] ) ) {
@@ -787,34 +507,27 @@
787 507
788 508 return $plugin;
789 509 }
790 510
791 - /**
792 - * @param array $addons
793 - *
794 - * @return void
795 - */
796 511 protected static function prepare_addons( &$addons ) {
797 - // Reset categories to prevent count accumulation across multiple calls.
798 - self::$categories = array();
799 -
800 512 $activate_url = '';
801 -
802 513 if ( current_user_can( 'activate_plugins' ) ) {
803 514 $activate_url = add_query_arg( array( 'action' => 'activate' ), admin_url( 'plugins.php' ) );
804 515 }
805 516
806 517 $loop_addons = $addons;
807 -
808 518 foreach ( $loop_addons as $id => $addon ) {
809 519 if ( is_numeric( $id ) ) {
810 520 $slug = str_replace( array( '-wordpress-plugin', '-wordpress' ), '', $addon['slug'] );
811 521 $file_name = $addon['plugin'];
812 522 } else {
813 - $slug = $id;
814 - $base_file = $addon['file'] ?? 'formidable-' . $slug;
523 + $slug = $id;
524 + if ( isset( $addon['file'] ) ) {
525 + $base_file = $addon['file'];
526 + } else {
527 + $base_file = 'formidable-' . $slug;
528 + }
815 529 $file_name = $base_file . '/' . $base_file . '.php';
816 -
817 530 if ( ! isset( $addon['plugin'] ) ) {
818 531 $addon['plugin'] = $file_name;
819 532 }
820 533 }
@@ -819,12 +532,10 @@
819 532 }
820 533 }
821 534
822 535 $addon['installed'] = self::is_installed( $file_name );
823 -
824 536 if ( $addon['installed'] && 'formidable-views/formidable-views.php' === $file_name ) {
825 537 $active_views_version = self::get_active_views_version();
826 -
827 538 if ( false !== $active_views_version && $slug !== $active_views_version ) {
828 539 $addon['installed'] = false;
829 540 }
830 541 }
@@ -830,9 +541,9 @@
830 541 }
831 542
832 543 $addon['activate_url'] = '';
833 544
834 - if ( $addon['installed'] && $activate_url && ! self::is_plugin_active( $file_name, $slug ) ) {
545 + if ( $addon['installed'] && ! empty( $activate_url ) && ! self::is_plugin_active( $file_name, $slug ) ) {
835 546 $addon['activate_url'] = add_query_arg(
836 547 array(
837 548 '_wpnonce' => wp_create_nonce( 'activate-plugin_' . $file_name ),
838 549 'plugin' => $file_name,
@@ -848,23 +559,15 @@
848 559
849 560 if ( ! isset( $addon['link'] ) ) {
850 561 $addon['link'] = 'downloads/' . $slug . '/';
851 562 }
563 + self::prepare_addon_link( $addon['link'] );
852 564
853 - self::prepare_addon_link( $addon['link'] );
854 565 self::set_addon_status( $addon );
855 - self::set_categories( $addon );
856 -
857 566 $addons[ $id ] = $addon;
858 - }//end foreach
567 + }
859 568 }
860 569
861 - /**
862 - * @param string $file_name
863 - * @param string $slug
864 - *
865 - * @return bool
866 - */
867 570 private static function is_plugin_active( $file_name, $slug ) {
868 571 if ( 'formidable-views/formidable-views.php' === $file_name ) {
869 572 return self::get_active_views_version() === $slug;
870 573 }
@@ -871,15 +574,14 @@
871 574 return is_plugin_active( $file_name );
872 575 }
873 576
874 577 /**
875 - * @return false|string either 'visual-views' or 'views', false if one is not found.
578 + * @return string|false either 'visual-views' or 'views', false if one is not found.
876 579 */
877 580 private static function get_active_views_version() {
878 581 if ( ! is_callable( 'FrmViewsAppHelper::plugin_version' ) ) {
879 582 return false;
880 583 }
881 -
882 584 $plugin_version = FrmViewsAppHelper::plugin_version();
883 585 return version_compare( $plugin_version, '5.0', '>=' ) ? 'visual-views' : 'views';
884 586 }
885 587
@@ -884,26 +586,21 @@
884 586 }
885 587
886 588 /**
887 589 * @since 3.04.02
888 - *
889 - * @param string $link
890 - *
891 - * @return void
892 590 */
893 591 protected static function prepare_addon_link( &$link ) {
894 592 $site_url = 'https://formidableforms.com/';
895 -
896 - if ( ! str_starts_with( $link, 'http' ) ) {
593 + if ( strpos( $link, 'http' ) !== 0 ) {
897 594 $link = $site_url . $link;
898 595 }
899 -
900 - $link = FrmAppHelper::make_affiliate_url( $link );
901 -
902 - $utm = array(
903 - 'campaign' => 'addons',
596 + $link = FrmAppHelper::make_affiliate_url( $link );
597 + $query_args = array(
598 + 'utm_source' => 'WordPress',
599 + 'utm_medium' => 'addons',
600 + 'utm_campaign' => 'liteplugin',
904 601 );
905 - $link = FrmAppHelper::maybe_add_missing_utm( $link, $utm );
602 + $link = add_query_arg( $query_args, $link );
906 603 }
907 604
908 605 /**
909 606 * Add the status to the addon array. Status options are:
@@ -909,12 +606,8 @@
909 606 * Add the status to the addon array. Status options are:
910 607 * installed, active, not installed
911 608 *
912 609 * @since 3.04.02
913 - *
914 - * @param array $addon
915 - *
916 - * @return void
917 610 */
918 611 protected static function set_addon_status( &$addon ) {
919 612 if ( ! empty( $addon['activate_url'] ) ) {
920 613 $addon['status'] = array(
@@ -933,110 +626,273 @@
933 626 );
934 627 }
935 628 }
936 629
937 - /**
938 - * @since 5.5.2
939 - *
940 - * @param string $plugin
941 - * @param string $redirect
942 - * @param bool $network_wide
943 - * @param bool $silent
944 - *
945 - * @return WP_Error|null Null on success, WP_Error on invalid file.
946 - */
947 - protected static function activate_plugin( $plugin, $redirect = '', $network_wide = false, $silent = false ) {
948 - if ( ! function_exists( 'activate_plugin' ) ) {
949 - require_once ABSPATH . 'wp-admin/includes/plugin.php';
950 - }
951 - return activate_plugin( $plugin, $redirect, $network_wide, $silent );
952 - }
630 + public static function upgrade_to_pro() {
631 + FrmAppHelper::include_svg();
953 632
954 - /**
955 - * Deactivate a specified plugin.
956 - *
957 - * @since 6.8
958 - *
959 - * @param string $plugin
960 - * @param bool $silent
961 - *
962 - * @return void
963 - */
964 - protected static function deactivate_plugin( $plugin, $silent = false ) {
965 - if ( ! function_exists( 'deactivate_plugins' ) ) {
966 - require_once ABSPATH . 'wp-admin/includes/plugin.php';
967 - }
968 - deactivate_plugins( $plugin, $silent );
633 + $link_parts = array(
634 + 'medium' => 'upgrade',
635 + 'content' => 'button',
636 + );
637 +
638 + $features = array(
639 + 'Display Entries' => array(
640 + array(
641 + 'label' => 'Display form data with virtually limitless views',
642 + 'link' => array(
643 + 'content' => 'views',
644 + 'param' => 'views-display-form-data',
645 + ),
646 + 'lite' => false,
647 + ),
648 + array(
649 + 'label' => 'Generate graphs and stats based on your submitted data',
650 + 'link' => array(
651 + 'content' => 'graphs',
652 + 'param' => 'statistics-graphs-wordpress-forms',
653 + ),
654 + 'lite' => false,
655 + ),
656 + ),
657 + 'Entry Management' => array(
658 + array(
659 + 'label' => 'Import entries from a CSV',
660 + 'link' => array(
661 + 'content' => 'import-entries',
662 + 'param' => 'importing-exporting-wordpress-forms',
663 + ),
664 + 'lite' => false,
665 + ),
666 + array(
667 + 'label' => 'Logged-in users can save drafts and return later',
668 + 'link' => array(
669 + 'content' => 'save-drafts',
670 + 'param' => 'save-drafts-wordpress-form',
671 + ),
672 + 'lite' => false,
673 + ),
674 + array(
675 + 'label' => 'Flexibly and powerfully view, edit, and delete entries from anywhere on your site',
676 + 'link' => array(
677 + 'content' => 'front-edit',
678 + 'param' => 'wordpress-front-end-editing',
679 + ),
680 + 'lite' => false,
681 + ),
682 + array(
683 + 'label' => 'View form submissions from the back-end',
684 + 'lite' => true,
685 + ),
686 + array(
687 + 'label' => 'Export your entries to a CSV',
688 + 'lite' => true,
689 + ),
690 + ),
691 + 'Form Building' => array(
692 + array(
693 + 'label' => 'Save a calculated value into a field',
694 + 'link' => array(
695 + 'content' => 'calculations',
696 + 'param' => 'field-calculations-wordpress-form',
697 + ),
698 + 'lite' => false,
699 + ),
700 + array(
701 + 'label' => 'Allow multiple file uploads',
702 + 'link' => array(
703 + 'content' => 'file-uploads',
704 + 'param' => 'wordpress-multi-file-upload-fields',
705 + ),
706 + 'lite' => false,
707 + ),
708 + array(
709 + 'label' => 'Repeat sections of fields',
710 + 'link' => array(
711 + 'content' => 'repeaters',
712 + 'param' => 'repeatable-sections-forms',
713 + ),
714 + 'lite' => false,
715 + ),
716 + array(
717 + 'label' => 'Hide and show fields conditionally based on other fields or the user\'s role',
718 + 'link' => array(
719 + 'content' => 'conditional-logic',
720 + 'param' => 'conditional-logic-wordpress-forms',
721 + ),
722 + 'lite' => false,
723 + ),
724 + array(
725 + 'label' => 'Confirmation fields',
726 + 'link' => array(
727 + 'content' => 'confirmation-fields',
728 + 'param' => 'confirmation-fields-wordpress-forms',
729 + ),
730 + 'lite' => false,
731 + ),
732 + array(
733 + 'label' => 'Multi-paged forms',
734 + 'link' => array(
735 + 'content' => 'page-breaks',
736 + 'param' => 'wordpress-multi-page-forms',
737 + ),
738 + 'lite' => false,
739 + ),
740 + array(
741 + 'label' => 'Include section headings, page breaks, rich text, dates, times, scales, star ratings, sliders, toggles, dynamic fields populated from other forms, passwords, and tags in advanced forms.',
742 + 'lite' => false,
743 + ),
744 + array(
745 + 'label' => 'Include text, email, url, paragraph text, radio, checkbox, dropdown fields, hidden fields, user ID fields, and HTML blocks in your form.',
746 + 'lite' => true,
747 + ),
748 + array(
749 + 'label' => 'Drag & Drop Form building',
750 + 'link' => array(
751 + 'content' => 'drag-drop',
752 + 'param' => 'drag-drop-forms',
753 + ),
754 + 'lite' => true,
755 + ),
756 + array(
757 + 'label' => 'Create forms from Templates',
758 + 'link' => array(
759 + 'content' => 'form-templates',
760 + 'param' => 'wordpress-form-templates',
761 + ),
762 + 'lite' => true,
763 + ),
764 + array(
765 + 'label' => 'Import and export forms with XML',
766 + 'link' => array(
767 + 'content' => 'import',
768 + 'param' => 'importing-exporting-wordpress-forms',
769 + ),
770 + 'lite' => true,
771 + ),
772 + array(
773 + 'label' => 'Use input placeholder text in your fields that clear when typing starts.',
774 + 'lite' => true,
775 + ),
776 + ),
777 + 'Form Actions' => array(
778 + array(
779 + 'label' => 'Conditionally send your email notifications based on values in your form',
780 + 'link' => array(
781 + 'content' => 'conditional-emails',
782 + ),
783 + 'lite' => false,
784 + ),
785 + array(
786 + 'label' => 'Create and edit WordPress posts or custom posts from the front-end',
787 + 'link' => array(
788 + 'content' => 'create-posts',
789 + 'param' => 'create-posts-pages-wordpress-forms',
790 + ),
791 + 'lite' => false,
792 + ),
793 + array(
794 + 'label' => 'Send multiple emails and autoresponders',
795 + 'link' => array(
796 + 'content' => 'multiple-emails',
797 + 'param' => 'virtually-unlimited-emails',
798 + ),
799 + 'lite' => true,
800 + ),
801 + ),
802 + 'Form Appearance' => array(
803 + array(
804 + 'label' => 'Create Multiple styles for different forms',
805 + 'link' => array(
806 + 'content' => 'multiple-styles',
807 + 'param' => 'wordpress-visual-form-styler',
808 + ),
809 + 'lite' => false,
810 + ),
811 + array(
812 + 'label' => 'Customizable layout with CSS classes',
813 + 'link' => array(
814 + 'content' => 'form-layout',
815 + 'param' => 'wordpress-mobile-friendly-forms',
816 + ),
817 + 'lite' => true,
818 + ),
819 + array(
820 + 'label' => 'Customize the HTML for your forms',
821 + 'link' => array(
822 + 'content' => 'custom-html',
823 + 'param' => 'customizable-html-wordpress-form',
824 + ),
825 + 'lite' => true,
826 + ),
827 + array(
828 + 'label' => 'Style your form with the Visual Form Styler',
829 + 'lite' => true,
830 + ),
831 + ),
832 + );
833 +
834 + include( FrmAppHelper::plugin_path() . '/classes/views/addons/upgrade_to_pro.php' );
969 835 }
970 836
971 837 /**
972 - * Uninstall a specified plugin.
838 + * Install Pro after connection with Formidable.
973 839 *
974 - * @since 6.8
975 - *
976 - * @param string $plugin
977 - *
978 - * @return true|WP_Error True on success, WP_Error on invalid file.
840 + * @since 4.02.05
979 841 */
980 - protected static function uninstall_plugin( $plugin ) {
981 - if ( ! current_user_can( 'delete_plugins' ) ) {
982 - return new WP_Error( 'uninstall_failed', __( 'Current user cannot delete plugins.', 'formidable' ) );
983 - }
842 + public static function connect_pro() {
843 + FrmAppHelper::permission_check( 'install_plugins' );
844 + check_ajax_referer( 'frm_ajax', 'nonce' );
984 845
985 - if ( ! function_exists( 'delete_plugins' ) ) {
986 - require_once ABSPATH . 'wp-admin/includes/plugin.php';
846 + $url = FrmAppHelper::get_post_param( 'plugin', '', 'sanitize_text_field' );
847 + if ( FrmAppHelper::pro_is_installed() || empty( $url ) ) {
848 + wp_die();
987 849 }
988 850
989 - self::deactivate_plugin( $plugin, true );
990 - $result = delete_plugins( array( $plugin ) );
851 + $response = array();
991 852
992 - return is_wp_error( $result ) ? $result : true;
993 - }
853 + // It's already installed and active.
854 + $active = activate_plugin( 'formidable-pro/formidable-pro.php', false, false, true );
855 + if ( is_wp_error( $active ) ) {
856 + // The plugin was installed, but not active. Download it now.
857 + self::ajax_install_addon();
858 + } else {
859 + $response['active'] = true;
860 + $response['success'] = true;
861 + }
994 862
995 - /**
996 - * @since 5.0.10
997 - *
998 - * @return string
999 - */
1000 - protected static function get_current_plugin() {
1001 - if ( empty( self::$plugin ) ) {
1002 - self::$plugin = FrmAppHelper::get_param( 'plugin', '', 'post', 'esc_url_raw' );
1003 - }
1004 - return self::$plugin;
863 + echo json_encode( $response );
864 + wp_die();
1005 865 }
1006 866
1007 867 /**
1008 868 * @since 4.08
1009 - *
1010 - * @return mixed[]|null
1011 869 */
1012 870 protected static function download_and_activate() {
871 + // Set the current screen to avoid undefined notices.
1013 872 if ( is_admin() ) {
1014 - FrmAppHelper::set_current_screen_and_hook_suffix();
873 + global $hook_suffix;
874 + set_current_screen();
1015 875 }
1016 876
1017 877 self::maybe_show_cred_form();
1018 878
1019 879 $installed = self::install_addon();
1020 -
1021 880 if ( is_array( $installed ) && isset( $installed['message'] ) ) {
1022 881 return $installed;
1023 882 }
1024 - self::handle_addon_action( $installed, 'activate' );
1025 - return null;
883 + self::maybe_activate_addon( $installed );
1026 884 }
1027 885
1028 886 /**
1029 887 * @since 3.04.02
1030 - *
1031 - * @return void
1032 888 */
1033 889 protected static function maybe_show_cred_form() {
1034 890 if ( ! function_exists( 'request_filesystem_credentials' ) ) {
1035 - include_once ABSPATH . 'wp-admin/includes/file.php';
891 + include_once( ABSPATH . 'wp-admin/includes/file.php' );
1036 892 }
1037 893
1038 - // Start output buffering to catch the filesystem form if credentials are needed.
894 + // Start output bufferring to catch the filesystem form if credentials are needed.
1039 895 ob_start();
1040 896
1041 897 $show_form = false;
1042 898 $method = '';
@@ -1053,8 +909,9 @@
1053 909
1054 910 if ( $show_form ) {
1055 911 $form = ob_get_clean();
1056 912 $message = __( 'Sorry, your site requires FTP authentication. Please download plugins from FormidableForms.com and install them manually.', 'formidable' );
913 + $data = $form;
1057 914 $response = array(
1058 915 'success' => false,
1059 916 'message' => $message,
1060 917 'form' => $form,
@@ -1065,40 +922,18 @@
1065 922 ob_end_clean();
1066 923 }
1067 924
1068 925 /**
1069 - * Checks if an addon download url is allowed.
1070 - *
1071 - * @since 6.2
1072 - *
1073 - * @param string $download_url
1074 - *
1075 - * @return bool
1076 - */
1077 - public static function url_is_allowed( $download_url ) {
1078 - return FrmAppHelper::validate_url_is_in_s3_bucket( $download_url, 'zip' ) || in_array( $download_url, self::allowed_external_urls(), true );
1079 - }
1080 -
1081 - /**
1082 926 * We do not need any extra credentials if we have gotten this far,
1083 927 * so let's install the plugin.
1084 928 *
1085 929 * @since 3.04.02
1086 - *
1087 - * @return array|string
1088 930 */
1089 931 protected static function install_addon() {
1090 - require_once ABSPATH . 'wp-admin/includes/class-wp-upgrader.php';
932 + require_once( ABSPATH . 'wp-admin/includes/class-wp-upgrader.php' );
1091 933
1092 - $download_url = self::get_current_plugin();
934 + $download_url = FrmAppHelper::get_param( 'plugin', '', 'post', 'esc_url_raw' );
1093 935
1094 - if ( ! self::url_is_allowed( $download_url ) ) {
1095 - return array(
1096 - 'message' => 'Plugin URL is not valid',
1097 - 'success' => false,
1098 - );
1099 - }
1100 -
1101 936 // Create the plugin upgrader with our custom skin.
1102 937 $installer = new Plugin_Upgrader( new FrmInstallerSkin() );
1103 938 $installer->install( $download_url );
1104 939
@@ -1105,212 +940,110 @@
1105 940 // Flush the cache and return the newly installed plugin basename.
1106 941 wp_cache_flush();
1107 942
1108 943 $plugin = $installer->plugin_info();
1109 -
1110 - if ( ! $plugin ) {
944 + if ( empty( $plugin ) ) {
1111 945 return array(
1112 946 'message' => 'Plugin was not installed. ' . $installer->result,
1113 947 'success' => false,
1114 948 );
1115 949 }
1116 -
1117 950 return $plugin;
1118 951 }
1119 952
1120 953 /**
1121 - * Handle the AJAX request to activate an add-on.
1122 - *
1123 - * @since 6.8
1124 - *
1125 - * @return void
954 + * @since 3.06.03
1126 955 */
1127 956 public static function ajax_activate_addon() {
1128 - self::process_addon_action(
1129 - function ( $plugin ) {
1130 - return self::handle_addon_action( $plugin, 'activate' );
1131 - },
1132 - array( 'FrmAddonsController', 'get_addon_activation_response' )
1133 - );
1134 - }
1135 957
1136 - /**
1137 - * @since 3.04.02
1138 - *
1139 - * @param string $installed The plugin folder name with file name.
1140 - */
1141 - protected static function maybe_activate_addon( $installed ) {
1142 - self::ajax_activate_addon();
958 + self::install_addon_permissions();
959 +
960 + // Set the current screen to avoid undefined notices.
961 + global $hook_suffix;
962 + set_current_screen();
963 +
964 + $plugin = FrmAppHelper::get_param( 'plugin', '', 'post', 'sanitize_text_field' );
965 + self::maybe_activate_addon( $plugin );
966 +
967 + echo json_encode( self::get_addon_activation_response() );
968 + wp_die();
1143 969 }
1144 970
1145 971 /**
1146 - * Handle the AJAX request to deactivate an add-on.
1147 - *
1148 - * @since 6.8
1149 - *
1150 - * @return void
972 + * @return array|string
1151 973 */
1152 - public static function ajax_deactivate_addon() {
1153 - self::process_addon_action(
1154 - function ( $plugin ) {
1155 - return self::handle_addon_action( $plugin, 'deactivate' );
1156 - }
1157 - );
974 + private static function get_addon_activation_response() {
975 + if ( self::activating_from_settings_page() ) {
976 + $response = array(
977 + 'message' => __( 'Your plugin has been activated. Would you like to save and reload the page now?', 'formidable' ),
978 + 'saveAndReload' => 'settings',
979 + );
980 + } else {
981 + $response = __( 'Your plugin has been activated. Please reload the page to see more options.', 'formidable' );
982 + }
983 + return $response;
1158 984 }
1159 985
1160 986 /**
1161 - * Handle the AJAX request to uninstall an add-on.
1162 - *
1163 - * @since 6.8
1164 - *
1165 - * @return void
987 + * @return bool
1166 988 */
1167 - public static function ajax_uninstall_addon() {
1168 - self::process_addon_action(
1169 - function ( $plugin ) {
1170 - return self::handle_addon_action( $plugin, 'uninstall' );
1171 - }
1172 - );
989 + private static function activating_from_settings_page() {
990 + return false !== strpos( FrmAppHelper::get_server_value( 'HTTP_REFERER' ), 'frm_action=settings' );
1173 991 }
1174 992
1175 993 /**
1176 - * Process a specific action (activate, deactivate, uninstall) on an add-on.
1177 - *
1178 - * @since 6.8
1179 - *
1180 - * @param callable $action_callback The specific add-on action to be executed.
1181 - * @param callable|null $response_callback Optional. The response handling callback. Default null.
1182 - *
1183 - * @return void
994 + * @since 3.04.02
995 + * @param string $installed The plugin folder name with file name
1184 996 */
1185 - private static function process_addon_action( $action_callback, $response_callback = null ) {
1186 - self::install_addon_permissions();
1187 - FrmAppHelper::set_current_screen_and_hook_suffix();
1188 -
1189 - $plugin = FrmAppHelper::get_param( 'plugin', '', 'post', 'sanitize_text_field' );
1190 - call_user_func( $action_callback, $plugin );
1191 -
1192 - if ( is_callable( $response_callback ) ) {
1193 - wp_send_json_success( call_user_func( $response_callback ) );
997 + protected static function maybe_activate_addon( $installed ) {
998 + if ( ! $installed ) {
1194 999 return;
1195 1000 }
1196 1001
1197 - wp_send_json_success();
1198 - }
1199 -
1200 - /**
1201 - * Attempt to perform a specific action (activate, deactivate, uninstall) on an add-on.
1202 - *
1203 - * @since 6.8
1204 - *
1205 - * @param string $installed The plugin folder name with file name.
1206 - * @param string $action The action type ('activate', 'deactivate', 'uninstall').
1207 - *
1208 - * @return mixed[]|null
1209 - */
1210 - protected static function handle_addon_action( $installed, $action ) {
1211 - if ( ! $installed || ! $action ) {
1212 - return null;
1213 - }
1214 -
1215 - $result = null;
1216 - switch ( $action ) {
1217 - case 'activate':
1218 - $result = self::activate_plugin( $installed );
1219 - break;
1220 - case 'deactivate':
1221 - self::deactivate_plugin( $installed );
1222 - break;
1223 - case 'uninstall':
1224 - $result = self::uninstall_plugin( $installed );
1225 - break;
1226 - }
1227 -
1228 - if ( is_wp_error( $result ) ) {
1002 + $activate = activate_plugin( $installed );
1003 + if ( is_wp_error( $activate ) ) {
1229 1004 // Ignore the invalid header message that shows with nested plugins.
1230 - if ( $result->get_error_code() !== 'no_plugin_header' ) {
1005 + if ( $activate->get_error_code() !== 'no_plugin_header' ) {
1231 1006 if ( wp_doing_ajax() ) {
1232 - wp_send_json_error( array( 'error' => $result->get_error_message() ) );
1007 + echo json_encode( array( 'error' => $activate->get_error_message() ) );
1008 + wp_die();
1233 1009 }
1234 -
1235 1010 return array(
1236 - 'message' => $result->get_error_message(),
1011 + 'message' => $activate->get_error_message(),
1237 1012 'success' => false,
1238 1013 );
1239 1014 }
1240 1015 }
1241 -
1242 - return $result;
1243 1016 }
1244 1017
1245 1018 /**
1246 - * @return array
1247 - */
1248 - private static function get_addon_activation_response() {
1249 - $activating_page = self::get_activating_page();
1250 - $message = $activating_page ? __( 'Your plugin has been activated. Would you like to save and reload the page now?', 'formidable' ) : __( 'Your plugin has been activated.', 'formidable' ); // phpcs:ignore SlevomatCodingStandard.Files.LineLength.LineTooLong
1251 -
1252 - return array(
1253 - 'message' => $message,
1254 - 'saveAndReload' => $activating_page,
1255 - );
1256 - }
1257 -
1258 - /**
1259 - * Return a string that reflects the page from which the addon is being activated on,
1260 - * if it is from settings or form builder, otherwise return empty string.
1261 - *
1262 - * @return string
1263 - */
1264 - private static function get_activating_page() {
1265 - $referer = FrmAppHelper::get_server_value( 'HTTP_REFERER' );
1266 -
1267 - if ( str_contains( $referer, 'frm_action=settings' ) ) {
1268 - return 'settings';
1269 - }
1270 -
1271 - return str_contains( $referer, 'frm_action=edit' ) ? 'form_builder' : '';
1272 - }
1273 -
1274 - /**
1275 1019 * Run security checks before installing
1276 1020 *
1277 1021 * @since 3.04.02
1278 - *
1279 - * @return void
1280 1022 */
1281 1023 protected static function install_addon_permissions() {
1282 1024 check_ajax_referer( 'frm_ajax', 'nonce' );
1283 1025
1284 - if ( current_user_can( 'activate_plugins' ) && self::get_current_plugin() ) {
1285 - return;
1026 + if ( ! current_user_can( 'activate_plugins' ) || ! isset( $_POST['plugin'] ) ) {
1027 + echo json_encode( true );
1028 + wp_die();
1286 1029 }
1287 -
1288 - echo json_encode( true );
1289 - wp_die();
1290 1030 }
1291 1031
1292 1032 /**
1293 1033 * @since 4.08
1294 - *
1295 - * @return string
1296 1034 */
1297 1035 public static function connect_link() {
1298 1036 $auth = get_option( 'frm_connect_token' );
1299 -
1300 - if ( ! $auth ) {
1037 + if ( empty( $auth ) ) {
1301 1038 $auth = hash( 'sha512', wp_rand() );
1302 - update_option( 'frm_connect_token', $auth, false );
1039 + update_option( 'frm_connect_token', $auth );
1303 1040 }
1304 -
1305 - $page = FrmAppHelper::simple_get( 'page', 'sanitize_title', 'formidable-settings' );
1306 - $link = 'https://formidableforms.com/api-connect/';
1041 + $link = FrmAppHelper::admin_upgrade_link( 'connect', 'api-connect' );
1307 1042 $args = array(
1308 1043 'v' => 2,
1309 1044 'siteurl' => FrmAppHelper::site_url(),
1310 1045 'url' => get_rest_url(),
1311 - 'inst' => (int) FrmAppHelper::pro_is_included(),
1312 - 'return' => $page,
1313 1046 'token' => $auth,
1314 1047 'l' => self::get_pro_license(),
1315 1048 );
1316 1049
@@ -1328,19 +1061,19 @@
1328 1061 // Verify params present (auth & download link).
1329 1062 $post_auth = FrmAppHelper::get_param( 'token', '', 'request', 'sanitize_text_field' );
1330 1063 $post_url = FrmAppHelper::get_param( 'file_url', '', 'request', 'sanitize_text_field' );
1331 1064
1332 - // The download link is not required if already installed.
1333 - $is_installed = FrmAppHelper::pro_is_included();
1334 - $file_missing = ! $is_installed && ! $post_url;
1335 -
1336 - if ( ! $post_auth || $file_missing ) {
1065 + if ( empty( $post_auth ) || empty( $post_url ) ) {
1337 1066 return false;
1338 1067 }
1339 1068
1340 1069 // Verify auth.
1341 1070 $auth = get_option( 'frm_connect_token' );
1342 - return $auth && hash_equals( $auth, $post_auth );
1071 + if ( empty( $auth ) || ! hash_equals( $auth, $post_auth ) ) {
1072 + return false;
1073 + }
1074 +
1075 + return true;
1343 1076 }
1344 1077
1345 1078 /**
1346 1079 * Install and/or activate the add-on file.
@@ -1345,35 +1078,34 @@
1345 1078 /**
1346 1079 * Install and/or activate the add-on file.
1347 1080 *
1348 1081 * @since 4.08
1349 - *
1350 - * @return array
1351 1082 */
1352 1083 public static function install_addon_api() {
1353 - self::$plugin = FrmAppHelper::get_param( 'file_url', '', 'request', 'esc_url_raw' );
1084 + // Sanitize when it's used to prevent double sanitizing.
1085 + // phpcs:ignore WordPress.Security.ValidatedSanitizedInput
1086 + $_POST['plugin'] = isset( $_REQUEST['file_url'] ) ? $_REQUEST['file_url'] : ''; // Set for later use
1354 1087
1088 + $error = esc_html__( 'Could not install an upgrade. Please download from formidableforms.com and install manually.', 'formidable' );
1089 +
1355 1090 // Delete so cannot replay.
1356 1091 delete_option( 'frm_connect_token' );
1357 1092
1358 1093 // It's already installed and active.
1359 - $active = self::activate_plugin( 'formidable-pro/formidable-pro.php', false, false, true );
1360 -
1094 + $active = activate_plugin( 'formidable-pro/formidable-pro.php', false, false, true );
1361 1095 if ( is_wp_error( $active ) ) {
1362 - $response = self::maybe_download_and_activate();
1363 -
1364 - if ( is_array( $response ) ) {
1365 - // The download failed.
1096 + // Download plugin now.
1097 + $response = self::download_and_activate();
1098 + if ( is_array( $response ) && isset( $response['success'] ) ) {
1366 1099 return $response;
1367 1100 }
1368 1101 }
1369 1102
1370 1103 // If empty license, save it now.
1371 - if ( ! self::get_pro_license() && function_exists( 'load_formidable_pro' ) ) {
1104 + if ( empty( self::get_pro_license() ) && function_exists( 'load_formidable_pro' ) ) {
1372 1105 load_formidable_pro();
1373 1106 $license = stripslashes( FrmAppHelper::get_param( 'key', '', 'request', 'sanitize_text_field' ) );
1374 -
1375 - if ( ! $license ) {
1107 + if ( empty( $license ) ) {
1376 1108 return array(
1377 1109 'success' => false,
1378 1110 'error' => 'That site does not have a valid license key.',
1379 1111 );
@@ -1379,9 +1111,8 @@
1379 1111 );
1380 1112 }
1381 1113
1382 1114 $response = FrmAddon::activate_license_for_plugin( $license, 'formidable_pro' );
1383 -
1384 1115 if ( ! $response['success'] ) {
1385 1116 // Could not activate license.
1386 1117 return $response;
1387 1118 }
@@ -1392,60 +1123,22 @@
1392 1123 );
1393 1124 }
1394 1125
1395 1126 /**
1396 - * @since 6.8.3
1397 - *
1398 - * @return array|true
1399 - */
1400 - private static function maybe_download_and_activate() {
1401 - if ( ! self::$plugin ) {
1402 - return array(
1403 - 'success' => false,
1404 - 'message' => __( 'The plugin download was not found.', 'formidable' ),
1405 - );
1406 - }
1407 -
1408 - // Download plugin now.
1409 - $response = self::download_and_activate();
1410 -
1411 - if ( is_array( $response ) && isset( $response['success'] ) ) {
1412 - // The download failed.
1413 - return $response;
1414 - }
1415 -
1416 - return true;
1417 - }
1418 -
1419 - /**
1420 1127 * Render a conditional action button for a specified plugin
1421 1128 *
1129 + * @param string $plugin
1130 + * @param array|string $upgrade_link_args
1422 1131 * @since 4.09
1423 - *
1424 - * @param string $plugin
1425 - * @param array|string $upgrade_link_args
1426 - *
1427 - * @return void
1428 1132 */
1429 1133 public static function conditional_action_button( $plugin, $upgrade_link_args ) {
1430 1134 if ( is_callable( 'FrmProAddonsController::conditional_action_button' ) ) {
1431 - FrmProAddonsController::conditional_action_button( $plugin, $upgrade_link_args );
1432 - return;
1135 + return FrmProAddonsController::conditional_action_button( $plugin, $upgrade_link_args );
1433 1136 }
1434 1137
1435 1138 $addon = self::get_addon( $plugin );
1436 1139 $upgrade_link = FrmAppHelper::admin_upgrade_link( $upgrade_link_args );
1437 -
1438 - if ( ! is_array( $upgrade_link_args ) ) {
1439 - // A string $upgrade_link_args is used for the utm-medium value when calling
1440 - // FrmAppHelper::admin_upgrade_link above.
1441 - // For self::addon_upgrade_link, we'll pass just an empty array with the link key (set below).
1442 - $upgrade_link_args = array();
1443 - }
1444 -
1445 - $upgrade_link_args['link'] = $upgrade_link;
1446 -
1447 - self::addon_upgrade_link( $addon, $upgrade_link_args );
1140 + self::addon_upgrade_link( $addon, $upgrade_link );
1448 1141 }
1449 1142
1450 1143 /**
1451 1144 * Render a conditional action button for an add on
@@ -1450,24 +1143,16 @@
1450 1143 /**
1451 1144 * Render a conditional action button for an add on
1452 1145 *
1453 1146 * @since 4.09.01
1454 - *
1455 - * @param array $atts {
1456 - * Button attributes.
1457 - *
1458 - * @type array $addon
1459 - * @type false|string $license_type
1460 - * @type string $plan_required
1461 - * @type string $upgrade_link
1462 - * }
1463 - *
1464 - * @return void
1147 + * @param array $addon
1148 + * @param string|false $license_type
1149 + * @param string $plan_required
1150 + * @param string $upgrade_link
1465 1151 */
1466 1152 public static function show_conditional_action_button( $atts ) {
1467 1153 if ( is_callable( 'FrmProAddonsController::show_conditional_action_button' ) ) {
1468 - FrmProAddonsController::show_conditional_action_button( $atts );
1469 - return;
1154 + return FrmProAddonsController::show_conditional_action_button( $atts );
1470 1155 }
1471 1156
1472 1157 self::addon_upgrade_link( $atts['addon'], $atts['upgrade_link'] );
1473 1158 }
@@ -1473,19 +1158,10 @@
1473 1158 }
1474 1159
1475 1160 /**
1476 1161 * @since 4.09.01
1477 - *
1478 - * @param array|false $addon
1479 - * @param array|string $upgrade_link
1480 - *
1481 - * @return void
1482 1162 */
1483 - public static function addon_upgrade_link( $addon, $upgrade_link ) {
1484 - $atts = is_array( $upgrade_link ) ? $upgrade_link : array();
1485 - $upgrade_link = is_array( $upgrade_link ) ? $upgrade_link['link'] : $upgrade_link;
1486 - $text = ! empty( $atts['text'] ) ? $atts['text'] : __( 'Upgrade Now', 'formidable' );
1487 -
1163 + protected static function addon_upgrade_link( $addon, $upgrade_link ) {
1488 1164 if ( $addon ) {
1489 1165 $upgrade_link .= '&utm_content=' . $addon['slug'];
1490 1166 }
1491 1167
@@ -1492,94 +1168,117 @@
1492 1168 if ( $addon && isset( $addon['categories'] ) && in_array( 'Solution', $addon['categories'], true ) ) {
1493 1169 // Solutions will go to a separate page.
1494 1170 $upgrade_link = FrmAppHelper::admin_upgrade_link( 'addons', $addon['link'] );
1495 1171 }
1496 -
1497 - $class = ! empty( $atts['class'] ) ? $atts['class'] : '';
1498 -
1499 - if ( ! str_contains( $class, 'frm-button' ) ) {
1500 - $class .= ' frm-button-secondary frm-button-sm';
1501 - }
1502 - // phpcs:disable Generic.WhiteSpace.ScopeIndent
1503 1172 ?>
1504 - <a class="install-now button <?php echo esc_attr( $class ); ?>" href="<?php echo esc_url( $upgrade_link ); ?>" target="_blank" rel="noopener" aria-label="<?php esc_attr_e( 'Upgrade Now', 'formidable' ); ?>"><?php // phpcs:ignore SlevomatCodingStandard.Files.LineLength.LineTooLong ?>
1505 - <?php echo esc_html( $text ); ?>
1173 + <a class="install-now button button-secondary frm-button-secondary" href="<?php echo esc_url( $upgrade_link ); ?>" target="_blank" rel="noopener" aria-label="<?php esc_attr_e( 'Upgrade Now', 'formidable' ); ?>">
1174 + <?php esc_html_e( 'Upgrade Now', 'formidable' ); ?>
1506 1175 </a>
1507 1176 <?php
1508 - // phpcs:enable Generic.WhiteSpace.ScopeIndent
1509 1177 }
1510 1178
1511 1179 /**
1512 1180 * @since 3.04.02
1513 - *
1514 - * @return void
1515 1181 */
1516 1182 public static function ajax_install_addon() {
1517 1183 self::install_addon_permissions();
1518 1184
1519 - $result = self::download_and_activate();
1185 + self::download_and_activate();
1520 1186
1521 - if ( isset( $result['success'] ) && ! $result['success'] ) {
1522 - echo json_encode( $result );
1523 - wp_die();
1524 - }
1525 -
1526 1187 echo json_encode( self::get_addon_activation_response() );
1527 1188 wp_die();
1528 1189 }
1529 1190
1530 1191 /**
1531 - * Allowed URLs used for internal source of plugins installation.
1192 + * @since 4.06.02
1193 + * @deprecated 4.09.01
1194 + */
1195 + public static function ajax_multiple_addons() {
1196 + FrmDeprecated::ajax_multiple_addons();
1197 + }
1198 +
1199 + /**
1200 + * @since 3.04.03
1201 + * @deprecated 3.06
1202 + * @codeCoverageIgnore
1203 + * @return array
1204 + */
1205 + public static function error_for_license( $license ) {
1206 + return FrmDeprecated::error_for_license( $license );
1207 + }
1208 +
1209 + /**
1210 + * @since 3.04.03
1211 + * @deprecated 3.06
1212 + * @codeCoverageIgnore
1213 + */
1214 + public static function get_pro_updater() {
1215 + return FrmDeprecated::get_pro_updater();
1216 + }
1217 +
1218 + /**
1219 + * @since 3.04.03
1220 + * @deprecated 3.06
1221 + * @codeCoverageIgnore
1532 1222 *
1533 - * @since 6.3.1
1534 - *
1535 1223 * @return array
1536 1224 */
1537 - private static function allowed_external_urls() {
1538 - $allowed_url_list = array(
1539 - 'https://downloads.wordpress.org/plugin/formidable-gravity-forms-importer.zip',
1540 - 'https://downloads.wordpress.org/plugin/formidable-import-pirate-forms.zip',
1541 - 'https://downloads.wordpress.org/plugin/wp-mail-smtp.zip',
1542 - );
1225 + public static function get_addon_info( $license = '' ) {
1226 + return FrmDeprecated::get_addon_info( $license );
1227 + }
1543 1228
1544 - /**
1545 - * List of URLs used in plugin formidable internal installation.
1546 - *
1547 - * @since 6.3.1
1548 - *
1549 - * @param array $allowed_url_list List of URLs.
1550 - */
1551 - $allowed_url_list = apply_filters( 'frm_allowed_external_urls', $allowed_url_list );
1229 + /**
1230 + * @since 3.04.03
1231 + * @deprecated 3.06
1232 + * @codeCoverageIgnore
1233 + *
1234 + * @return string
1235 + */
1236 + public static function get_cache_key( $license ) {
1237 + return FrmDeprecated::get_cache_key( $license );
1238 + }
1552 1239
1553 - if ( ! is_array( $allowed_url_list ) ) {
1554 - _doing_it_wrong( __METHOD__, 'Only an array of URLs could be used within this filter.', '6.3.1' );
1555 - return array();
1556 - }
1240 + /**
1241 + * @since 3.04.03
1242 + * @deprecated 3.06
1243 + * @codeCoverageIgnore
1244 + */
1245 + public static function reset_cached_addons( $license = '' ) {
1246 + FrmDeprecated::reset_cached_addons( $license );
1247 + }
1557 1248
1558 - return $allowed_url_list;
1249 + /**
1250 + * @since 2.03.08
1251 + * @deprecated 3.04.03
1252 + * @codeCoverageIgnore
1253 + *
1254 + * @param boolean $return
1255 + * @param string $package
1256 + *
1257 + * @return boolean
1258 + */
1259 + public static function add_shorten_edd_filename_filter( $return, $package ) {
1260 + return FrmDeprecated::add_shorten_edd_filename_filter( $return, $package );
1559 1261 }
1560 1262
1561 1263 /**
1562 - * Gets required plan for an addon.
1264 + * @since 2.03.08
1265 + * @deprecated 3.04.03
1266 + * @codeCoverageIgnore
1563 1267 *
1564 - * @since 6.4.2
1268 + * @param string $filename
1269 + * @param string $ext
1565 1270 *
1566 - * @param int|string $addon_id
1567 - *
1568 - * @return string Empty string if no plan is required for active license.
1271 + * @return string
1569 1272 */
1570 - public static function get_addon_required_plan( $addon_id ) {
1571 - $api = new FrmFormApi();
1572 - $addons = $api->get_api_info();
1273 + public static function shorten_edd_filename( $filename, $ext ) {
1274 + return FrmDeprecated::shorten_edd_filename( $filename, $ext );
1275 + }
1573 1276
1574 - if ( is_array( $addons ) && array_key_exists( $addon_id, $addons ) ) {
1575 - $dates = $addons[ $addon_id ];
1576 - $requires = FrmFormsHelper::get_plan_required( $dates );
1577 - }
1578 -
1579 - if ( ! isset( $requires ) || ! is_string( $requires ) ) {
1580 - return '';
1581 - }
1582 -
1583 - return $requires;
1277 + /**
1278 + * @deprecated 3.04.03
1279 + * @codeCoverageIgnore
1280 + */
1281 + public static function get_licenses() {
1282 + FrmDeprecated::get_licenses();
1584 1283 }
1585 1284 }