$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 as $id => $section ) { ?>
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';
}
}