EE_Admin

Complexity

Total Complexity

71

Size/Duplication

Total Lines	786
Duplicated Lines	2.16 %

Coupling/Cohesion

Components	1
Dependencies	16

Importance

Changes

0

30 Methods

Rating	Name	Duplication	Size	Complexity
A	instance()	0	8	2
A	reset()	0	5	1
B	__construct()	0	25	1
A	_define_all_constants()	9	10	2
B	filter_plugin_actions()	0	25	4
A	get_request()	0	5	1
A	hide_admin_pages_except_maintenance_mode()	0	8	1
B	init()	0	29	5
A	remove_pages_from_nav_menu()	0	13	2
C	enable_hidden_ee_nav_menu_metaboxes()	0	38	7
A	register_custom_nav_menu_boxes()	0	5	1
A	modify_edit_post_link()	0	14	3
B	ee_cpt_archive_pages()	0	86	4
A	_get_extra_nav_menu_pages_items()	8	9	1
B	_setup_extra_nav_menu_pages_items()	0	26	3
A	route_admin_request()	0	3	1
A	wp_loaded()	0	3	1
B	admin_init()	0	25	3
A	modify_dropdown_pages()	0	21	4
B	enqueue_admin_scripts()	0	25	2
A	display_admin_notices()	0	4	1
A	get_persistent_admin_notices()	0	10	3
A	dismiss_ee_nag_notice_callback()	0	4	1
B	dashboard_glance_items()	0	29	3
C	check_for_invalid_datetime_formats()	0	49	8
A	its_eSpresso()	0	4	1
A	espresso_admin_footer()	0	4	1
A	register_ee_admin_page()	0	11	2
A	parse_post_content_on_save()	0	8	1
A	reset_page_for_posts_on_change()	0	8	1

<?php

use EventEspresso\core\interfaces\InterminableInterface;

if (! defined('EVENT_ESPRESSO_VERSION')) {
    exit('No direct script access allowed');
}

/**
 * Event Espresso
 * Event Registration and Management Plugin for WordPress
 * @ package            Event Espresso
 * @ author            Seth Shoultes
 * @ copyright        (c) 2008-2011 Event Espresso  All Rights Reserved.
 * @ license            http://eventespresso.com/support/terms-conditions/   * see Plugin Licensing *
 * @ link                    http://www.eventespresso.com
 * @ version            4.0
 * ------------------------------------------------------------------------
 * EE_Admin
 *
 * @package               Event Espresso
 * @subpackage            /core/admin/
 * @author                Brent Christensen
 * ------------------------------------------------------------------------
 */
final class EE_Admin implements InterminableInterface
{

    /**
     * @access private
     * @var EE_Admin $_instance
     */
    private static $_instance;


    /**
     *@ singleton method used to instantiate class object
     *@ access public
     *@ return class instance
     *
     * @throws \EE_Error
     */
    public static function instance()
    {
        // check if class object is instantiated
        if (! self::$_instance instanceof EE_Admin) {
            self::$_instance = new self();
        }
        return self::$_instance;
    }


    /**
     * @return EE_Admin
     */
    public static function reset()
    {
        self::$_instance = null;
        return self::instance();
    }


    /**
     * class constructor
     *
     * @throws \EE_Error
     */
    protected function __construct()
    {
        // define global EE_Admin constants
        $this->_define_all_constants();
        // set autoloaders for our admin page classes based on included path information
        EEH_Autoloader::instance()->register_autoloaders_for_each_file_in_folder(EE_ADMIN);
        // admin hooks
        add_filter('plugin_action_links', array($this, 'filter_plugin_actions'), 10, 2);
        // load EE_Request_Handler early
        add_action('AHEE__EE_System__core_loaded_and_ready', array($this, 'get_request'));
        add_action('AHEE__EE_System__initialize_last', array($this, 'init'));
        add_action('AHEE__EE_Admin_Page__route_admin_request', array($this, 'route_admin_request'), 100, 2);
        add_action('wp_loaded', array($this, 'wp_loaded'), 100);
        add_action('admin_init', array($this, 'admin_init'), 100);
        add_action('admin_enqueue_scripts', array($this, 'enqueue_admin_scripts'), 20);
        add_action('admin_notices', array($this, 'display_admin_notices'), 10);
        add_action('network_admin_notices', array($this, 'display_admin_notices'), 10);
        add_filter('pre_update_option', array($this, 'check_for_invalid_datetime_formats'), 100, 2);
        add_filter('admin_footer_text', array($this, 'espresso_admin_footer'));

        //reset Environment config (we only do this on admin page loads);
        EE_Registry::instance()->CFG->environment->recheck_values();

        do_action('AHEE__EE_Admin__loaded');
    }


    /**
     * _define_all_constants
     * define constants that are set globally for all admin pages
     *
     * @access private
     * @return void
     */
    private function _define_all_constants()
    {
        if (! defined('EE_ADMIN_URL')) {
            define('EE_ADMIN_URL', EE_PLUGIN_DIR_URL . 'core/admin/');
            define('EE_ADMIN_PAGES_URL', EE_PLUGIN_DIR_URL . 'admin_pages/');
            define('EE_ADMIN_TEMPLATE', EE_ADMIN . 'templates' . DS);
            define('WP_ADMIN_PATH', ABSPATH . 'wp-admin/');
            define('WP_AJAX_URL', admin_url('admin-ajax.php'));
        }
    }


    /**
     *    filter_plugin_actions - adds links to the Plugins page listing
     *
     * @access    public
     * @param    array  $links
     * @param    string $plugin
     * @return    array
     */
    public function filter_plugin_actions($links, $plugin)
    {
        // set $main_file in stone
        static $main_file;
        // if $main_file is not set yet
        if (! $main_file) {
            $main_file = plugin_basename(EVENT_ESPRESSO_MAIN_FILE);
        }
        if ($plugin === $main_file) {
            // compare current plugin to this one
            if (EE_Maintenance_Mode::instance()->level() === EE_Maintenance_Mode::level_2_complete_maintenance) {
                $maintenance_link = '<a href="admin.php?page=espresso_maintenance_settings" title="Event Espresso is in maintenance mode.  Click this link to learn why.">' . __('Maintenance Mode Active',
                        'event_espresso') . '</a>';
                array_unshift($links, $maintenance_link);
            } else {
                $org_settings_link = '<a href="admin.php?page=espresso_general_settings">' . __('Settings',
                        'event_espresso') . '</a>';
                $events_link       = '<a href="admin.php?page=espresso_events">' . __('Events',
                        'event_espresso') . '</a>';
                // add before other links
                array_unshift($links, $org_settings_link, $events_link);
            }
        }
        return $links;
    }


    /**
     *    _get_request
     *
     * @access public
     * @return void
     */
    public function get_request()
    {
        EE_Registry::instance()->load_core('Request_Handler');
        EE_Registry::instance()->load_core('CPT_Strategy');
    }


    /**
     *    hide_admin_pages_except_maintenance_mode
     *
     * @access public
     * @param array $admin_page_folder_names
     * @return array
     */
    public function hide_admin_pages_except_maintenance_mode($admin_page_folder_names = array())
    {
        return array(
            'maintenance' => EE_ADMIN_PAGES . 'maintenance' . DS,
            'about'       => EE_ADMIN_PAGES . 'about' . DS,
            'support'     => EE_ADMIN_PAGES . 'support' . DS,
        );
    }


    /**
     * init- should fire after shortcode, module,  addon, other plugin (default priority), and even
     * EE_Front_Controller's init phases have run
     *
     * @access public
     * @return void
     */
    public function init()
    {
        //only enable most of the EE_Admin IF we're not in full maintenance mode
        if (EE_Maintenance_Mode::instance()->models_can_query()) {
            //ok so we want to enable the entire admin
            add_action('wp_ajax_dismiss_ee_nag_notice', array($this, 'dismiss_ee_nag_notice_callback'));
            add_action('admin_notices', array($this, 'get_persistent_admin_notices'), 9);
            add_action('network_admin_notices', array($this, 'get_persistent_admin_notices'), 9);
            //at a glance dashboard widget
            add_filter('dashboard_glance_items', array($this, 'dashboard_glance_items'), 10);
            //filter for get_edit_post_link used on comments for custom post types
            add_filter('get_edit_post_link', array($this, 'modify_edit_post_link'), 10, 2);
        }
        // run the admin page factory but ONLY if we are doing an ee admin ajax request
        if (! defined('DOING_AJAX') || EE_ADMIN_AJAX) {
            try {
                //this loads the controller for the admin pages which will setup routing etc
                EE_Registry::instance()->load_core('Admin_Page_Loader');
            } catch (EE_Error $e) {
                $e->get_error();
            }
        }
        add_filter('content_save_pre', array($this, 'its_eSpresso'), 10, 1);
        //make sure our CPTs and custom taxonomy metaboxes get shown for first time users
        add_action('admin_head', array($this, 'enable_hidden_ee_nav_menu_metaboxes'), 10);
        add_action('admin_head', array($this, 'register_custom_nav_menu_boxes'), 10);
        //exclude EE critical pages from all nav menus and wp_list_pages
        add_filter('nav_menu_meta_box_object', array($this, 'remove_pages_from_nav_menu'), 10);
    }


    /**
     * this simply hooks into the nav menu setup of pages metabox and makes sure that we remove EE critical pages from
     * the list of options. the wp function "wp_nav_menu_item_post_type_meta_box" found in
     * wp-admin/includes/nav-menu.php looks for the "_default_query" property on the post_type object and it uses that
     * to override any queries found in the existing query for the given post type.  Note that _default_query is not a
     * normal property on the post_type object.  It's found ONLY in this particular context.
     *
     * @param  object $post_type WP post type object
     * @return object            WP post type object
     */
    public function remove_pages_from_nav_menu($post_type)
    {
        //if this isn't the "pages" post type let's get out
        if ($post_type->name !== 'page') {
            return $post_type;
        }
        $critical_pages = EE_Registry::instance()->CFG->core->get_critical_pages_array();

        $post_type->_default_query = array(
            'post__not_in' => $critical_pages,
        );
        return $post_type;
    }


    /**
     * WP by default only shows three metaboxes in "nav-menus.php" for first times users.  We want to make sure our
     * metaboxes get shown as well
     *
     * @access public
     * @return void
     */
    public function enable_hidden_ee_nav_menu_metaboxes()
    {
        global $wp_meta_boxes, $pagenow;
        if (! is_array($wp_meta_boxes) || $pagenow !== 'nav-menus.php') {
            return;
        }
        $user = wp_get_current_user();
        //has this been done yet?
        if (get_user_option('ee_nav_menu_initialized', $user->ID)) {
            return;
        }

        $hidden_meta_boxes  = get_user_option('metaboxhidden_nav-menus', $user->ID);
        $initial_meta_boxes = apply_filters('FHEE__EE_Admin__enable_hidden_ee_nav_menu_boxes__initial_meta_boxes',
            array(
                'nav-menu-theme-locations',
                'add-page',
                'add-custom-links',
                'add-category',
                'add-espresso_events',
                'add-espresso_venues',
                'add-espresso_event_categories',
                'add-espresso_venue_categories',
                'add-post-type-post',
                'add-post-type-page',
            ));

        if (is_array($hidden_meta_boxes)) {
            foreach ($hidden_meta_boxes as $key => $meta_box_id) {
                if (in_array($meta_box_id, $initial_meta_boxes)) {
                    unset($hidden_meta_boxes[$key]);
                }
            }
        }

        update_user_option($user->ID, 'metaboxhidden_nav-menus', $hidden_meta_boxes, true);
        update_user_option($user->ID, 'ee_nav_menu_initialized', 1, true);
    }


    /**
     * This method simply registers custom nav menu boxes for "nav_menus.php route"
     * Currently EE is using this to make sure there are menu options for our CPT archive page routes.
     *
     * @todo   modify this so its more dynamic and automatic for all ee CPTs and setups and can also be hooked into by
     *         addons etc.
     * @access public
     * @return void
     */
    public function register_custom_nav_menu_boxes()
    {
        add_meta_box('add-extra-nav-menu-pages', __('Event Espresso Pages', 'event_espresso'),
            array($this, 'ee_cpt_archive_pages'), 'nav-menus', 'side', 'core');
    }


    /**
     * Use this to edit the post link for our cpts so that the edit link points to the correct page.
     *
     * @since   4.3.0
     * @param string $link the original link generated by wp
     * @param int    $id   post id
     * @return string  the (maybe) modified link
     */
    public function modify_edit_post_link($link, $id)
    {
        if (! $post = get_post($id)) {
            return $link;
        }
        if ($post->post_type === 'espresso_attendees') {
            $query_args = array(
                'action' => 'edit_attendee',
                'post'   => $id,
            );
            return EEH_URL::add_query_args_and_nonce($query_args, admin_url('admin.php?page=espresso_registrations'));
        }
        return $link;
    }


    public function ee_cpt_archive_pages()
    {
        global $nav_menu_selected_id;

        $db_fields   = false;
        $walker      = new Walker_Nav_Menu_Checklist($db_fields);
        $current_tab = 'event-archives';

        /*if ( ! empty( $_REQUEST['quick-search-posttype-' . $post_type_name] ) ) {
            $current_tab = 'search';
        }/**/

        $removed_args = array(
            'action',
            'customlink-tab',
            'edit-menu-item',
            'menu-item',
            'page-tab',
            '_wpnonce',
        );

        ?>
        <div id="posttype-extra-nav-menu-pages" class="posttypediv">
            <ul id="posttype-extra-nav-menu-pages-tabs" class="posttype-tabs add-menu-item-tabs">
                <li <?php echo('event-archives' === $current_tab ? ' class="tabs"' : ''); ?>>
                    <a class="nav-tab-link" data-type="tabs-panel-posttype-extra-nav-menu-pages-event-archives"
                       href="<?php if ($nav_menu_selected_id) {
                           echo esc_url(add_query_arg('extra-nav-menu-pages-tab', 'event-archives',
                               remove_query_arg($removed_args)));
                       } ?>#tabs-panel-posttype-extra-nav-menu-pages-event-archives">
                        <?php _e('Event Archive Pages', 'event_espresso'); ?>
                    </a>
                </li>
                <?php /* // temporarily removing but leaving skeleton in place in case we ever decide to add more tabs.
				<li <?php echo ( 'all' == $current_tab ? ' class="tabs"' : '' ); ?>>
					<a class="nav-tab-link" data-type="<?php echo esc_attr( $post_type_name ); ?>-all" href="<?php if ( $nav_menu_selected_id ) echo esc_url(add_query_arg($post_type_name . '-tab', 'all', remove_query_arg($removed_args))); ?>#<?php echo $post_type_name; ?>-all">
						<?php _e( 'View All' ); ?>
					</a>
				</li>
				<li <?php echo ( 'search' == $current_tab ? ' class="tabs"' : '' ); ?>>
					<a class="nav-tab-link" data-type="tabs-panel-posttype-extra-nav-menu-pages-search" href="<?php if ( $nav_menu_selected_id ) echo esc_url(add_query_arg('extra-nav-menu-pages-tab', 'search', remove_query_arg($removed_args))); ?>#tabs-panel-posttype-extra-nav-menu-pages-search">
						<?php _e( 'Search'); ?>
					</a>
				</li> -->
			</ul><!-- .posttype-tabs -->
 			<?php */ ?>

                <div id="tabs-panel-posttype-extra-nav-menu-pages-event-archives" class="tabs-panel <?php
                echo('event-archives' === $current_tab ? 'tabs-panel-active' : 'tabs-panel-inactive');
                ?>">
                    <ul id="extra-nav-menu-pageschecklist-event-archives" class="categorychecklist form-no-clear">
                        <?php
                        $pages          = $this->_get_extra_nav_menu_pages_items();
                        $args['walker'] = $walker;

$args was never initialized. Although not strictly required by PHP, it is generally a good practice to add $args = array(); before regardless.

                        echo walk_nav_menu_tree(array_map(array($this, '_setup_extra_nav_menu_pages_items'), $pages), 0,
                            (object)$args);
                        ?>
                    </ul>
                </div><!-- /.tabs-panel -->

                <p class="button-controls">
				<span class="list-controls">
					<a href="<?php
                    echo esc_url(add_query_arg(
                        array(
                            'extra-nav-menu-pages-tab' => 'event-archives',
                            'selectall'                => 1,
                        ),
                        remove_query_arg($removed_args)
                    ));
                    ?>#posttype-extra-nav-menu-pages>" class="select-all"><?php _e('Select All'); ?></a>
				</span>

                    <span class="add-to-menu">
					<input type="submit"<?php wp_nav_menu_disabled_check($nav_menu_selected_id); ?>
                           class="button-secondary submit-add-to-menu right"
                           value="<?php esc_attr_e(__('Add to Menu')); ?>" name="add-post-type-menu-item"
                           id="<?php esc_attr_e('submit-posttype-extra-nav-menu-pages'); ?>"/>
					<span class="spinner"></span>
				</span>
                </p>

        </div><!-- /.posttypediv -->

        <?php
    }


    /**
     * Returns an array of event archive nav items.
     *
     * @todo  for now this method is just in place so when it gets abstracted further we can substitute in whatever
     *        method we use for getting the extra nav menu items
     * @return array
     */
    private function _get_extra_nav_menu_pages_items()
    {
        $menuitems[] = array(

$menuitems was never initialized. Although not strictly required by PHP, it is generally a good practice to add $menuitems = array(); before regardless.

            'title'       => __('Event List', 'event_espresso'),
            'url'         => get_post_type_archive_link('espresso_events'),
            'description' => __('Archive page for all events.', 'event_espresso'),
        );
        return apply_filters('FHEE__EE_Admin__get_extra_nav_menu_pages_items', $menuitems);
    }


    /**
     * Setup nav menu walker item for usage in the event archive nav menu metabox.  It receives a menu_item array with
     * the properties and converts it to the menu item object.
     *
     * @see wp_setup_nav_menu_item() in wp-includes/nav-menu.php
     * @param $menu_item_values
     * @return stdClass
     */
    private function _setup_extra_nav_menu_pages_items($menu_item_values)
    {
        $menu_item = new stdClass();
        $keys      = array(
            'ID'               => 0,
            'db_id'            => 0,
            'menu_item_parent' => 0,
            'object_id'        => -1,
            'post_parent'      => 0,
            'type'             => 'custom',
            'object'           => '',
            'type_label'       => __('Extra Nav Menu Item', 'event_espresso'),
            'title'            => '',
            'url'              => '',
            'target'           => '',
            'attr_title'       => '',
            'description'      => '',
            'classes'          => array(),
            'xfn'              => '',
        );

        foreach ($keys as $key => $value) {
            $menu_item->{$key} = isset($menu_item_values[$key]) ? $menu_item_values[$key] : $value;
        }
        return $menu_item;
    }


    /**
     * This is the action hook for the AHEE__EE_Admin_Page__route_admin_request hook that fires off right before an
     * EE_Admin_Page route is called.
     *
     * @return void
     */
    public function route_admin_request()
    {
    }


    /**
     * wp_loaded should fire on the WordPress wp_loaded hook.  This fires on a VERY late priority.
     *
     * @return void
     */
    public function wp_loaded()
    {
    }


    /**
     * admin_init
     *
     * @access public
     * @return void
     */
    public function admin_init()
    {

        /**
         * our cpt models must be instantiated on WordPress post processing routes (wp-admin/post.php),
         * so any hooking into core WP routes is taken care of.  So in this next few lines of code:
         * - check if doing post processing.
         * - check if doing post processing of one of EE CPTs
         * - instantiate the corresponding EE CPT model for the post_type being processed.
         */
        if (isset($_POST['action'], $_POST['post_type']) && $_POST['action'] === 'editpost') {
            EE_Registry::instance()->load_core('Register_CPTs');
            EE_Register_CPTs::instantiate_cpt_models($_POST['post_type']);
        }


        /**
         * This code excludes EE critical pages anywhere `wp_dropdown_pages` is used to create a dropdown for selecting
         * critical pages.  The only place critical pages need included in a generated dropdown is on the "Critical Pages"
         * tab in the EE General Settings Admin page.
         * This is for user-proofing.
         */
        add_filter('wp_dropdown_pages', array($this, 'modify_dropdown_pages'));

    }


    /**
     * Callback for wp_dropdown_pages hook to remove ee critical pages from the dropdown selection.
     *
     * @param string $output Current output.
     * @return string
     */
    public function modify_dropdown_pages($output)
    {
        //get critical pages
        $critical_pages = EE_Registry::instance()->CFG->core->get_critical_pages_array();

        //split current output by line break for easier parsing.
        $split_output = explode("\n", $output);

        //loop through to remove any critical pages from the array.
        foreach ($critical_pages as $page_id) {
            $needle = 'value="' . $page_id . '"';
            foreach ($split_output as $key => $haystack) {
                if (strpos($haystack, $needle) !== false) {
                    unset($split_output[$key]);
                }
            }
        }

        //replace output with the new contents
        return implode("\n", $split_output);
    }


    /**
     * enqueue all admin scripts that need loaded for admin pages
     *
     * @access public
     * @return void
     */
    public function enqueue_admin_scripts()
    {
        // this javascript is loaded on every admin page to catch any injections ee needs to add to wp run js.
        // Note: the intention of this script is to only do TARGETED injections.  I.E, only injecting on certain script calls.
        wp_enqueue_script('ee-inject-wp', EE_ADMIN_URL . 'assets/ee-cpt-wp-injects.js', array('jquery'),
            EVENT_ESPRESSO_VERSION, true);
        // register cookie script for future dependencies
        wp_register_script('jquery-cookie', EE_THIRD_PARTY_URL . 'joyride/jquery.cookie.js', array('jquery'), '2.1',
            true);
        //joyride is turned OFF by default, but prior to the admin_enqueue_scripts hook, can be turned back on again vai: add_filter('FHEE_load_joyride', '__return_true' );
        if (apply_filters('FHEE_load_joyride', false)) {
            //joyride style
            wp_register_style('joyride-css', EE_THIRD_PARTY_URL . 'joyride/joyride-2.1.css', array(), '2.1');
            wp_register_style('ee-joyride-css', EE_GLOBAL_ASSETS_URL . 'css/ee-joyride-styles.css',
                array('joyride-css'), EVENT_ESPRESSO_VERSION);
            wp_register_script('joyride-modernizr', EE_THIRD_PARTY_URL . 'joyride/modernizr.mq.js', array(), '2.1',
                true);
            //joyride JS
            wp_register_script('jquery-joyride', EE_THIRD_PARTY_URL . 'joyride/jquery.joyride-2.1.js',
                array('jquery-cookie', 'joyride-modernizr'), '2.1', true);
            // wanna go for a joyride?
            wp_enqueue_style('ee-joyride-css');
            wp_enqueue_script('jquery-joyride');
        }
    }


    /**
     *    display_admin_notices
     *
     * @access    public
     * @return    string
     */
    public function display_admin_notices()
    {
        echo EE_Error::get_notices();
    }


    /**
     *    get_persistent_admin_notices
     *
     * @access    public
     * @return        void
     */
    public function get_persistent_admin_notices()
    {
        // http://www.example.com/wp-admin/admin.php?page=espresso_general_settings&action=critical_pages&critical_pages_nonce=2831ce0f30
        $args       = array(
            'page'   => EE_Registry::instance()->REQ->is_set('page') ? EE_Registry::instance()->REQ->get('page') : '',
            'action' => EE_Registry::instance()->REQ->is_set('action') ? EE_Registry::instance()->REQ->get('action') : '',
        );
        $return_url = EE_Admin_Page::add_query_args_and_nonce($args, EE_ADMIN_URL);
        echo EE_Error::get_persistent_admin_notices($return_url);
    }


    /**
     *    dismiss_persistent_admin_notice
     *
     * @access    public
     * @return        void
     */
    public function dismiss_ee_nag_notice_callback()
    {
        EE_Error::dismiss_persistent_admin_notice();
    }


    /**
     * @param array $elements
     * @return array
     * @throws \EE_Error
     */
    public function dashboard_glance_items($elements)
    {
        $elements                        = is_array($elements) ? $elements : array($elements);
        $events                          = EEM_Event::instance()->count();
        $items['events']['url']          = EE_Admin_Page::add_query_args_and_nonce(array('page' => 'espresso_events'),

$items was never initialized. Although not strictly required by PHP, it is generally a good practice to add $items = array(); before regardless.

            admin_url('admin.php'));
        $items['events']['text']         = sprintf(_n('%s Event', '%s Events', $events), number_format_i18n($events));
        $items['events']['title']        = __('Click to view all Events', 'event_espresso');
        $registrations                   = EEM_Registration::instance()->count(
            array(
                array(
                    'STS_ID' => array('!=', EEM_Registration::status_id_incomplete),
                ),
            )
        );
        $items['registrations']['url']   = EE_Admin_Page::add_query_args_and_nonce(array('page' => 'espresso_registrations'),
            admin_url('admin.php'));
        $items['registrations']['text']  = sprintf(_n('%s Registration', '%s Registrations', $registrations),
            number_format_i18n($registrations));
        $items['registrations']['title'] = __('Click to view all registrations', 'event_espresso');

        $items = (array)apply_filters('FHEE__EE_Admin__dashboard_glance_items__items', $items);

        foreach ($items as $type => $item_properties) {
            $elements[] = sprintf('<a class="ee-dashboard-link-' . $type . '" href="%s" title="%s">%s</a>',
                $item_properties['url'], $item_properties['title'], $item_properties['text']);
        }
        return $elements;
    }


    /**
     *    check_for_invalid_datetime_formats
     *    if an admin changes their date or time format settings on the WP General Settings admin page, verify that
     *    their selected format can be parsed by PHP
     *
     * @access    public
     * @param    $value
     * @param    $option
     * @throws EE_Error
     * @return    string
     */
    public function check_for_invalid_datetime_formats($value, $option)
    {
        // check for date_format or time_format
        switch ($option) {
            case 'date_format' :
                $date_time_format = $value . ' ' . get_option('time_format');
                break;
            case 'time_format' :
                $date_time_format = get_option('date_format') . ' ' . $value;
                break;
            default :
                $date_time_format = false;
        }
        // do we have a date_time format to check ?
        if ($date_time_format) {

The expression $date_time_format of type string|false is loosely compared to true; this is ambiguous if the string can be empty. You might want to explicitly use !== false instead.

            $error_msg = EEH_DTT_Helper::validate_format_string($date_time_format);

            if (is_array($error_msg)) {
                $msg = '<p>' . sprintf(__('The following date time "%s" ( %s ) is difficult to be properly parsed by PHP for the following reasons:',
                        'event_espresso'), date($date_time_format), $date_time_format) . '</p><p><ul>';


                foreach ($error_msg as $error) {
                    $msg .= '<li>' . $error . '</li>';
                }

                $msg .= '</ul></p><p>' . sprintf(__('%sPlease note that your date and time formats have been reset to "F j, Y" and "g:i a" respectively.%s',
                        'event_espresso'), '<span style="color:#D54E21;">', '</span>') . '</p>';

                // trigger WP settings error
                add_settings_error(
                    'date_format',
                    'date_format',
                    $msg
                );

                // set format to something valid
                switch ($option) {
                    case 'date_format' :
                        $value = 'F j, Y';
                        break;
                    case 'time_format' :
                        $value = 'g:i a';
                        break;
                }
            }
        }
        return $value;
    }


    /**
     *    its_eSpresso - converts the less commonly used spelling of "Expresso" to "Espresso"
     *
     * @access    public
     * @param $content
     * @return    string
     */
    public function its_eSpresso($content)
    {
        return str_replace('[EXPRESSO_', '[ESPRESSO_', $content);
    }


    /**
     *    espresso_admin_footer
     *
     * @access    public
     * @return    string
     */
    public function espresso_admin_footer()
    {
        return \EEH_Template::powered_by_event_espresso('aln-cntr', '', array('utm_content' => 'admin_footer'));
    }


    /**
     * static method for registering ee admin page.
     * This method is deprecated in favor of the new location in EE_Register_Admin_Page::register.
     *
     * @since      4.3.0
     * @deprecated 4.3.0    Use EE_Register_Admin_Page::register() instead
     * @see        EE_Register_Admin_Page::register()
     * @param       $page_basename
     * @param       $page_path
     * @param array $config
     * @return void
     */
    public static function register_ee_admin_page($page_basename, $page_path, $config = array())
    {
        EE_Error::doing_it_wrong(__METHOD__,
            sprintf(__('Usage is deprecated.  Use EE_Register_Admin_Page::register() for registering the %s admin page.',
                'event_espresso'), $page_basename), '4.3');
        if (class_exists('EE_Register_Admin_Page')) {
            $config['page_path'] = $page_path;
        }
        EE_Register_Admin_Page::register($page_basename, $config);

    }


    /**
     * @deprecated 4.8.41
     * @access     public
     * @param  int      $post_ID
     * @param  \WP_Post $post
     * @return void
     */
    public static function parse_post_content_on_save($post_ID, $post)
    {
        EE_Error::doing_it_wrong(
            __METHOD__,
            __('Usage is deprecated', 'event_espresso'),
            '4.8.41'
        );
    }


    /**
     * @deprecated 4.8.41
     * @access     public
     * @param  $option
     * @param  $old_value
     * @param  $value
     * @return void
     */
    public function reset_page_for_posts_on_change($option, $old_value, $value)
    {
        EE_Error::doing_it_wrong(
            __METHOD__,
            __('Usage is deprecated', 'event_espresso'),
            '4.8.41'
        );
    }

}
// End of file EE_Admin.core.php
// Location: /core/admin/EE_Admin.core.php