ninja-forms.php 25.8 KB
Newer Older
1
<?php
Kevin Stover's avatar
Kevin Stover committed
2 3
/*
Plugin Name: Ninja Forms
4
Plugin URI: http://ninjaforms.com/
Kevin Stover's avatar
Kevin Stover committed
5
Description: Ninja Forms is a webform builder with unparalleled ease of use and features.
KR Moorhouse's avatar
KR Moorhouse committed
6
Version: 3.2.16
Kevin Stover's avatar
Kevin Stover committed
7
Author: The WP Ninjas
8
Author URI: http://ninjaforms.com
9 10
Text Domain: ninja-forms
Domain Path: /lang/
11

Kevin Stover's avatar
Kevin Stover committed
12
Copyright 2016 WP Ninjas.
Kevin Stover's avatar
Kevin Stover committed
13
*/
Kathy's avatar
Kathy committed
14

15
require_once dirname( __FILE__ ) . '/lib/NF_VersionSwitcher.php';
16
require_once dirname( __FILE__ ) . '/lib/NF_Tracking.php';
17
require_once dirname( __FILE__ ) . '/lib/NF_Conversion.php';
18
require_once dirname( __FILE__ ) . '/lib/NF_ExceptionHandlerJS.php';
19
require_once dirname( __FILE__ ) . '/lib/Conversion/Calculations.php';
20
require_once dirname( __FILE__ ) . '/lib/NF_UpgradeThrottle.php';
Dwarve's avatar
Dwarve committed
21

22 23 24 25 26 27
function ninja_forms_three_table_exists(){
    global $wpdb;
    $table_name = $wpdb->prefix . 'nf3_forms';
    return ( $wpdb->get_var("SHOW TABLES LIKE '$table_name'") == $table_name );
}

28
if( get_option( 'ninja_forms_load_deprecated', FALSE ) && ! ( isset( $_POST[ 'nf2to3' ] ) && ( defined( 'DOING_AJAX' ) && DOING_AJAX ) ) ){
29 30 31 32

    include 'deprecated/ninja-forms.php';

    register_activation_hook( __FILE__, 'ninja_forms_activation_deprecated' );
33

34 35
    function ninja_forms_activation_deprecated( $network_wide ){
        include_once 'deprecated/includes/activation.php';
36

37 38 39 40 41
        ninja_forms_activation( $network_wide );
    }

} else {

42
    include_once 'lib/NF_Upgrade.php';
43
    include_once 'lib/NF_AddonChecker.php';
44

45
    include_once plugin_dir_path( __FILE__ ) . 'includes/deprecated.php';
46 47 48 49 50 51 52 53 54 55

    /**
     * Class Ninja_Forms
     */
    final class Ninja_Forms
    {

        /**
         * @since 3.0
         */
KR Moorhouse's avatar
KR Moorhouse committed
56
        const VERSION = '3.2.16';
57

58
        const WP_MIN_VERSION = '4.7';
59

60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113
        /**
         * @var Ninja_Forms
         * @since 2.7
         */
        private static $instance;

        /**
         * Plugin Directory
         *
         * @since 3.0
         * @var string $dir
         */
        public static $dir = '';

        /**
         * Plugin URL
         *
         * @since 3.0
         * @var string $url
         */
        public static $url = '';

        /**
         * Admin Menus
         *
         * @since 3.0
         * @var array
         */
        public $menus = array();

        /**
         * AJAX Controllers
         *
         * @since 3.0
         * @var array
         */
        public $controllers = array();

        /**
         * Form Fields
         *
         * @since 3.0
         * @var array
         */
        public $fields = array();

        /**
         * Form Actions
         *
         * @since 3.0
         * @var array
         */
        public $actions = array();

Kyle B. Johnson's avatar
Kyle B. Johnson committed
114 115 116 117 118 119 120 121
        /**
         * Merge Tags
         *
         * @since 3.0
         * @var array
         */
        public $merge_tags = array();

122 123 124 125 126 127 128 129
        /**
         * Metaboxes
         *
         * @since 3.0
         * @var array
         */
        public $metaboxes = array();

130 131 132 133 134 135 136 137 138 139 140 141 142 143
        /**
         * Model Factory
         *
         * @var object
         */
        public $factory = '';

        /**
         * Logger
         *
         * @var string
         */
        protected $_logger = '';

144 145 146 147 148 149 150
        /**
         * Dispatcher
         *
         * @var string
         */
        protected $_dispatcher = '';

151 152 153 154 155
        /**
         * @var NF_Session
         */
        protected $session = '';

156 157 158 159 160
        /**
         * @var NF_Tracking
         */
        public $tracking;

161 162 163 164 165 166 167 168
        /**
         * Plugin Settings
         *
         * @since 3.0
         * @var array
         */
        protected $settings = array();

169 170
        protected $requests = array();

171 172
        protected $processes = array();

173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189
        /**
         * Main Ninja_Forms Instance
         *
         * Insures that only one instance of Ninja_Forms exists in memory at any one
         * time. Also prevents needing to define globals all over the place.
         *
         * @since 2.7
         * @static
         * @staticvar array $instance
         * @return Ninja_Forms Highlander Instance
         */
        public static function instance()
        {
            if ( ! isset( self::$instance ) && ! ( self::$instance instanceof Ninja_Forms ) ) {
                self::$instance = new Ninja_Forms;

                self::$dir = plugin_dir_path( __FILE__ );
190 191

                // Define old constants for backwards compatibility.
192 193
                if( ! defined( 'NF_PLUGIN_DIR' ) ){
                    define( 'NF_PLUGIN_DIR', self::$dir );
194
                    define( 'NINJA_FORMS_DIR', self::$dir . 'deprecated' );
195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212
                }

                self::$url = plugin_dir_url( __FILE__ );
                if( ! defined( 'NF_PLUGIN_URL' ) ){
                    define( 'NF_PLUGIN_URL', self::$url );
                }

                update_option( 'ninja_forms_version', self::VERSION );

                /*
                 * Register our autoloader
                 */
                spl_autoload_register( array( self::$instance, 'autoloader' ) );

                /*
                 * Admin Menus
                 */
                self::$instance->menus[ 'forms' ]           = new NF_Admin_Menus_Forms();
213
                self::$instance->menus[ 'dashboard' ]       = new NF_Admin_Menus_Dashboard();
214 215 216
                self::$instance->menus[ 'add-new' ]         = new NF_Admin_Menus_AddNew();
                self::$instance->menus[ 'submissions']      = new NF_Admin_Menus_Submissions();
                self::$instance->menus[ 'import-export']    = new NF_Admin_Menus_ImportExport();
Kyle B. Johnson's avatar
Kyle B. Johnson committed
217
                self::$instance->menus[ 'settings' ]        = new NF_Admin_Menus_Settings();
218
                self::$instance->menus[ 'licenses']         = new NF_Admin_Menus_Licenses();
Kyle B. Johnson's avatar
Kyle B. Johnson committed
219 220
                self::$instance->menus[ 'system_status']    = new NF_Admin_Menus_SystemStatus();
                self::$instance->menus[ 'add-ons' ]         = new NF_Admin_Menus_Addons();
221
                self::$instance->menus[ 'divider']          = new NF_Admin_Menus_Divider();
222 223 224 225 226
                self::$instance->menus[ 'mock-data']        = new NF_Admin_Menus_MockData();

                /*
                 * AJAX Controllers
                 */
227 228 229 230 231
                self::$instance->controllers[ 'form' ]          = new NF_AJAX_Controllers_Form();
                self::$instance->controllers[ 'preview' ]       = new NF_AJAX_Controllers_Preview();
                self::$instance->controllers[ 'submission' ]    = new NF_AJAX_Controllers_Submission();
                self::$instance->controllers[ 'savedfields' ]   = new NF_AJAX_Controllers_SavedFields();
                self::$instance->controllers[ 'jserror' ]       = new NF_AJAX_Controllers_JSError();
232

233 234 235 236 237 238
                /*
                 * REST Controllers
                 */
                self::$instance->controllers[ 'REST' ][ 'forms' ] = new NF_AJAX_REST_Forms();
                self::$instance->controllers[ 'REST' ][ 'new-form-templates' ] = new NF_AJAX_REST_NewFormTemplates();

239 240 241 242 243 244
                /*
                 * Async Requests
                 */
                require_once Ninja_Forms::$dir . 'includes/Libraries/BackgroundProcessing/classes/wp-async-request.php';
                self::$instance->requests[ 'delete-field' ] = new NF_AJAX_Requests_DeleteField();

245 246 247 248 249 250
                /*
                 * Background Processes
                 */
                require_once Ninja_Forms::$dir . 'includes/Libraries/BackgroundProcessing/wp-background-processing.php';
                self::$instance->requests[ 'update-fields' ] = new NF_AJAX_Processes_UpdateFields();

251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271
                /*
                 * WP-CLI Commands
                 */
                if( class_exists( 'WP_CLI_Command' ) ) {
                    WP_CLI::add_command('ninja-forms', 'NF_WPCLI_NinjaFormsCommand');
                }

                /*
                 * Preview Page
                 */
                self::$instance->preview = new NF_Display_Preview();

                /*
                 * Shortcodes
                 */
                self::$instance->shortcodes = new NF_Display_Shortcodes();

                /*
                 * Submission CPT
                 */
                new NF_Admin_CPT_Submission();
272 273
                new NF_Admin_CPT_DownloadAllSubmissions();
                require_once Ninja_Forms::$dir . 'lib/StepProcessing/menu.php';
274

KR Moorhouse's avatar
KR Moorhouse committed
275 276 277 278
                /*
                 * Submission Metabox
                 */
                new NF_Admin_Metaboxes_Calculations();
279 280 281 282 283 284

                /*
                 * Logger
                 */
                self::$instance->_logger = new NF_Database_Logger();

285 286 287 288 289
                /*
                 * Dispatcher
                 */
                self::$instance->_dispatcher = new NF_Dispatcher();

290 291 292
                /*
                 * Merge Tags
                 */
Kevin Stover's avatar
Kevin Stover committed
293
                self::$instance->merge_tags[ 'wp' ] = new NF_MergeTags_WP();
294 295
                self::$instance->merge_tags[ 'fields' ] = new NF_MergeTags_Fields();
                self::$instance->merge_tags[ 'calcs' ] = new NF_MergeTags_Calcs();
Kyle B. Johnson's avatar
Kyle B. Johnson committed
296
                self::$instance->merge_tags[ 'form' ] = new NF_MergeTags_Form();
297
                self::$instance->merge_tags[ 'other' ] = new NF_MergeTags_Other();
Kevin Stover's avatar
Kevin Stover committed
298
                self::$instance->merge_tags[ 'deprecated' ] = new NF_MergeTags_Deprecated();
299 300 301 302 303 304 305 306 307 308 309 310 311 312

                /*
                 * Add Form Modal
                 */
                self::$instance->add_form_modal = new NF_Admin_AddFormModal();

                /*
                 * EOS Parser
                 */
                self::$instance->_eos[ 'parser' ] = require_once 'includes/Libraries/EOS/Parser.php';

                /*
                 * Plugin Settings
                 */
313
                self::$instance->settings = apply_filters( 'ninja_forms_settings', get_option( 'ninja_forms_settings' ) );
314 315 316 317 318 319

                /*
                 * Admin Notices System
                 */
                self::$instance->notices = new NF_Admin_Notices();

Kyle B. Johnson's avatar
Kyle B. Johnson committed
320 321
                self::$instance->widgets[] = new NF_Widget();

322 323 324 325 326
                /*
                 * Gutenberg
                 */
                self::$instance->gutenblock = new NF_FormBlock();

327 328 329 330 331
                /*
                 * Opt-In Tracking
                 */
                self::$instance->tracking = new NF_Tracking();

332 333
                /*
                 * JS Exception Handler
334 335
                 *
                 * TODO: Review PR#2492 for improvements.
336
                 */
337
                // self::$instance->exception_handler_js = new NF_ExceptionHandlerJS();
338

339 340 341 342 343 344
                /*
                 * Activation Hook
                 * TODO: Move to a permanent home.
                 */
                register_activation_hook( __FILE__, array( self::$instance, 'activation' ) );

345
                self::$instance->metaboxes[ 'append-form' ] = new NF_Admin_Metaboxes_AppendAForm();
346 347 348 349 350 351 352 353 354 355 356 357 358 359 360

                /*
                 * Require EDD auto-update file
                 */
                if( ! class_exists( 'EDD_SL_Plugin_Updater' ) ) {
                    // Load our custom updater if it doesn't already exist
                    require_once( self::$dir . 'includes/Integrations/EDD/EDD_SL_Plugin_Updater.php');
                }
                require_once self::$dir . 'includes/Integrations/EDD/class-extension-updater.php';
            }

            add_action( 'admin_notices', array( self::$instance, 'admin_notices' ) );

            add_action( 'plugins_loaded', array( self::$instance, 'plugins_loaded' ) );

361 362
            add_action( 'ninja_forms_available_actions', array( self::$instance, 'scrub_available_actions' ) );

363 364 365
            add_action( 'init', array( self::$instance, 'init' ), 5 );
            add_action( 'admin_init', array( self::$instance, 'admin_init' ), 5 );

366 367 368
            return self::$instance;
        }

369 370 371 372 373 374 375 376
        public function init()
        {
            do_action( 'nf_init', self::$instance );
        }

        public function admin_init()
        {
            do_action( 'nf_admin_init', self::$instance );
377 378 379
            if ( isset ( $_GET[ 'nf-upgrade' ] ) && 'complete' == $_GET[ 'nf-upgrade' ] ) {
                Ninja_Forms()->dispatcher()->send( 'upgrade' );
            }
380 381 382

            add_filter( 'ninja_forms_dashboard_menu_items', array( $this, 'maybe_hide_dashboard_items' ) );
        }
383

384 385 386 387 388 389 390 391 392 393
        public function maybe_hide_dashboard_items( $items )
        {
            $disable_marketing = false;
            if ( apply_filters( 'ninja_forms_disable_marketing', $disable_marketing ) ) {
                unset(
                    $items[ 'apps' ],
                    $items[ 'memberships' ]
                );
            }
            return $items;
394 395
        }

396 397 398 399 400 401 402 403 404
        public function scrub_available_actions( $actions )
        {
            foreach( $actions as $key => $action ){
                if ( ! is_plugin_active( $action[ 'plugin_path' ] ) )  continue;
                unset( $actions[ $key ] );
            }
            return $actions;
        }

405 406 407 408 409 410 411 412 413
        public function admin_notices()
        {
            // Notices filter and run the notices function.
            $admin_notices = Ninja_Forms()->config( 'AdminNotices' );
            self::$instance->notices->admin_notice( apply_filters( 'nf_admin_notices', $admin_notices ) );
        }

        public function plugins_loaded()
        {
414 415
            load_plugin_textdomain( 'ninja-forms', false, basename( dirname( __FILE__ ) ) . '/lang' );

416 417 418 419 420
            /*
             * Field Class Registration
             */
            self::$instance->fields = apply_filters( 'ninja_forms_register_fields', self::load_classes( 'Fields' ) );

421 422 423 424 425 426 427 428 429
            if( ! apply_filters( 'ninja_forms_enable_credit_card_fields', false ) ){
                unset( self::$instance->fields[ 'creditcard' ] );
                unset( self::$instance->fields[ 'creditcardcvc' ] );
                unset( self::$instance->fields[ 'creditcardexpiration' ] );
                unset( self::$instance->fields[ 'creditcardfullname' ] );
                unset( self::$instance->fields[ 'creditcardnumber' ] );
                unset( self::$instance->fields[ 'creditcardzip' ] );
            }

430 431 432 433 434
            /*
             * Form Action Registration
             */
            self::$instance->actions = apply_filters( 'ninja_forms_register_actions', self::load_classes( 'Actions' ) );

Kyle B. Johnson's avatar
Kyle B. Johnson committed
435 436 437 438 439
            /*
             * Merge Tag Registration
             */
            self::$instance->merge_tags = apply_filters( 'ninja_forms_register_merge_tags', self::$instance->merge_tags );

440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490 491
            /*
             * It's Ninja Time: Hook for Extensions
             */
            do_action( 'ninja_forms_loaded' );

        }

        /**
         * Autoloader
         *
         * Autoload Ninja Forms classes
         *
         * @param $class_name
         */
        public function autoloader( $class_name )
        {
            if( class_exists( $class_name ) ) return;

            /* Ninja Forms Prefix */
            if (false !== strpos($class_name, 'NF_')) {
                $class_name = str_replace('NF_', '', $class_name);
                $classes_dir = realpath(plugin_dir_path(__FILE__)) . DIRECTORY_SEPARATOR . 'includes' . DIRECTORY_SEPARATOR;
                $class_file = str_replace('_', DIRECTORY_SEPARATOR, $class_name) . '.php';
                if (file_exists($classes_dir . $class_file)) {
                    require_once $classes_dir . $class_file;
                }
            }

            /* WP Ninjas Prefix */
            if (false !== strpos($class_name, 'WPN_')) {
                $class_name = str_replace('WPN_', '', $class_name);
                $classes_dir = realpath(plugin_dir_path(__FILE__)) . DIRECTORY_SEPARATOR . 'includes' . DIRECTORY_SEPARATOR;
                $class_file = str_replace('_', DIRECTORY_SEPARATOR, $class_name) . '.php';
                if (file_exists($classes_dir . $class_file)) {
                    require_once $classes_dir . $class_file;
                }
            }
        }

        /*
         * PUBLIC API WRAPPERS
         */

        /**
         * Form Model Factory Wrapper
         *
         * @param $id
         * @return NF_Abstracts_ModelFactory
         */
        public function form( $id = '' )
        {
            global $wpdb;
492

Kevin Stover's avatar
Kevin Stover committed
493 494 495 496
            static $forms;
            if ( isset ( $forms[ $id ] ) ) {
                return $forms[ $id ];
            }
497

Kevin Stover's avatar
Kevin Stover committed
498 499
            $forms[ $id ] = new NF_Abstracts_ModelFactory( $wpdb, $id );
            return $forms[ $id ];
500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515
        }

        /**
         * Logger Class Wrapper
         *
         * Example Use:
         * Ninja_Forms()->logger()->log( 'debug', "Hello, {name}!", array( 'name' => 'world' ) );
         * Ninja_Forms()->logger()->debug( "Hello, {name}!", array( 'name' => 'world' ) );
         *
         * @return string
         */
        public function logger()
        {
            return $this->_logger;
        }

516 517 518 519 520
        public function dispatcher()
        {
            return $this->_dispatcher;
        }

521 522
        public function eos()
        {
523
            return new NF_EOS_Parser();
524 525 526 527
        }

        public function session()
        {
528 529 530 531
            if( ! $this->session ){
                $this->session = new NF_Session();
                $this->session->init();
            }
532 533 534
            return $this->session;
        }

535 536 537 538 539 540 541
        public function request( $action )
        {
            if( ! isset( $this->requests[ $action ] ) ) return new NF_AJAX_Requests_NullRequest();

            return $this->requests[ $action ];
        }

542 543 544 545 546 547 548
        public function background_process( $action )
        {
            if( ! isset( $this->requests[ $action ] ) ) return new NF_AJAX_Processes_NullProcess();

            return $this->requests[ $action ];
        }

549 550 551 552 553 554 555 556
	    /**
	     * Get a setting
	     *
	     * @param string     $key
	     * @param bool|false $default
	     * @return bool
	     */
        public function get_setting( $key = '', $default = false )
557
        {
558
            if( empty( $key ) || ! isset( $this->settings[ $key ] ) || empty( $this->settings[ $key ] ) ) return $default;
559 560 561 562

            return $this->settings[ $key ];
        }

563 564 565 566 567
	    /**
	     * Get all the settings
	     *
	     * @return array
	     */
568 569 570 571 572
        public function get_settings()
        {
            return ( is_array( $this->settings ) ) ? $this->settings : array();
        }

573 574 575 576 577 578 579 580
	    /**
	     * Update a setting
	     *
	     * @param string           $key
	     * @param mixed           $value
	     * @param bool|false $defer_update Defer the database update of all settings
	     */
        public function update_setting( $key, $value, $defer_update = false )
581
        {
582 583 584 585
	        $this->settings[ $key ] = $value;
	        if ( ! $defer_update ) {
		        $this->update_settings();
	        }
586 587
        }

588 589 590 591 592
	    /**
	     * Save settings to database
	     *
	     * @param array $settings
	     */
593 594
        public function update_settings( $settings = array() )
        {
595
            if( ! is_array( $this->settings ) ) $this->settings = array();
596 597 598 599 600 601 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 618 619 620 621 622 623 624 625 626 627 628 629 630 631 632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662 663 664 665 666 667 668 669 670 671 672

            if( $settings && is_array( $settings ) ) {
                $this->settings = array_merge($this->settings, $settings);
            }

            update_option( 'ninja_forms_settings', $this->settings );
        }


        /**
         * Display Wrapper
         *
         * @param $form_id
         */
        public function display( $form_id, $preview = FALSE )
        {
            if( ! $form_id ) return;

            $noscript_message = __( 'Notice: JavaScript is required for this content.', 'ninja-forms' );
            $noscript_message = apply_filters( 'ninja_forms_noscript_message', $noscript_message );

            Ninja_Forms()->template( 'display-noscript-message.html.php', array( 'message' => $noscript_message ) );

            if( ! $preview ) {
                NF_Display_Render::localize($form_id);
            } else {
                NF_Display_Render::localize_preview($form_id);
            }
        }



        /*
         * PRIVATE METHODS
         */

        /**
         * Load Classes from Directory
         *
         * @param string $prefix
         * @return array
         */
        private static function load_classes( $prefix = '' )
        {
            $return = array();

            $subdirectory = str_replace( '_', DIRECTORY_SEPARATOR, str_replace( 'NF_', '', $prefix ) );

            $directory = 'includes/' . $subdirectory;

            foreach (scandir( self::$dir . $directory ) as $path) {

                $path = explode( DIRECTORY_SEPARATOR, str_replace( self::$dir, '', $path ) );
                $filename = str_replace( '.php', '', end( $path ) );

                $class_name = 'NF_' . $prefix . '_' . $filename;

                if( ! class_exists( $class_name ) ) continue;

                $return[ strtolower( $filename ) ] = new $class_name;
            }

            return $return;
        }



        /*
         * STATIC METHODS
         */

        /**
         * Template
         *
         * @param string $file_name
         * @param array $data
         */
673
        public static function template( $file_name = '', array $data = array(), $return = FALSE )
674
        {
675
            if( ! $file_name ) return FALSE;
676 677 678

            extract( $data );

679 680 681 682 683 684 685
            $path = self::$dir . 'includes/Templates/' . $file_name;

            if( ! file_exists( $path ) ) return FALSE;

            if( $return ) return file_get_contents( $path );

            include $path;
686 687 688 689 690 691 692 693 694 695 696 697 698 699 700 701 702 703 704
        }

        /**
         * Config
         *
         * @param $file_name
         * @return mixed
         */
        public static function config( $file_name )
        {
            return include self::$dir . 'includes/Config/' . $file_name . '.php';
        }

        /**
         * Activation
         */
        public function activation() {
            $migrations = new NF_Database_Migrations();
            $migrations->migrate();
705

706 707
            if( Ninja_Forms()->form()->get_forms() ) return;

708 709
            $form = Ninja_Forms::template( 'formtemplate-contactform.nff', array(), TRUE );
            Ninja_Forms()->form()->import_form( $form );
710 711
        }

712 713 714 715 716 717 718 719 720 721 722 723 724 725 726 727 728 729 730 731 732 733 734 735 736 737 738 739 740 741
        /**
         * Deprecated Notice
         *
         * Example: Ninja_Forms::deprecated_hook( 'ninja_forms_old', '3.0', 'ninja_forms_new', debug_backtrace() );
         *
         * @param $deprecated
         * @param $version
         * @param null $replacement
         * @param null $backtrace
         */
        public static function deprecated_notice( $deprecated, $version, $replacement = null, $backtrace = null )
        {
            do_action( 'ninja_forms_deprecated_call', $deprecated, $replacement, $version );

            $show_errors = current_user_can( 'manage_options' );

            // Allow plugin to filter the output error trigger
            if ( WP_DEBUG && apply_filters( 'ninja_forms_deprecated_function_trigger_error', $show_errors ) ) {
                if ( ! is_null( $replacement ) ) {
                    trigger_error( sprintf( __( '%1$s is <strong>deprecated</strong> since Ninja Forms version %2$s! Use %3$s instead.', 'ninja-forms' ), $deprecated, $version, $replacement ) );
                    // trigger_error(  print_r( $backtrace, 1 ) ); // Limited to previous 1028 characters, but since we only need to move back 1 in stack that should be fine.
                    // Alternatively we could dump this to a file.
                } else {
                    trigger_error( sprintf( __( '%1$s is <strong>deprecated</strong> since Ninja Forms version %2$s.', 'ninja-forms' ), $deprecated, $version ) );
                    // trigger_error( print_r( $backtrace, 1 ) );// Limited to previous 1028 characters, but since we only need to move back 1 in stack that should be fine.
                    // Alternatively we could dump this to a file.
                }
            }
        }

742 743 744 745 746 747 748 749 750 751 752 753 754 755 756 757 758 759 760 761 762 763 764
    } // End Class Ninja_Forms



    /**
     * The main function responsible for returning The Highlander Ninja_Forms
     * Instance to functions everywhere.
     *
     * Use this function like you would a global variable, except without needing
     * to declare the global.
     *
     * Example: <?php $nf = Ninja_Forms(); ?>
     *
     * @since 2.7
     * @return Ninja_Forms Highlander Instance
     */
    function Ninja_Forms()
    {
        return Ninja_Forms::instance();
    }

    Ninja_Forms();

765 766 767 768 769 770
    /*
    |--------------------------------------------------------------------------
    | Uninstall Hook
    |--------------------------------------------------------------------------
    */

Kyle B. Johnson's avatar
Kyle B. Johnson committed
771
    register_uninstall_hook( __FILE__, 'ninja_forms_uninstall' );
772 773

    function ninja_forms_uninstall(){
774

Kyle B. Johnson's avatar
Kyle B. Johnson committed
775
        if( Ninja_Forms()->get_setting( 'delete_on_uninstall' ) ) {
776 777 778
            require_once plugin_dir_path(__FILE__) . '/includes/Database/Migrations.php';
            $migrations = new NF_Database_Migrations();
            $migrations->nuke(TRUE, TRUE);
Kyle Johnson's avatar
Kyle Johnson committed
779
            $migrations->nuke_settings(TRUE, TRUE);
780
            $migrations->nuke_deprecated(TRUE, TRUE);
781 782
        }
    }
783

784
    // Scheduled Action Hook
785 786 787
    function nf_optin_update_environment_vars() {
        /**
         * Send updated environment variables.
788
         */
789
        Ninja_Forms()->dispatcher()->update_environment_vars();
790 791 792 793 794

        /**
         * Make sure that we've reported our opt-in.
         */
        if( get_option( 'ninja_forms_optin_reported', 0 ) ) return;
795

796 797 798
        Ninja_Forms()->dispatcher()->send( 'optin', array( 'send_email' => 1 ) );
        // Debounce opt-in dispatch.
        update_option( 'ninja_forms_optin_reported', 1 );
799
    }
800
    add_action( 'nf_optin_cron', 'nf_optin_update_environment_vars' );
801

802 803
    // Custom Cron Recurrences
    function nf_custom_cron_job_recurrence( $schedules ) {
804 805
        $schedules[ 'nf-monthly' ] = array(
            'display' => __( 'Once per month', 'ninja-forms' ),
806 807 808 809 810
            'interval' => 2678400,
        );
        return $schedules;
    }
    add_filter( 'cron_schedules', 'nf_custom_cron_job_recurrence' );
811

812 813 814 815 816
    // Schedule Cron Job Event
    function nf_optin_send_admin_email_cron_job() {
        if ( ! wp_next_scheduled( 'nf_optin_cron' ) ) {
            wp_schedule_event( current_time( 'timestamp' ), 'nf-monthly', 'nf_optin_cron' );
        }
817
    }
818 819

    add_action( 'wp', 'nf_optin_send_admin_email_cron_job' );
Kyle Johnson's avatar
Kyle Johnson committed
820
}