← All changes
|
classes/controllers/FrmFormTemplatesController.php
+22
-75
6.27
→
6.22.2
View file →
| @@ -19,9 +19,9 @@ | ||
| 19 | 19 | |
| 20 | 20 | /** |
| 21 | 21 | * The slug of the Form Templates page. |
| 22 | 22 | * |
| 23 | - * @var string Unique identifier for the "Form Templates" page. | |
| 23 | + * @var string PAGE_SLUG Unique identifier for the "Form Templates" page. | |
| 24 | 24 | */ |
| 25 | 25 | const PAGE_SLUG = 'formidable-form-templates'; |
| 26 | 26 | |
| 27 | 27 | /** |
| @@ -26,9 +26,9 @@ | ||
| 26 | 26 | |
| 27 | 27 | /** |
| 28 | 28 | * The script handle. |
| 29 | 29 | * |
| 30 | - * @var string Unique handle for the admin script. | |
| 30 | + * @var string SCRIPT_HANDLE Unique handle for the admin script. | |
| 31 | 31 | */ |
| 32 | 32 | const SCRIPT_HANDLE = 'frm-form-templates'; |
| 33 | 33 | |
| 34 | 34 | /** |
| @@ -33,33 +33,26 @@ | ||
| 33 | 33 | |
| 34 | 34 | /** |
| 35 | 35 | * The required user capability to view form templates. |
| 36 | 36 | * |
| 37 | - * @var string Required capability to access the view form templates. | |
| 37 | + * @var string REQUIRED_CAPABILITY Required capability to access the view form templates. | |
| 38 | 38 | */ |
| 39 | 39 | const REQUIRED_CAPABILITY = 'frm_view_forms'; |
| 40 | 40 | |
| 41 | 41 | /** |
| 42 | - * The IDs of the featured templates. | |
| 42 | + * The keys of the featured templates. | |
| 43 | 43 | * |
| 44 | - * Contains the unique IDs for the templates that are considered "featured": | |
| 44 | + * Contains the unique keys for the templates that are considered "featured": | |
| 45 | 45 | * "Contact Us", "Stripe Payment", "User Registration", "Create WordPress Post", "Survey", and "Quiz". |
| 46 | 46 | * |
| 47 | - * @var array Unique IDs for the featured templates. | |
| 47 | + * @var array FEATURED_TEMPLATES_KEYS Unique keys for the featured templates. | |
| 48 | 48 | */ |
| 49 | - const FEATURED_TEMPLATES_IDS = array( 20872734, 28223640, 20874748, 20882522, 20908981, 28109851 ); | |
| 49 | + const FEATURED_TEMPLATES_KEYS = array( 20872734, 28223640, 20874748, 20882522, 20908981, 28109851 ); | |
| 50 | 50 | |
| 51 | 51 | /** |
| 52 | - * The IDs of the free templates. | |
| 53 | - * | |
| 54 | - * @var array Unique IDs for the free templates. | |
| 55 | - */ | |
| 56 | - const FREE_TEMPLATES_IDS = array( 20872734, 28223640 ); | |
| 57 | - | |
| 58 | - /** | |
| 59 | 52 | * Option name to store favorite templates. |
| 60 | 53 | * |
| 61 | - * @var string Unique identifier for storing favorite templates. | |
| 54 | + * @var string FAVORITE_TEMPLATES_OPTION Unique identifier for storing favorite templates. | |
| 62 | 55 | */ |
| 63 | 56 | const FAVORITE_TEMPLATES_OPTION = 'frm_favorite_templates'; |
| 64 | 57 | |
| 65 | 58 | /** |
| @@ -142,22 +135,20 @@ | ||
| 142 | 135 | /** |
| 143 | 136 | * Initialize hooks for template page only. |
| 144 | 137 | * |
| 145 | 138 | * @since 6.7 |
| 146 | - * | |
| 147 | - * @return void | |
| 148 | 139 | */ |
| 149 | 140 | public static function load_admin_hooks() { |
| 150 | 141 | self::init_template_resources(); |
| 151 | 142 | |
| 152 | 143 | // Use the same priority as Applications so Form Templates appear directly under Applications. |
| 153 | - add_action( 'admin_menu', self::class . '::menu', 14 ); | |
| 154 | - add_action( 'admin_footer', self::class . '::render_modal' ); | |
| 155 | - add_filter( 'frm_form_nav_list', self::class . '::append_new_template_to_nav', 10, 2 ); | |
| 144 | + add_action( 'admin_menu', __CLASS__ . '::menu', 14 ); | |
| 145 | + add_action( 'admin_footer', __CLASS__ . '::render_modal' ); | |
| 146 | + add_filter( 'frm_form_nav_list', __CLASS__ . '::append_new_template_to_nav', 10, 2 ); | |
| 156 | 147 | |
| 157 | 148 | if ( self::is_templates_page() ) { |
| 158 | - add_action( 'admin_init', self::class . '::set_form_templates_data' ); | |
| 159 | - add_action( 'admin_enqueue_scripts', self::class . '::enqueue_assets', 15 ); | |
| 149 | + add_action( 'admin_init', __CLASS__ . '::set_form_templates_data' ); | |
| 150 | + add_action( 'admin_enqueue_scripts', __CLASS__ . '::enqueue_assets', 15 ); | |
| 160 | 151 | add_filter( 'frm_show_footer_links', '__return_false' ); |
| 161 | 152 | } |
| 162 | 153 | } |
| 163 | 154 | |
| @@ -176,9 +167,9 @@ | ||
| 176 | 167 | 'Formidable | ' . $label, |
| 177 | 168 | $label, |
| 178 | 169 | self::REQUIRED_CAPABILITY, |
| 179 | 170 | self::PAGE_SLUG, |
| 180 | - array( self::class, 'render' ) | |
| 171 | + array( __CLASS__, 'render' ) | |
| 181 | 172 | ); |
| 182 | 173 | } |
| 183 | 174 | |
| 184 | 175 | /** |
| @@ -234,17 +225,8 @@ | ||
| 234 | 225 | |
| 235 | 226 | // Add `create-template` modal view. |
| 236 | 227 | $view_parts[] = 'modals/create-template-modal.php'; |
| 237 | 228 | |
| 238 | - if ( FrmFormTemplatesHelper::needs_get_free_templates_banner() ) { | |
| 239 | - $leave_email_args = array( | |
| 240 | - 'title' => esc_html__( 'Get 30+ Free Form Templates', 'formidable' ), | |
| 241 | - 'description' => esc_html__( 'Just add your email address and you\'ll get 30+ free form templates to your account.', 'formidable' ), | |
| 242 | - 'submit_button_text' => esc_html_x( 'Get Templates', 'get free templates modal submit button text', 'formidable' ), | |
| 243 | - ); | |
| 244 | - $view_parts[] = 'modals/leave-email-modal.php'; | |
| 245 | - } | |
| 246 | - | |
| 247 | 229 | // Add 'upgrade' modal view for non-elite users. |
| 248 | 230 | if ( 'elite' !== FrmAddonsController::license_type() ) { |
| 249 | 231 | $view_parts[] = 'modals/upgrade-modal.php'; |
| 250 | 232 | } |
| @@ -342,9 +324,8 @@ | ||
| 342 | 324 | if ( 'add' === $operation ) { |
| 343 | 325 | self::$favorite_templates[ $key ][] = $template_id; |
| 344 | 326 | } elseif ( 'remove' === $operation ) { |
| 345 | 327 | $position = array_search( $template_id, self::$favorite_templates[ $key ], true ); |
| 346 | - | |
| 347 | 328 | if ( $position !== false ) { |
| 348 | 329 | unset( self::$favorite_templates[ $key ][ $position ] ); |
| 349 | 330 | } |
| 350 | 331 | } |
| @@ -394,37 +375,8 @@ | ||
| 394 | 375 | wp_die(); |
| 395 | 376 | } |
| 396 | 377 | |
| 397 | 378 | /** |
| 398 | - * Handle AJAX request to subscribe the user to ActiveCampaign. | |
| 399 | - * | |
| 400 | - * @since 6.25 | |
| 401 | - * | |
| 402 | - * @return void | |
| 403 | - */ | |
| 404 | - public static function ajax_get_free_templates() { | |
| 405 | - FrmAppHelper::permission_check( self::REQUIRED_CAPABILITY ); | |
| 406 | - check_ajax_referer( 'frm_ajax', 'nonce' ); | |
| 407 | - | |
| 408 | - $email = FrmAppHelper::get_post_param( 'email', '', 'sanitize_email' ); | |
| 409 | - | |
| 410 | - if ( ! $email || ! is_email( $email ) ) { | |
| 411 | - wp_send_json_error( | |
| 412 | - array( 'message' => __( 'Please enter a valid email address.', 'formidable' ) ), | |
| 413 | - WP_Http::BAD_REQUEST | |
| 414 | - ); | |
| 415 | - } | |
| 416 | - | |
| 417 | - self::$form_template_api = new FrmFormTemplateApi(); | |
| 418 | - self::$form_template_api->reset_cached(); | |
| 419 | - | |
| 420 | - FrmEmailCollectionHelper::subscribe_to_active_campaign( $email ); | |
| 421 | - self::$form_template_api::set_free_license_code( '1' ); | |
| 422 | - | |
| 423 | - wp_send_json_success(); | |
| 424 | - } | |
| 425 | - | |
| 426 | - /** | |
| 427 | 379 | * Fetch and format custom templates. |
| 428 | 380 | * |
| 429 | 381 | * Retrieves the custom templates, formats them, and assigns them to the class property. |
| 430 | 382 | * |
| @@ -536,9 +488,8 @@ | ||
| 536 | 488 | |
| 537 | 489 | // Filter out certain and redundant categories. |
| 538 | 490 | // 'PayPal', 'Stripe', and 'Twilio' are included elsewhere and should be ignored in this context. |
| 539 | 491 | $redundant_cats = array_merge( array( 'PayPal', 'Stripe', 'Twilio' ), FrmFormsHelper::get_license_types() ); |
| 540 | - | |
| 541 | 492 | foreach ( $redundant_cats as $redundant_cat ) { |
| 542 | 493 | $category_slug = sanitize_title( $redundant_cat ); |
| 543 | 494 | unset( self::$categories[ $category_slug ] ); |
| 544 | 495 | } |
| @@ -556,9 +507,8 @@ | ||
| 556 | 507 | 'name' => __( 'Custom', 'formidable' ), |
| 557 | 508 | 'count' => count( self::$custom_templates ), |
| 558 | 509 | ), |
| 559 | 510 | ); |
| 560 | - | |
| 561 | 511 | // Add the 'Available Templates' category for non-elite users. |
| 562 | 512 | if ( 'elite' !== FrmAddonsController::license_type() ) { |
| 563 | 513 | $special_categories['available-templates'] = array( |
| 564 | 514 | 'name' => __( 'Available Templates', 'formidable' ), |
| @@ -565,10 +515,9 @@ | ||
| 565 | 515 | // Assigned via JavaScript. |
| 566 | 516 | 'count' => 0, |
| 567 | 517 | ); |
| 568 | 518 | } |
| 569 | - | |
| 570 | - $special_categories['all-items'] = array( | |
| 519 | + $special_categories['all-items'] = array( | |
| 571 | 520 | 'name' => __( 'All Templates', 'formidable' ), |
| 572 | 521 | 'count' => self::get_template_count(), |
| 573 | 522 | ); |
| 574 | 523 | |
| @@ -580,9 +529,9 @@ | ||
| 580 | 529 | |
| 581 | 530 | /** |
| 582 | 531 | * Assign featured templates. |
| 583 | 532 | * |
| 584 | - * Iterates through FEATURED_TEMPLATES_IDS and adds matching templates to | |
| 533 | + * Iterates through FEATURED_TEMPLATES_KEYS and adds matching templates to | |
| 585 | 534 | * the `featured_templates` class property. |
| 586 | 535 | * |
| 587 | 536 | * @since 6.7 |
| 588 | 537 | * |
| @@ -588,9 +537,9 @@ | ||
| 588 | 537 | * |
| 589 | 538 | * @return void |
| 590 | 539 | */ |
| 591 | 540 | private static function assign_featured_templates() { |
| 592 | - foreach ( self::FEATURED_TEMPLATES_IDS as $key ) { | |
| 541 | + foreach ( self::FEATURED_TEMPLATES_KEYS as $key ) { | |
| 593 | 542 | if ( isset( self::$templates[ $key ] ) ) { |
| 594 | 543 | self::$templates[ $key ]['is_featured'] = true; |
| 595 | 544 | self::$featured_templates[] = self::$templates[ $key ]; |
| 596 | 545 | } |
| @@ -659,9 +608,8 @@ | ||
| 659 | 608 | * @since 6.7 |
| 660 | 609 | * |
| 661 | 610 | * @param array $nav_items Navigation items. |
| 662 | 611 | * @param array $nav_args Additional navigation arguments. |
| 663 | - * | |
| 664 | 612 | * @return array Modified navigation items with 'new_template' query parameter. |
| 665 | 613 | */ |
| 666 | 614 | public static function append_new_template_to_nav( $nav_items, $nav_args ) { |
| 667 | 615 | $is_new_template = FrmAppHelper::simple_get( 'new_template' ); |
| @@ -725,18 +673,17 @@ | ||
| 725 | 673 | * @return array |
| 726 | 674 | */ |
| 727 | 675 | private static function get_js_variables() { |
| 728 | 676 | $js_variables = array( |
| 729 | - 'FEATURED_TEMPLATES_IDS' => self::FEATURED_TEMPLATES_IDS, | |
| 730 | - 'FREE_TEMPLATES_IDS' => self::FREE_TEMPLATES_IDS, | |
| 731 | - 'templatesCount' => self::get_template_count(), | |
| 732 | - 'favoritesCount' => array( | |
| 677 | + 'FEATURED_TEMPLATES_KEYS' => self::FEATURED_TEMPLATES_KEYS, | |
| 678 | + 'templatesCount' => self::get_template_count(), | |
| 679 | + 'favoritesCount' => array( | |
| 733 | 680 | 'total' => self::get_favorite_templates_count(), |
| 734 | 681 | 'default' => count( self::$favorite_templates['default'] ), |
| 735 | 682 | 'custom' => count( self::$favorite_templates['custom'] ), |
| 736 | 683 | ), |
| 737 | - 'customCount' => count( self::$custom_templates ), | |
| 738 | - 'upgradeLink' => self::$upgrade_link, | |
| 684 | + 'customCount' => count( self::$custom_templates ), | |
| 685 | + 'upgradeLink' => self::$upgrade_link, | |
| 739 | 686 | ); |
| 740 | 687 | |
| 741 | 688 | /** |
| 742 | 689 | * Filters `js_variables` passed to the "Form Templates". |