$theme->get( 'Name' ), 'theme-slug' => $theme->get( 'TextDomain' ), 'author-logo' => get_template_directory_uri() . '/includes/libraries/welcome-screen/img/logo-cpothemes.png', 'actions' => array(), 'plugins' => array(), 'notice' => '', 'sections' => array(), 'edd' => false, 'download_id' => '', ); $config = wp_parse_args( $config, $defaults ); /** * Configure our welcome screen */ $this->theme_name = $config['theme-name']; $this->theme_slug = $config['theme-slug']; $this->author_logo = $config['author-logo']; $this->actions = $config['actions']; $this->actions_count = $this->count_actions(); $this->plugins = $config['plugins']; $this->notice = $config['notice']; $this->sections = $config['sections']; $this->edd = $config['edd']; $this->download_id = $config['download_id']; if ( $this->edd ) { $this->strings = EDD_Theme_Helper::get_strings(); } if ( empty( $config['sections'] ) ) { $this->sections = $this->set_default_sections( $config ); } /** * Create the dashboard page */ add_action( 'admin_menu', array( $this, 'welcome_screen_menu' ) ); /** * Load the welcome screen styles and scripts */ add_action( 'admin_enqueue_scripts', array( $this, 'enqueue' ) ); /** * Add the notice in the admin backend */ $this->add_admin_notice(); /** * Ajax callbacks */ add_action( 'wp_ajax_welcome_screen_ajax_callback', array( $this, 'welcome_screen_ajax_callback', ) ); add_action( 'wp_ajax_nopriv_welcome_screen_ajax_callback', array( $this, 'welcome_screen_ajax_callback', ) ); if ( $this->edd ) { /** * Initiate EDD Stuff */ add_action( 'admin_init', array( 'EDD_Theme_Helper', 'init' ) ); add_filter( 'http_request_args', array( 'EDD_Theme_Helper', 'disable_wporg_request' ), 5, 2 ); add_action( 'update_option_' . $this->theme_slug . '_license_key', array( 'EDD_Theme_Helper', 'license_activator_deactivator', ), 10, 2 ); } } /** * AJAX Handler */ public function welcome_screen_ajax_callback() { if ( isset( $_POST['args'], $_POST['args']['nonce'] ) && ! wp_verify_nonce( sanitize_key( $_POST['args']['nonce'] ), 'welcome_nonce' ) ) { wp_die( wp_json_encode( array( 'status' => false, 'error' => esc_html__( 'Not allowed', 'epsilon-framework' ), ) ) ); } $args_action = array_map( 'sanitize_text_field', wp_unslash( $_POST['args']['action'] ) ); if ( count( $args_action ) !== 2 ) { wp_die( wp_json_encode( array( 'status' => false, 'error' => esc_html__( 'Not allowed', 'epsilon-framework' ), ) ) ); } if ( ! class_exists( $args_action[0] ) ) { wp_die( wp_json_encode( array( 'status' => false, 'error' => esc_html__( 'Class does not exist', 'epsilon-framework' ), ) ) ); } $class = $args_action[0]; $method = $args_action[1]; $args = array(); // if ( is_array( $_POST['args']['args'] ) ) { // $args = Epsilon_Sanitizers::array_map_recursive( 'sanitize_text_field', wp_unslash( $_POST['args']['args'] ) ); // } $args = $_POST['args']['args']; $response = $class::$method( $args ); if ( is_array( $response ) ) { wp_die( wp_json_encode( $response ) ); } if ( 'ok' === $response ) { wp_die( wp_json_encode( array( 'status' => true, 'message' => 'ok', ) ) ); } wp_die( wp_json_encode( array( 'status' => false, 'message' => 'nok', ) ) ); } /** * Instance constructor * * @param array $config Configuration array. * * @returns object */ public static function get_instance( $config = array() ) { static $inst; if ( ! $inst ) { $inst = new Epsilon_Welcome_Screen( $config ); } return $inst; } /** * Load welcome screen css and javascript */ public function enqueue() { if ( is_admin() ) { wp_enqueue_style( 'welcome-screen', get_template_directory_uri() . '/includes/libraries/welcome-screen/css/welcome.css' ); wp_enqueue_script( 'welcome-screen', get_template_directory_uri() . '/includes/libraries/welcome-screen/js/welcome.js', array( 'jquery-ui-slider', ), '12123' ); wp_localize_script( 'welcome-screen', 'welcomeScreen', array( 'nr_actions_required' => absint( $this->count_actions() ), 'template_directory' => esc_url( get_template_directory_uri() ), 'no_required_actions_text' => esc_html__( 'Hooray! There are no required actions for you right now.', 'epsilon-framework' ), 'ajax_nonce' => wp_create_nonce( 'welcome_nonce' ), 'activating_string' => esc_html__( 'Activating', 'epsilon-framework' ), 'body_class' => 'appearance_page_' . $this->theme_slug . '-welcome', 'no_actions' => esc_html__( 'Hooray! There are no required actions for you right now.', 'epsilon-framework' ), ) ); } } /** * Return the actions left * * @return array|mixed */ private function get_actions_left() { if ( ! empty( $this->actions ) ) { $actions_left = get_option( $this->theme_slug . '_actions_left', array() ); return $actions_left; } return array(); } /** * Returns the plugins left to be installed * * @return array|mixed */ private function get_plugins_left() { if ( ! empty( $this->plugins ) ) { $plugins_left = get_option( $this->theme_slug . '_plugins_left', array() ); if ( empty( $plugins_left ) ) { foreach ( $this->plugins as $plugin => $prop ) { $plugins_left[ $plugin ] = true; } return $plugins_left; } return $plugins_left; } return array(); } /** * Adds an admin notice in the backend * * If the Epsilon Notification class does not exist, we stop */ private function add_admin_notice() { if ( ! class_exists( 'Epsilon_Notifications' ) ) { return; } if ( CPOTheme_Notify_System::check_content_import() ) { return; } if ( empty( $this->notice ) ) { /* Translators: Notice Title */ $this->notice .= '

' . sprintf( esc_html__( 'Welcome to %1$s', 'epsilon-framework' ), $this->theme_name ) . '

'; $this->notice .= '

'; $this->notice .= sprintf( /* Translators: Notice */ esc_html__( 'Welcome! Thank you for choosing %3$s! To fully take advantage of the best our theme can offer please make sure you visit our %1$swelcome page%2$s.', 'epsilon-framework' ), '', '', $this->theme_name ); $this->notice .= '

'; /* Translators: Notice URL */ $this->notice .= '

' . sprintf( esc_html__( 'Get started with %1$s', 'epsilon-framework' ), $this->theme_name ) . '

'; } $notifications = Epsilon_Notifications::get_instance(); $notifications->add_notice( array( 'id' => 'affluent_welcome_notification', 'type' => 'notice notice-success', 'message' => $this->notice, ) ); } /** * Registers the welcome screen menu */ public function welcome_screen_menu() { /* Translators: Menu Title */ $title = sprintf( esc_html__( 'About %1$s', 'epsilon-framework' ), esc_html( $this->theme_name ) ); if ( 0 < $this->actions_count ) { $title .= '' . esc_html( $this->actions_count ) . ''; } add_theme_page( $this->theme_name, $title, 'edit_theme_options', $this->theme_slug . '-welcome', array( $this, 'render_welcome_screen', ) ); } /** * Render the welcome screen */ public function render_welcome_screen() { require_once( ABSPATH . 'wp-load.php' ); require_once( ABSPATH . 'wp-admin/admin.php' ); require_once( ABSPATH . 'wp-admin/admin-header.php' ); $theme = wp_get_theme(); $tab = isset( $_GET['tab'] ) ? sanitize_text_field( wp_unslash( $_GET['tab'] ) ) : 'getting-started'; ?>

theme_name ) ) . esc_html( $theme['Version'] ); ?>

theme_name ) ); ?>
sections[ $tab ]['path']; ?>
theme_slug . '_actions_left', array() ); $i = 0; foreach ( $this->actions as $action ) { $true = false; if ( ! $action['check'] ) { $true = true; } if ( ! empty( $actions_left ) && isset( $actions_left[ $action['id'] ] ) && ! $actions_left[ $action['id'] ] ) { $true = false; } if ( $true ) { $i ++; } } return $i; } /** * Generate url for the backend section tabs * * @param string $id Id of the backend tab. * * @return string */ private function generate_admin_url( $id = '' ) { $url = 'themes.php?page=%1$s-welcome&tab=%2$s'; return admin_url( sprintf( $url, $this->theme_slug, $id ) ); } /** * Generate default sections, with exclusion * * @param array $config Configuration array. * * @return array */ private function set_default_sections( $config = array() ) { $arr = array( 'getting-started' => array( 'id' => 'getting-started', 'url' => $this->generate_admin_url( 'getting-started' ), 'label' => __( 'Getting Started', 'epsilon-framework' ), 'path' => get_template_directory() . '/includes/libraries/welcome-screen/sections/getting-started.php', ), 'recommended-actions' => array( 'id' => 'recommended-actions', 'url' => $this->generate_admin_url( 'recommended-actions' ), 'label' => __( 'Recommended Actions', 'epsilon-framework' ), 'path' => get_template_directory() . '/includes/libraries/welcome-screen/sections/recommended-actions.php', ), 'recommended-plugins' => array( 'id' => 'recommended-plugins', 'url' => $this->generate_admin_url( 'recommended-plugins' ), 'label' => __( 'Recommended Plugins', 'epsilon-framework' ), 'path' => get_template_directory() . '/includes/libraries/welcome-screen/sections/recommended-plugins.php', ), 'support' => array( 'id' => 'support', 'url' => $this->generate_admin_url( 'support' ), 'label' => __( 'Support', 'epsilon-framework' ), 'path' => get_template_directory() . '/includes/libraries/welcome-screen/sections/support.php', ), 'features' => array( 'id' => 'features', 'url' => $this->generate_admin_url( 'features' ), 'label' => __( 'Lite VS PRO', 'epsilon-framework' ), 'path' => get_template_directory() . '/includes/libraries/welcome-screen/sections/features.php', ), 'registration' => array( 'id' => 'registration', 'url' => $this->generate_admin_url( 'registration' ), 'label' => __( 'Registration', 'epsilon-framework' ), 'path' => get_template_directory() . '/includes/libraries/welcome-screen/sections/registration.php', ), ); if ( 0 === count( $this->plugins ) ) { unset( $arr['recommended-plugins'] ); } if ( 0 < $this->actions_count ) { $arr['recommended-actions']['label'] .= '' . $this->actions_count . ''; } if ( ! $this->edd ) { unset( $arr['registration'] ); } if ( isset( $config['sections_exclude'] ) && ! empty( $config['sections_exclude'] ) ) { foreach ( $config['sections_exclude'] as $id ) { unset( $arr[ $id ] ); } } if ( isset( $config['sections_include'] ) && ! empty( $config['sections_include'] ) ) { foreach ( $config['sections_include'] as $id => $props ) { $arr[ $id ] = $props; } } return $arr; } /** * Will return an array with everything that we need to render the action info * * @param string $slug Plugin slug. * * @returns array */ private function check_plugin( $slug = '' ) { $arr = array( 'installed' => CPOTheme_Notify_System::check_plugin_is_installed( $slug ), 'active' => CPOTheme_Notify_System::check_plugin_is_active( $slug ), 'needs' => 'install', 'class' => 'install-now button', 'label' => __( 'Install and Activate', 'epsilon-framework' ), ); if ( in_array( $slug, array( 'contact-form-7' ) ) ) { switch ( $slug ) { case 'contact-form-7': if ( file_exists( ABSPATH . 'wp-content/plugins/contact-form-7' ) ) { $arr['installed'] = true; $arr['active'] = defined( 'WPCF7_VERSION' ); } break; default: $arr['installed'] = false; $arr['active'] = false; break; } } if ( $arr['installed'] ) { $arr['needs'] = 'activate'; $arr['class'] = 'activate-now button button-primary'; $arr['label'] = __( 'Activate now', 'epsilon-framework' ); } if ( $arr['active'] ) { $arr['needs'] = 'deactivate'; $arr['class'] = 'deactivate-now button button-primary'; $arr['label'] = __( 'Deactivate now', 'epsilon-framework' ); } $arr['url'] = $this->create_plugin_link( $arr['needs'], $slug ); return $arr; } /** * Creates a link to install/activate/deactivate certain plugins * * @param string $state Plugin state (active,not installed). * @param string $slug Plugin slug. * * @return string */ private function create_plugin_link( $state, $slug ) { $string = ''; switch ( $state ) { case 'install': $string = wp_nonce_url( add_query_arg( array( 'action' => 'install-plugin', 'plugin' => CPOTheme_Notify_System::_get_plugin_basename_from_slug( $slug ), ), network_admin_url( 'update.php' ) ), 'install-plugin_' . $slug ); break; case 'deactivate': $string = add_query_arg( array( 'action' => 'deactivate', 'plugin' => rawurlencode( CPOTheme_Notify_System::_get_plugin_basename_from_slug( $slug ) ), 'plugin_status' => 'all', 'paged' => '1', '_wpnonce' => wp_create_nonce( 'deactivate-plugin_' . CPOTheme_Notify_System::_get_plugin_basename_from_slug( $slug ) ), ), admin_url( 'plugins.php' ) ); break; case 'activate': $string = add_query_arg( array( 'action' => 'activate', 'plugin' => rawurlencode( CPOTheme_Notify_System::_get_plugin_basename_from_slug( $slug ) ), 'plugin_status' => 'all', 'paged' => '1', '_wpnonce' => wp_create_nonce( 'activate-plugin_' . CPOTheme_Notify_System::_get_plugin_basename_from_slug( $slug ) ), ), admin_url( 'plugins.php' ) ); break; default: $string = ''; break; }// End switch(). return $string; } /** * Return information of a plugin * * @param string $slug Plugin slug. * * @return array */ private function get_plugin_information( $slug = '' ) { $arr = array( 'info' => $this->call_plugin_api( $slug ), ); $arr['icon'] = $this->check_for_icon( $arr['info']->icons ); $merge = $this->check_plugin( $slug ); $arr = array_merge( $arr, $merge ); return $arr; } /** * Get information about a plugin * * @param string $slug Plugin slug. * * @return array|mixed|object|WP_Error */ private function call_plugin_api( $slug = '' ) { include_once ABSPATH . 'wp-admin/includes/plugin-install.php'; $call_api = get_transient( $this->theme_slug . '_plugin_information_transient_' . $slug ); if ( false === $call_api ) { $call_api = plugins_api( 'plugin_information', array( 'slug' => $slug, 'fields' => array( 'downloaded' => false, 'rating' => false, 'description' => false, 'short_description' => true, 'donate_link' => false, 'tags' => false, 'sections' => true, 'homepage' => true, 'added' => false, 'last_updated' => false, 'compatibility' => false, 'tested' => false, 'requires' => false, 'downloadlink' => false, 'icons' => true, ), ) ); set_transient( $this->theme_slug . '_plugin_information_transient_' . $slug, $call_api, 30 * MINUTE_IN_SECONDS ); } return $call_api; } /** * Searches icons for the plugin * * @param object $object Icon object. * * @return string; */ private function check_for_icon( $object ) { if ( ! empty( $object['svg'] ) ) { $plugin_icon_url = $object['svg']; } elseif ( ! empty( $object['2x'] ) ) { $plugin_icon_url = $object['2x']; } elseif ( ! empty( $object['1x'] ) ) { $plugin_icon_url = $object['1x']; } else { $plugin_icon_url = $object['default']; } return $plugin_icon_url; } /** * Handle a required action * * @param array $args Argument array. * * @return string; */ public static function handle_required_action( $args = array() ) { $instance = self::get_instance(); $actions_left = get_option( $instance->theme_slug . '_actions_left', array() ); $actions_left[ $args['id'] ] = 'hidden' === $args['do']; update_option( $instance->theme_slug . '_actions_left', $actions_left ); return 'ok'; } /** * Set a frontpage to static * * @param array $args Argument array. * * @return string; */ public static function set_frontpage_to_static( $args = array() ) { $home = get_page_by_title( 'Homepage' ); $blog = get_page_by_title( 'Blog' ); if ( null === $home ) { $id = wp_insert_post( array( 'post_title' => __( 'Homepage', 'epsilon-framework' ), 'post_type' => 'page', 'post_status' => 'publish', ) ); update_option( 'page_on_front', $id ); update_option( 'show_on_front', 'page' ); } if ( null === $blog ) { $id = wp_insert_post( array( 'post_title' => __( 'Blog', 'epsilon-framework' ), 'post_type' => 'page', 'post_status' => 'publish', ) ); update_option( 'page_for_posts', $id ); } return 'ok'; } }