config = $config; self::$instance->setup_config(); self::$instance->setup_actions(); } } } /** * Setup the class props based on the config array. */ public function setup_config() { $theme = wp_get_theme(); if ( is_child_theme() && is_object( $theme->parent() ) ) { $this->theme_name = $theme->parent()->get( 'Name' ); $this->theme = $theme->parent(); } else { $this->theme_name = $theme->get( 'Name' ); $this->theme = $theme->parent(); } $this->theme_version = $theme->get( 'Version' ); $this->theme_slug = $theme->get_template(); $this->menu_name = isset( $this->config['menu_name'] ) ? $this->config['menu_name'] : 'About ' . $this->theme_name; $this->page_name = isset( $this->config['page_name'] ) ? $this->config['page_name'] : 'About ' . $this->theme_name; $this->notification = isset( $this->config['notification'] ) ? $this->config['notification'] : ( '

' . sprintf( 'Welcome! Thank you for choosing %1$s! To fully take advantage of the best our theme can offer please make sure you visit our %2$swelcome page%3$s.', $this->theme_name, '', '' ) . '

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

' ); $this->tabs = isset( $this->config['tabs'] ) ? $this->config['tabs'] : array(); } /** * Setup the actions used for this page. */ public function setup_actions() { add_action( 'admin_menu', array( $this, 'register' ) ); /* activation notice */ add_action( 'load-themes.php', array( $this, 'activation_admin_notice' ) ); /* enqueue script and style for about page */ add_action( 'admin_enqueue_scripts', array( $this, 'style_and_scripts' ) ); /* ajax callback for dismissable required actions */ add_action( 'wp_ajax_ti_about_page_dismiss_required_action', array( $this, 'dismiss_required_action_callback' ) ); add_action( 'wp_ajax_nopriv_ti_about_page_dismiss_required_action', array( $this, 'dismiss_required_action_callback') ); } /** * Hide required tab if no actions present. * * @return bool Either hide the tab or not. */ public function hide_required( $value, $tab ) { if ( $tab != 'recommended_actions' ) { return $value; } $required = $this->get_required_actions(); if ( count( $required ) == 0 ) { return false; } else { return true; } } /** * Register the menu page under Appearance menu. */ function register() { if ( ! empty( $this->menu_name ) && ! empty( $this->page_name ) ) { $count = 0; $actions_count = $this->get_required_actions(); if ( ! empty( $actions_count ) ) { $count = count( $actions_count ); } $title = $count > 0 ? $this->page_name . '' . esc_html( $count ) . '' : $this->page_name; add_theme_page( $this->menu_name, $title, 'activate_plugins', $this->theme_slug . '-welcome', array( $this, 'about_page_render', ) ); } } /** * Adds an admin notice upon successful activation. */ public function activation_admin_notice() { global $pagenow; if ( is_admin() && ( 'themes.php' == $pagenow ) && isset( $_GET['activated'] ) ) { add_action( 'admin_notices', array( $this, 'welcome_admin_notice' ), 99 ); } } /** * Display an admin notice linking to the about page */ public function welcome_admin_notice() { if ( ! empty( $this->notification ) ) { echo '
'; echo wp_kses_post( $this->notification ); echo '
'; } } /** * Render the main content page. */ public function about_page_render() { if ( ! empty( $this->config['welcome_title'] ) ) { $welcome_title = $this->config['welcome_title']; } if ( ! empty( $this->config['welcome_content'] ) ) { $welcome_content = $this->config['welcome_content']; } if ( ! empty( $welcome_title ) || ! empty( $welcome_content ) || ! empty( $this->tabs ) ) { echo '
'; if ( ! empty( $welcome_title ) ) { echo '

'; echo esc_html( $welcome_title ); if ( ! empty( $this->theme_version ) ) { echo esc_html( $this->theme_version ) . ' '; } echo '

'; } if ( ! empty( $welcome_content ) ) { echo '
' . wp_kses_post( $welcome_content ) . '
'; } echo ''; /* Display tabs */ if ( ! empty( $this->tabs ) ) { $active_tab = isset( $_GET['tab'] ) ? sanitize_text_field( wp_unslash( $_GET['tab'] ) ) : 'getting_started'; echo '

'; $actions_count = $this->get_required_actions(); $count = 0; if ( ! empty( $actions_count ) ) { $count = count( $actions_count ); } foreach ( $this->tabs as $tab_key => $tab_name ) { if ( ( $tab_key != 'changelog' ) || ( ( $tab_key == 'changelog' ) && isset( $_GET['show'] ) && ( $_GET['show'] == 'yes' ) ) ) { if ( ( $count == 0 ) && ( $tab_key == 'recommended_actions' ) ) { continue; } echo ''; echo esc_html( $tab_name ); if ( $tab_key == 'recommended_actions' ) { $count = 0; $actions_count = $this->get_required_actions(); if ( ! empty( $actions_count ) ) { $count = count( $actions_count ); } if ( $count > 0 ) { echo '' . esc_html( $count ) . ''; } } echo ''; } } echo '

'; /* Display content for current tab */ if ( method_exists( $this, $active_tab ) ) { $this->$active_tab(); } } echo '
'; } } /* * Call plugin api */ public function call_plugin_api( $slug ) { include_once( ABSPATH . 'wp-admin/includes/plugin-install.php' ); if ( false === ( $call_api = get_transient( 'ti_about_page_plugin_information_transient_' . $slug ) ) ) { $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( 'ti_about_page_plugin_information_transient_' . $slug, $call_api, 30 * MINUTE_IN_SECONDS ); } return $call_api; } public function check_if_plugin_active( $slug ) { if( ( $slug == 'intergeo-maps' ) || ( $slug == 'visualizer' ) ) { $plugin_root_file = 'index'; } elseif ( $slug == 'adblock-notify-by-bweb' ) { $plugin_root_file = 'adblock-notify'; } else { $plugin_root_file = $slug; } $path = WPMU_PLUGIN_DIR . '/' . $slug . '/' . $plugin_root_file . '.php'; if ( ! file_exists( $path ) ) { $path = WP_PLUGIN_DIR . '/' . $slug . '/' . $plugin_root_file . '.php'; if ( ! file_exists( $path ) ) { $path = false; } } if ( file_exists( $path ) ) { include_once( ABSPATH . 'wp-admin/includes/plugin.php' ); $needs = is_plugin_active( $slug . '/' . $plugin_root_file . '.php' ) ? 'deactivate' : 'activate'; return array( 'status' => is_plugin_active( $slug . '/' . $plugin_root_file . '.php' ), 'needs' => $needs ); } return array( 'status' => false, 'needs' => 'install' ); } /** * Get icon of wordpress.org plugin * @param $arr * * @return mixed */ public function get_plugin_icon( $arr ) { if ( ! empty( $arr['svg'] ) ) { $plugin_icon_url = $arr['svg']; } elseif ( ! empty( $arr['2x'] ) ) { $plugin_icon_url = $arr['2x']; } elseif ( ! empty( $arr['1x'] ) ) { $plugin_icon_url = $arr['1x']; } else { $plugin_icon_url = get_template_directory_uri() . '/includes/admin/about-page/images/placeholder_plugin.png'; } return $plugin_icon_url; } public function create_action_link( $state, $slug ) { if( ( $slug == 'intergeo-maps' ) || ( $slug == 'visualizer' ) ) { $plugin_root_file = 'index'; } elseif ( $slug == 'adblock-notify-by-bweb' ) { $plugin_root_file = 'adblock-notify'; } else { $plugin_root_file = $slug; } switch ( $state ) { case 'install': return wp_nonce_url( add_query_arg( array( 'action' => 'install-plugin', 'plugin' => $slug ), network_admin_url( 'update.php' ) ), 'install-plugin_' . $slug ); break; case 'deactivate': return add_query_arg( array( 'action' => 'deactivate', 'plugin' => rawurlencode( $slug . '/' . $plugin_root_file . '.php' ), 'plugin_status' => 'all', 'paged' => '1', '_wpnonce' => wp_create_nonce( 'deactivate-plugin_' . $slug . '/' . $plugin_root_file . '.php' ), ), network_admin_url( 'plugins.php' ) ); break; case 'activate': return add_query_arg( array( 'action' => 'activate', 'plugin' => rawurlencode( $slug . '/' . $plugin_root_file . '.php' ), 'plugin_status' => 'all', 'paged' => '1', '_wpnonce' => wp_create_nonce( 'activate-plugin_' . $slug . '/' . $plugin_root_file . '.php' ), ), network_admin_url( 'plugins.php' ) ); break; } } /** * Getting started tab */ public function getting_started() { if ( ! empty( $this->config['getting_started'] ) ) { $getting_started = $this->config['getting_started']; if ( ! empty( $getting_started ) ) { echo '
'; foreach ( $getting_started as $getting_started_item ) { echo '
'; if ( ! empty( $getting_started_item['title'] ) ) { echo '

' . esc_html( $getting_started_item['title'] ) . '

'; } if ( ! empty( $getting_started_item['text'] ) ) { echo '

' . esc_html( $getting_started_item['text'] ). '

'; } if ( ! empty( $getting_started_item['button_link'] ) && ! empty( $getting_started_item['button_label'] ) ) { echo '

'; $button_class = ''; if ( $getting_started_item['is_button'] ) { $button_class = 'button button-primary'; } $count = 0; $actions_count = $this->get_required_actions(); if ( ! empty( $actions_count ) ) { $count = count( $actions_count ); } if ( $getting_started_item['recommended_actions'] && isset( $count ) ) { if ( $count == 0 ) { echo ''; echo '' . esc_html( $getting_started_item['button_ok_label'] ). ''; } else { echo ''; $button_new_tab = '_self'; if ( isset( $getting_started_item['is_new_tab'] ) ) { if ( $getting_started_item['is_new_tab'] ) { $button_new_tab = '_blank'; } } echo '' .esc_html( $getting_started_item['button_label'] ) . ''; } } else { $button_new_tab = '_self'; if ( isset( $getting_started_item['is_new_tab'] ) ) { if ( $getting_started_item['is_new_tab'] ) { $button_new_tab = '_blank'; } } echo '' . esc_html( $getting_started_item['button_label'] ) . ''; } echo '

'; } echo '
'; } echo '
'; } } } /** * Recommended Actions tab */ public function recommended_actions() { $recommended_actions = isset( $this->config['recommended_actions'] ) ? $this->config['recommended_actions'] : array(); if ( ! empty( $recommended_actions ) ) { echo '
'; $actions = array(); $req_actions = isset( $this->config['recommended_actions'] ) ? $this->config['recommended_actions'] : array(); foreach ( $req_actions['content'] as $req_action ) { $actions[] = $req_action; } if ( ! empty( $actions ) && is_array( $actions ) ) { $ti_about_page_show_required_actions = get_option( $this->theme_slug . '_required_actions' ); $hooray = true; foreach ( $actions as $action_key => $action_value ) { $hidden = false; echo '
'; if ( ! $hidden ) { echo ''; } else { echo ''; } if ( ! empty( $action_value['title'] ) ) { echo '

' . wp_kses_post( $action_value['title'] ) . '

'; } if ( ! empty( $action_value['description'] ) ) { echo '

' . wp_kses_post( $action_value['description'] ) . '

'; } if ( ! empty( $action_value['plugin_slug'] ) ) { $active = $this->check_if_plugin_active( $action_value['plugin_slug'] ); $url = $this->create_action_link( $active['needs'], $action_value['plugin_slug'] ); $label = ''; switch ( $active['needs'] ) { case 'install': $class = 'install-now button'; if ( ! empty( $this->config['recommended_actions']['install_label'] ) ) { $label = $this->config['recommended_actions']['install_label']; } break; case 'activate': $class = 'activate-now button button-primary'; if ( ! empty( $this->config['recommended_actions']['activate_label'] ) ) { $label = $this->config['recommended_actions']['activate_label']; } break; case 'deactivate': $class = 'deactivate-now button'; if ( ! empty( $this->config['recommended_actions']['deactivate_label'] ) ) { $label = $this->config['recommended_actions']['deactivate_label']; } break; } ?>

'; } } echo '
'; } } /** * Recommended plugins tab */ public function recommended_plugins() { $recommended_plugins = $this->config['recommended_plugins']; if ( ! empty( $recommended_plugins ) ) { if ( ! empty( $recommended_plugins['content'] ) && is_array( $recommended_plugins['content'] ) ) { echo ''; } } } /** * Child themes */ public function child_themes() { echo '
'; $child_themes = isset( $this->config['child_themes'] ) ? $this->config['child_themes'] : array(); if ( ! empty( $child_themes ) ) { if ( ! empty( $child_themes['content'] ) && is_array( $child_themes['content'] ) ) { echo '
'; for ( $i = 0; $i < count( $child_themes['content'] ); $i ++ ) { if( ( $i !== 0 ) && ( $i / 3 === 0 ) ) { echo '
'; echo '
'; } $child = $child_themes['content'][ $i ]; if ( ! empty( $child['image'] ) ) { echo '
'; echo '
'; echo '' . ( ! empty( $child['image_alt'] ) ? esc_html( $child['image_alt'] ) : '' ) . ''; if ( ! empty( $child['title'] ) ) { echo '
'; if ( $child['title'] != $this->theme_name ) { echo '
'; echo '' . esc_html( $child['title'] ) . ''; if ( ! empty( $child['download_link'] ) && ! empty( $child_themes['download_button_label'] ) ) { echo '' . esc_html( $child_themes['download_button_label'] ) . ''; } if ( ! empty( $child['preview_link'] ) && ! empty( $child_themes['preview_button_label'] ) ) { echo '' . esc_html( $child_themes['preview_button_label'] ) . ''; } echo '
'; } echo '
'; } echo '
'; echo '
'; }// End if(). }// End for(). echo '
'; }// End if(). }// End if(). echo '
'; } /** * Support tab */ public function support() { echo '
'; if ( ! empty( $this->config['support_content'] ) ) { $support_steps = $this->config['support_content']; if ( ! empty( $support_steps ) ) { foreach ( $support_steps as $support_step ) { echo '
'; if ( ! empty( $support_step['title'] ) ) { echo '

'; if ( ! empty( $support_step['icon'] ) ) { echo ''; } echo esc_html( $support_step['title'] ); echo '

'; } if ( ! empty( $support_step['text'] ) ) { echo '

' . esc_html( $support_step['text'] ) . '

'; } if ( ! empty( $support_step['button_link'] ) && ! empty( $support_step['button_label'] ) ) { echo '

'; $button_class = ''; if ( $support_step['is_button'] ) { $button_class = 'button button-primary'; } $button_new_tab = '_self'; if ( isset( $support_step['is_new_tab'] ) ) { if ( $support_step['is_new_tab'] ) { $button_new_tab = '_blank'; } } echo '' . esc_html( $support_step['button_label'] ) . ''; echo '

'; } echo '
'; } } } echo '
'; } /** * Changelog tab */ public function changelog() { $changelog = $this->parse_changelog(); if ( ! empty( $changelog ) ) { echo '
'; foreach ( $changelog as $release ) { if ( ! empty( $release['title'] ) ) { echo '

' . esc_html( $release['title'] ) . '

'; } if ( ! empty( $release['changes'] ) ) { echo implode( '
', wp_kses( $release['changes'], analytica_get_allowed_tags() ) ); } } echo '
'; } } /** * Return the releases changes array. * * @return array The releases array. */ private function parse_changelog() { WP_Filesystem(); global $wp_filesystem; $changelog = $wp_filesystem->get_contents( get_template_directory() . '/CHANGELOG.md' ); if ( is_wp_error( $changelog ) ) { $changelog = ''; } $changelog = explode( PHP_EOL, $changelog ); $releases = array(); foreach ( $changelog as $changelog_line ) { if ( strpos( $changelog_line, '**Changes:**' ) !== false || empty( $changelog_line ) ) { continue; } if ( substr( $changelog_line, 0, 3 ) === '###' ) { if ( isset( $release ) ) { $releases[] = $release; } $release = array( 'title' => substr( $changelog_line, 3 ), 'changes' => array(), ); } else { $release['changes'][] = $changelog_line; } } return $releases; } /** * Free vs PRO tab */ public function free_pro() { $free_pro = isset( $this->config['free_pro'] ) ? $this->config['free_pro'] : array(); if ( ! empty( $free_pro ) ) { if ( ! empty( $free_pro['free_theme_name'] ) && ! empty( $free_pro['pro_theme_name'] ) && ! empty( $free_pro['features'] ) && is_array( $free_pro['features'] ) ) { echo '
'; echo '
'; echo ''; echo ''; echo ''; echo ''; echo ''; echo ''; echo ''; echo ''; echo ''; foreach ( $free_pro['features'] as $feature ) { echo ''; if ( ! empty( $feature['title'] ) || ! empty( $feature['description'] ) ) { echo ''; } if ( ! empty( $feature['is_in_lite'] ) && ( $feature['is_in_lite'] == 'true' ) ) { echo ''; } else { echo ''; } if ( ! empty( $feature['is_in_pro'] ) && ( $feature['is_in_pro'] == 'true' ) ) { echo ''; } else { echo ''; } echo ''; } if ( ! empty( $free_pro['pro_theme_link'] ) && ! empty( $free_pro['get_pro_theme_label'] ) ) { echo ''; echo ''; echo ''; echo ''; } echo ''; echo '
' . esc_html( $free_pro['free_theme_name'] ) . '' . esc_html( $free_pro['pro_theme_name'] ) . '
'; if ( ! empty( $feature['title'] ) ) { echo '

' . wp_kses_post( $feature['title'] ) . '

'; } if ( ! empty( $feature['description'] ) ) { echo '

' . wp_kses_post( $feature['description'] ) . '

'; } echo '
' . wp_kses_post( $free_pro['get_pro_theme_label'] ) . '
'; echo '
'; echo '
'; } } } /** * Load css and scripts for the about page */ public function style_and_scripts( $hook_suffix ) { // this is needed on all admin pages, not just the about page, for the badge action count in the wordpress main sidebar wp_enqueue_style( 'analytica-about-page', get_template_directory_uri() . '/includes/admin/about-page/css/ti_about_page_css.css' ); if ( 'appearance_page_' . $this->theme_slug . '-welcome' == $hook_suffix ) { wp_enqueue_script( 'analytica-about-page', get_template_directory_uri() . '/includes/admin/about-page/js/ti_about_page_scripts.js', array( 'jquery' ), analytica()->theme_version ); wp_enqueue_style( 'plugin-install' ); wp_enqueue_script( 'plugin-install' ); wp_enqueue_script( 'updates' ); $recommended_actions = isset( $this->config['recommended_actions'] ) ? $this->config['recommended_actions'] : array(); $required_actions = $this->get_required_actions(); wp_localize_script( 'analytica-about-page', 'tiAboutPageObject', array( 'nr_actions_required' => count( $required_actions ), 'ajaxurl' => admin_url( 'admin-ajax.php' ), 'template_directory' => get_template_directory_uri(), 'activating_string' => __( 'Activating', 'analytica' ) ) ); } } /** * Return the valid array of required actions. * * @return array The valid array of required actions. */ private function get_required_actions() { $saved_actions = get_option( $this->theme_slug . '_required_actions' ); if ( ! is_array( $saved_actions ) ) { $saved_actions = array(); } $req_actions = isset( $this->config['recommended_actions'] ) ? $this->config['recommended_actions'] : array(); $valid = array(); foreach ( $req_actions['content'] as $req_action ) { if ( ( ! isset( $req_action['check'] ) || ( isset( $req_action['check'] ) && ( $req_action['check'] == false ) ) ) && ( ! isset( $saved_actions[ $req_action['id'] ] ) ) ) { $valid[] = $req_action; } } return $valid; } /** * Dismiss required actions */ public function dismiss_required_action_callback() { $recommended_actions = array(); $req_actions = isset( $this->config['recommended_actions'] ) ? $this->config['recommended_actions'] : array(); foreach ( $req_actions['content'] as $req_action ) { $recommended_actions[] = $req_action; } $action_id = ( isset( $_GET['id'] ) ) ? sanitize_text_field( wp_unslash( $_GET['id'] ) ) : 0; $todo = ( isset( $_GET['todo'] ) ) ? sanitize_text_field( wp_unslash( $_GET['todo'] ) ) : ''; echo esc_html( $action_id ); /* this is needed and it's the id of the dismissable required action */ if ( ! empty( $action_id ) ) { /* if the option exists, update the record for the specified id */ if ( get_option( $this->theme_slug . '_required_actions' ) ) { $ti_about_page_show_required_actions = get_option( $this->theme_slug . '_required_actions' ); switch ( $todo ) { case 'add'; $ti_about_page_show_required_actions[ absint( $action_id ) ] = true; break; case 'dismiss'; $ti_about_page_show_required_actions[ absint( $action_id ) ] = false; break; } update_option( $this->theme_slug . '_required_actions', $ti_about_page_show_required_actions ); /* create the new option,with false for the specified id */ } else { $ti_about_page_show_required_actions_new = array(); if ( ! empty( $recommended_actions ) ) { foreach ( $recommended_actions as $ti_about_page_required_action ) { if ( $ti_about_page_required_action['id'] == $action_id ) { $ti_about_page_show_required_actions_new[ $ti_about_page_required_action['id'] ] = false; } else { $ti_about_page_show_required_actions_new[ $ti_about_page_required_action['id'] ] = true; } } update_option( $this->theme_slug . '_required_actions', $ti_about_page_show_required_actions_new ); } } } } }