__( 'About Flymag', 'flymag' ), * // Page title. * 'page_name' => __( 'About Flymag', 'flymag' ), * // Main welcome title * 'welcome_title' => sprintf( __( 'Welcome to %s! - Version ', 'flymag' ), 'FlyMag' ), * // Main welcome content * 'welcome_content' => sprintf( __( '%1$s is now installed and ready to use! Get ready to build something beautiful. We hope you enjoy it! We want to make sure you have the best experience using %2$s and that is why we gathered here all the necessary information for you. We hope you will enjoy using %3$s, as much as we enjoy creating great products.','flymag' ), 'FlyMag', 'FlyMag', 'FlyMag' ), * //Tabs array. * // * // The key needs to be ONLY consisted from letters and underscores. If we want to define outside the class a function to render the tab, * // the will be the name of the function which will be used to render the tab content. * 'tabs' => array( * 'getting_started' => __( 'Getting Started', 'flymag' ), * 'recommended_actions' => __( 'Recommended Actions', 'flymag' ), * 'recommended_plugins' => __( 'Recommended Plugins', 'flymag' ), * 'child_themes' => __( 'Child themes', 'flymag' ), * 'support' => __( 'Support', 'flymag' ), * 'changelog' => __( 'Changelog', 'flymag' ), * 'free_pro' => __( 'Free vs PRO', 'flymag' ), * ), * // Support content tab. * 'support_content' => array( * 'first' => array ( * 'title' => esc_html__( 'Contact Support','flymag' ), * 'icon' => 'dashicons dashicons-sos', * 'text' => esc_html__( 'We offer excellent support through our advanced ticketing system. Make sure to register your purchase before contacting support!','flymag' ), * 'button_label' => esc_html__( 'Contact Support','flymag' ), * 'button_link' => esc_url( 'https://pasal-ecommerce.com/contact/' ), * 'is_button' => true, * 'is_new_tab' => false * ), * ), * // Getting started tab content. * 'getting_started' => array( * 'first_step' => array ( * 'title' => esc_html__( 'Step 1 - Implement recommended actions','flymag' ), * 'text' => esc_html__( 'We have compiled a list of steps for you to take so we can ensure that the experience you have using one of our products is very easy to follow.','flymag' ), * 'button_label' => esc_html__( 'Check recommended actions','flymag' ), * 'button_link' => esc_url( admin_url( 'themes.php?page=flymag-welcome&tab=recommended_actions' ) ), * 'is_button' => false, * 'recommended_actions' => true * ), * ), * // Child themes array. * 'child_themes' => array( * 'download_button_label' => 'Download', * 'preview_button_label' => 'Live preview', * 'content' => array( * array( * 'title' => 'Flymag child theme 1', * 'image' => 'https://github.com/Codeinwp/zerif-lite/blob/production/inc/admin/welcome-screen/img/zblackbeard.jpg?raw=true', * 'image_alt' => 'Image of the child theme', * 'description' => 'Description', * 'download_link' => 'Download link', * 'preview_link' => 'Preview link', * ), * array( * 'title' => 'Flymag child theme 2', * 'image' => 'https://github.com/Codeinwp/zerif-lite/blob/production/inc/admin/welcome-screen/img/zblackbeard.jpg?raw=true', * 'image_alt' => 'Image of the child theme', * 'description' => 'Description', * 'download_link' => 'Download link', * 'preview_link' => 'Preview link', * ), * ), * ), * // Free vs PRO array. * 'free_pro' => array( * 'free_theme_name' => 'FlyMag', * 'pro_theme_name' => 'FlyMag PRO', * 'pro_theme_link' => 'https://pasal-ecommerce.com/themes/flymag-pro/', * 'get_pro_theme_label' => sprintf( __( 'Get %s now!', 'flymag' ), 'FlyMag Pro' ), * 'features' => array( * array( * 'title' => __( 'Mobile friendly', 'flymag' ), * 'description' => __( 'Responsive layout. Works on every device.', 'flymag' ), * 'is_in_lite' => 'true', * 'is_in_pro' => 'true', * ), * array( * 'title' => __( 'Unlimited color option', 'flymag' ), * 'description' => __( 'You can change the colors of each section. You have unlimited options.', 'flymag' ), * 'is_in_lite' => 'true', * 'is_in_pro' => 'true', * ), * array( * 'title' => __( 'Background image', 'flymag' ), * 'description' => __( 'You can use any background image you want.', 'flymag' ), * 'is_in_lite' => 'true', * 'is_in_pro' => 'true', * ), * array( * 'title' => __( 'Featured Area', 'flymag' ), * 'description' => __( 'Have access to a new featured area.', 'flymag' ), * 'is_in_lite' => 'false', * 'is_in_pro' => 'true', * ), * array( * 'title' => __( 'Footer credits', 'flymag' ), * 'description' => '', * 'is_in_lite' => 'false', * 'is_in_pro' => 'true', * ), * array( * 'title' => __( 'Extra widgets areas', 'flymag' ), * 'description' => __( 'More widgets areas for your theme.', 'flymag' ), * 'is_in_lite' => 'false', * 'is_in_pro' => 'true', * ), * array( * 'title' => __( 'Support', 'flymag' ), * 'description' => __( 'You will benefit of our full support for any issues you have with the theme.', 'flymag' ), * 'is_in_lite' => 'false', * 'is_in_pro' => 'true', * ), * ), * ), * // Recommended plugins tab. * 'recommended_plugins' => array( * 'already_activated_message' => esc_html__( 'Already activated', 'flymag' ), * 'version_label' => esc_html__( 'Version: ', 'flymag' ), * 'install_label' => esc_html__( 'Install', 'flymag' ), * 'activate_label' => esc_html__( 'Activate', 'flymag' ), * 'deactivate_label' => esc_html__( 'Deactivate', 'flymag' ), * 'content' => array( * array( * 'slug' => 'pirate-forms', * ), * array( * 'link' => 'http://pasal-ecommerce.com/plugins/easy-content-types/', * ), * array( * 'slug' => 'siteorigin-panels', * ), * array( * 'slug' => 'intergeo-maps', * ), * ), * ), * // Required actions array. * 'recommended_actions' => array( * 'install_label' => esc_html__( 'Install', 'flymag' ), * 'activate_label' => esc_html__( 'Activate', 'flymag' ), * 'deactivate_label' => esc_html__( 'Deactivate', 'flymag' ), * 'content' => array( * 'pirate-forms' => array( * 'title' => __( 'Pirate Forms', 'flymag' ), * 'description' => __( 'Makes your contact page more engaging by creating a good-looking contact form on your website. The interaction with your visitors was never easier.', 'flymag' ), * 'link_label' => __( 'Install Pirate Forms', 'flymag' ), * 'check' => defined( 'PIRATE_FORMS_VERSION' ), * 'id' => 'pirate-forms', * 'plugin_slug' => 'pirate-forms' * ), * ), * ), * ); * Resortica_About_Page::init( $config ); * * @package Pasal-ecommerce * @since 1.0.0 */ if ( ! class_exists( 'pasal_ecommerce_About_Page' ) ) { // Include utils functions /** * Singleton class used for generating the about page of the theme. */ class pasal_ecommerce_About_Page { /** * Define the version of the class. * * @var string $version The Resortica_About_Page class version. */ private $version = '1.0.0'; /** * Used for loading the texts and setup the actions inside the page. * * @var array $config The configuration array for the theme used. */ private $config; /** * Get the theme name using wp_get_theme. * * @var string $theme_name The theme name. */ private $theme_name; /** * Get the theme slug ( theme folder name ). * * @var string $theme_slug The theme slug. */ private $theme_slug; /** * The current theme object. * * @var WP_Theme $theme The current theme. */ private $theme; /** * Holds the theme version. * * @var string $theme_version The theme version. */ private $theme_version; /** * Define the menu item name for the page. * * @var string $menu_name The name of the menu name under Appearance settings. */ private $menu_name; /** * Define the page title name. * * @var string $page_name The title of the About page. */ private $page_name; /** * Define the page tabs. * * @var array $tabs The page tabs. */ private $tabs; /** * Define the html notification content displayed upon activation. * * @var string $notification The html notification content. */ private $notification; /** * The single instance of Resortica_About_Page * * @var Resortica_About_Page $instance The Resortica_About_Page instance. */ private static $instance; /** * The Main Resortica_About_Page instance. * * We make sure that only one instance of Resortica_About_Page exists in the memory at one time. * * @param array $config The configuration array. */ public static function init( $config ) { if ( ! isset( self::$instance ) && ! ( self::$instance instanceof pasal_ecommerce_About_Page ) ) { self::$instance = new pasal_ecommerce_About_Page; if ( ! empty( $config ) && is_array( $config ) ) { self::$instance->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() ) { $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'] : ( apply_filters( 'pasal_ecommerce_welcome_notice_filter', ( '

' . 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_acp_about_page_dismiss_required_action', array( $this, 'dismiss_required_action_callback' ) ); add_action( 'wp_ajax_nopriv_acp_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(); foreach ($actions_count as $a=>$r) { $active_slug= $r['plugin_slug']; if($active_slug == 'contact-form-7') $active_slug='wp-contact-form-7'; if(is_plugin_active($r['plugin_slug'].'/'.$active_slug.'.php')){ unset($actions_count[$a]); } } 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, 'pasal_ecommerce_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, 'pasal_ecommerce_about_page_welcome_admin_notice' ), 99 ); } } /** * Display an admin notice linking to the about page */ public function pasal_ecommerce_about_page_welcome_admin_notice() { if ( ! empty( $this->notification ) ) { echo '
'; echo wp_kses_post( $this->notification ); echo '
'; } } /** * Render the main content page. */ public function pasal_ecommerce_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 ) . '
'; } /* Display tabs */ if ( ! empty( $this->tabs ) ) { $active_tab = isset( $_GET['tab'] ) ? wp_unslash( $_GET['tab'] ) : 'getting_started'; echo ''; /* Display content for current tab */ if ( method_exists( $this, $active_tab ) ) { $this->$active_tab(); } }// End if(). echo '
'; }// End if(). } /** * Call plugin api */ public function call_plugin_api( $slug ) { include_once(ABSPATH . 'wp-admin/includes/plugin-install.php'); $call_api = get_transient( 'acp_about_plugin_info_' . $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( 'acp_about_plugin_info_' . $slug, $call_api, 30 * MINUTE_IN_SECONDS ); } return $call_api; } /** * Check if plugin is active * * @param plugin-slug $slug the plugin slug. * @return array */ 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'; } elseif ( $slug == 'contact-form-7' ) { $plugin_root_file = 'wp-contact-form-7'; } 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 array $arr array of image formats. * * @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() . '/information/acp-notifications/pasal/images/placeholder_plugin.png'; } return $plugin_icon_url; } /** * Check if a slug is from intergeo, visualizer or adblock and returns the correct slug for them. * * @param string $slug Plugin slug. * * @return string */ public function check_plugin_slug( $slug ) { switch ( $slug ) { case 'intergeo-maps': case 'visualizer': $slug = 'index'; break; case 'adblock-notify-by-bweb': $slug = 'adblock-notify'; break; } return $slug; } /** * Display button for recommended actions or * * @param array $data Data for an item. */ public function display_button( $data ) { $button_new_tab = '_self'; $button_class = ''; if ( isset( $tab_data['is_new_tab'] ) ) { if ( $data['is_new_tab'] ) { $button_new_tab = '_blank'; } } if ( $data['is_button'] ) { $button_class = 'button button-primary'; } echo '' . $data['button_label'] . ''; } /** * Getting started tab */ public function getting_started() { if ( ! empty( $this->config['getting_started'] ) ) { $getting_started = $this->config['getting_started']; if ( ! empty( $getting_started ) ) { ?> '; foreach ( $getting_started as $getting_started_item ) { echo '
'; if ( ! empty( $getting_started_item['title'] ) ) { echo '

' . $getting_started_item['title'] . '

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

' . $getting_started_item['text'] . '

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

'; $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 ''; } else { echo ''; } } $this->display_button( $getting_started_item ); echo '

'; } echo '
'; }// End foreach(). echo ''; }// End if(). }// End if(). } /** * 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 ) ) { $acp_about_page_show_required_actions = get_option( $this->theme_slug . '_required_actions' ); foreach ( $actions as $action_key => $action_value ) { $hidden = false; if ( $acp_about_page_show_required_actions[ $action_value['id'] ] === false ) { $hidden = true; } if ( $action_value['check'] ) { continue; } echo '
'; $this->display_feature_title_and_description( $action_value ); if ( ! empty( $action_value['plugin_slug'] ) ) { $active = $this->check_if_plugin_active( $action_value['plugin_slug'] ); $label = ''; $slug = $this->check_plugin_slug( $action_value['plugin_slug'] ); $network = $this->check_plugin_slug( $action_value['network'] ); $url = create_action_link( $active['needs'], $slug ); 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; } if($network=='local' && $class=='install-now button') { ?>

'; }// End foreach(). }// End if(). echo '
'; }// End if(). } /** * 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 '