%PDF- %PDF-
Direktori : /home/kfvehpdt/www/wp-content/themes/astra/admin/includes/ |
Current File : /home/kfvehpdt/www/wp-content/themes/astra/admin/includes/class-astra-menu.php |
<?php /** * Class Astra_Menu. * * @package Astra * @since 4.0.0 */ if ( ! defined( 'ABSPATH' ) ) { exit; // Exit if accessed directly. } /** * Astra_Menu. * * @since 4.1.0 */ class Astra_Menu { /** * Instance * * @access private * @var null $instance * @since 4.0.0 */ private static $instance; /** * Initiator * * @since 4.0.0 * @return object initialized object of class. */ public static function get_instance() { if ( ! isset( self::$instance ) ) { /** @psalm-suppress InvalidPropertyAssignmentValue */ // phpcs:ignore Generic.Commenting.DocComment.MissingShort self::$instance = new self(); /** @psalm-suppress InvalidPropertyAssignmentValue */ // phpcs:ignore Generic.Commenting.DocComment.MissingShort } return self::$instance; } /** * Page title * * @since 4.0.0 * @var string $page_title */ public static $page_title = 'Astra'; /** * Plugin slug * * @since 4.0.0 * @var string $plugin_slug */ public static $plugin_slug = 'astra'; /** * Constructor * * @since 4.0.0 */ public function __construct() { $this->initialize_hooks(); } /** * Init Hooks. * * @since 4.0.0 * @return void */ public function initialize_hooks() { self::$page_title = apply_filters( 'astra_page_title', esc_html__( 'Astra', 'astra' ) ); self::$plugin_slug = self::get_theme_page_slug(); add_action( 'admin_menu', array( $this, 'setup_menu' ) ); add_action( 'admin_init', array( $this, 'settings_admin_scripts' ) ); add_filter( 'install_plugins_tabs', array( $this, 'add_astra_woo_suggestions_link' ), 1 ); add_action( 'install_plugins_pre_astra-woo', array( $this, 'update_plugin_suggestions_tab_link' ) ); } /** * Add Astra~Woo Suggestions plugin tab link. * * @param array $tabs Plugin tabs. * @since 4.7.3 * @return array */ public function add_astra_woo_suggestions_link( $tabs ) { if ( class_exists( 'WooCommerce' ) ) { $tabs['astra-woo'] = esc_html__( 'For ', 'astra' ) . self::$page_title . '~Woo'; } return $tabs; } /** * Update plugin suggestions tab link. * * @since 4.7.3 * @return void */ public function update_plugin_suggestions_tab_link() { // phpcs:disable WordPress.Security.NonceVerification.Recommended if ( ! isset( $_GET['tab'] ) || 'astra-woo' !== $_GET['tab'] ) { return; } // phpcs:enable WordPress.Security.NonceVerification.Recommended $extensions_url = add_query_arg( array( 'page' => self::$plugin_slug, 'path' => 'woocommerce', 'ref' => 'plugins', ), admin_url( 'admin.php' ) ); wp_safe_redirect( $extensions_url ); exit; } /** * Theme options page Slug getter including White Label string. * * @since 4.0.0 * @return string Theme Options Page Slug. */ public static function get_theme_page_slug() { return apply_filters( 'astra_theme_page_slug', self::$plugin_slug ); } /** * Initialize after Astra gets loaded. * * @since 4.0.0 */ public function settings_admin_scripts() { // Enqueue admin scripts. /** @psalm-suppress PossiblyInvalidArgument */ // phpcs:ignore Generic.Commenting.DocComment.MissingShort if ( ! empty( $_GET['page'] ) && ( self::$plugin_slug === $_GET['page'] || false !== strpos( $_GET['page'], self::$plugin_slug . '_' ) ) ) { //phpcs:ignore /** @psalm-suppress PossiblyInvalidArgument */ // phpcs:ignore Generic.Commenting.DocComment.MissingShort add_action( 'admin_enqueue_scripts', array( $this, 'styles_scripts' ) ); add_filter( 'admin_footer_text', array( $this, 'astra_admin_footer_link' ), 99 ); } } /** * Add submenu to admin menu. * * @since 4.0.0 */ public function setup_menu() { global $submenu; $capability = 'manage_options'; if ( ! current_user_can( $capability ) ) { return; } $astra_icon = apply_filters( 'astra_menu_icon', 'data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iNzcyIiBoZWlnaHQ9Ijc3MiIgdmlld0JveD0iMCAwIDc3MiA3NzIiIGZpbGw9IiNhN2FhYWQiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyI+DQo8cGF0aCBmaWxsLXJ1bGU9ImV2ZW5vZGQiIGNsaXAtcnVsZT0iZXZlbm9kZCIgZD0iTTM4NiA3NzJDNTk5LjE4MiA3NzIgNzcyIDU5OS4xODIgNzcyIDM4NkM3NzIgMTcyLjgxOCA1OTkuMTgyIDAgMzg2IDBDMTcyLjgxOCAwIDAgMTcyLjgxOCAwIDM4NkMwIDU5OS4xODIgMTcyLjgxOCA3NzIgMzg2IDc3MlpNMjYxLjcxMyAzNDMuODg2TDI2MS42NzUgMzQzLjk2OEMyMjIuNDE3IDQyNi45OTQgMTgzLjE1OSA1MTAuMDE5IDE0My45MDIgNTkyLjk1MkgyNDQuODQ3QzI3Ni42MjcgNTI4LjczOSAzMDguNDA3IDQ2NC40MzQgMzQwLjE4NyA0MDAuMTI4QzM3MS45NjUgMzM1LjgyNyA0MDMuNzQyIDI3MS41MjcgNDM1LjUyIDIwNy4zMkwzNzkuNDQgOTVDMzQwLjE5NyAxNzcuOSAzMDAuOTU1IDI2MC44OTMgMjYxLjcxMyAzNDMuODg2Wk00MzYuNjczIDQwNC4wNzVDNDUyLjkwNiAzNzAuNzQ1IDQ2OS4xMzkgMzM3LjQxNSA0ODUuNDY3IDMwNC4wODVDNTA5LjMwMSAzNTIuMjI5IDUzMy4wNDIgNDAwLjM3NCA1NTYuNzgyIDQ0OC41MThDNTgwLjUyMyA0OTYuNjYzIDYwNC4yNjQgNTQ0LjgwNyA2MjguMDk4IDU5Mi45NTJINTE5LjI0OEM1MTMuMDU0IDU3OC42OTMgNTA2Ljc2NyA1NjQuNTI3IDUwMC40OCA1NTAuMzYyQzQ5NC4xOTMgNTM2LjE5NiA0ODcuOTA2IDUyMi4wMzEgNDgxLjcxMyA1MDcuNzczSDM4NkwzODcuODc3IDUwNC4wNjlDNDA0LjIwNSA0NzAuNzM4IDQyMC40MzkgNDM3LjQwNiA0MzYuNjczIDQwNC4wNzVaIiBmaWxsPSIjYTdhYWFkIi8+DQo8L3N2Zz4=' ); $priority = apply_filters( 'astra_menu_priority', 59 ); add_menu_page( // phpcs:ignore WPThemeReview.PluginTerritory.NoAddAdminPages.add_menu_pages_add_menu_page -- Taken the menu on top level self::$page_title, self::$page_title, $capability, self::$plugin_slug, array( $this, 'render_admin_dashboard' ), $astra_icon, $priority ); // Add Customize submenu. add_submenu_page( // phpcs:ignore WPThemeReview.PluginTerritory.NoAddAdminPages.add_menu_pages_add_submenu_page -- Taken the menu on top level self::$plugin_slug, __( 'Customize', 'astra' ), __( 'Customize', 'astra' ), $capability, 'customize.php' ); // Add Custom Layout submenu. /** @psalm-suppress UndefinedClass */ // phpcs:ignore Generic.Commenting.DocComment.MissingShort $show_custom_layout_submenu = ( defined( 'ASTRA_EXT_VER' ) && ! Astra_Ext_Extension::is_active( 'advanced-hooks' ) ) ? false : true; /** @psalm-suppress UndefinedClass */ // phpcs:ignore Generic.Commenting.DocComment.MissingShort if ( $show_custom_layout_submenu && defined( 'ASTRA_EXT_VER' ) && version_compare( ASTRA_EXT_VER, '4.5.0', '<' ) ) { add_submenu_page( // phpcs:ignore WPThemeReview.PluginTerritory.NoAddAdminPages.add_menu_pages_add_submenu_page -- Taken the menu on top level self::$plugin_slug, __( 'Custom Layouts', 'astra' ), __( 'Custom Layouts', 'astra' ), $capability, /** @psalm-suppress UndefinedClass */ // phpcs:ignore Generic.Commenting.DocComment.MissingShort ( defined( 'ASTRA_EXT_VER' ) && Astra_Ext_Extension::is_active( 'advanced-hooks' ) ) ? 'edit.php?post_type=astra-advanced-hook' : 'admin.php?page=' . self::$plugin_slug . '&path=custom-layouts' /** @psalm-suppress UndefinedClass */ // phpcs:ignore Generic.Commenting.DocComment.MissingShort ); } if ( ! astra_is_white_labelled() ) { // Add Astra~Woo Extensions page or Spectra submenu. if ( class_exists( 'WooCommerce' ) ) { add_submenu_page( // phpcs:ignore WPThemeReview.PluginTerritory.NoAddAdminPages.add_menu_pages_add_submenu_page -- Taken the menu on top level self::$plugin_slug, 'WooCommerce', 'WooCommerce', $capability, 'admin.php?page=' . self::$plugin_slug . '&path=woocommerce' ); } elseif ( ! $this->spectra_has_top_level_menu() ){ add_submenu_page( // phpcs:ignore WPThemeReview.PluginTerritory.NoAddAdminPages.add_menu_pages_add_submenu_page -- Taken the menu on top level self::$plugin_slug, 'Spectra', 'Spectra', $capability, $this->get_spectra_page_admin_link() ); } else { // Do nothing. } } // Rename to Home menu. $submenu[ self::$plugin_slug ][0][0] = esc_html__( 'Dashboard', 'astra' ); // phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited -- Required to rename the home menu. } /** * In version 2.4.1 Spectra introduces top level admin menu so there is no meaning to show Spectra submenu from Astra menu. * * @since 4.1.4 * @return bool true|false. */ public function spectra_has_top_level_menu() { return defined( 'UAGB_VER' ) && version_compare( UAGB_VER, '2.4.1', '>=' ) ? true : false; } /** * Provide the Spectra admin page URL. * * @since 4.1.1 * @return string url. */ public function get_spectra_page_admin_link() { $spectra_admin_url = defined( 'UAGB_VER' ) ? ( $this->spectra_has_top_level_menu() ? admin_url( 'admin.php?page=' . UAGB_SLUG ) : admin_url( 'options-general.php?page=' . UAGB_SLUG ) ) : 'admin.php?page=' . self::$plugin_slug . '&path=spectra'; return apply_filters( 'astra_dashboard_spectra_admin_link', $spectra_admin_url ); } /** * Renders the admin settings. * * @since 4.0.0 * @return void */ public function render_admin_dashboard() { $page_action = ''; if ( isset( $_GET['action'] ) ) { //phpcs:ignore /** @psalm-suppress PossiblyInvalidArgument */ // phpcs:ignore Generic.Commenting.DocComment.MissingShort $page_action = sanitize_text_field( wp_unslash( $_GET['action'] ) ); //phpcs:ignore /** @psalm-suppress PossiblyInvalidArgument */ // phpcs:ignore Generic.Commenting.DocComment.MissingShort $page_action = str_replace( '_', '-', $page_action ); } ?> <div class="ast-menu-page-wrapper"> <div id="ast-menu-page"> <div class="ast-menu-page-content"> <div id="astra-dashboard-app" class="astra-dashboard-app"> </div> </div> </div> </div> <?php } /** * Enqueues the needed CSS/JS for the builder's admin settings page. * * @since 4.0.0 */ public function styles_scripts() { if ( is_customize_preview() ) { return; } wp_enqueue_style( 'astra-admin-font', 'https://fonts.googleapis.com/css2?family=Inter:wght@400;500&display=swap', array(), ASTRA_THEME_VERSION ); // Styles. wp_enqueue_style( 'wp-components' ); /** @psalm-suppress UndefinedClass */ // phpcs:ignore Generic.Commenting.DocComment.MissingShort $show_self_branding = defined( 'ASTRA_EXT_VER' ) && is_callable( 'Astra_Ext_White_Label_Markup::show_branding' ) ? Astra_Ext_White_Label_Markup::show_branding() : true; /** @psalm-suppress UndefinedClass */ // phpcs:ignore Generic.Commenting.DocComment.MissingShort $user_firstname = wp_get_current_user()->user_firstname; $localize = array( 'current_user' => ! empty( $user_firstname ) ? ucfirst( $user_firstname ) : ucfirst( wp_get_current_user()->display_name ), 'admin_base_url' => admin_url(), 'plugin_dir' => ASTRA_THEME_URI, 'plugin_ver' => defined( 'ASTRA_EXT_VER' ) ? ASTRA_EXT_VER : '', 'version' => ASTRA_THEME_VERSION, 'pro_available' => defined( 'ASTRA_EXT_VER' ) ? true : false, 'pro_installed_status' => 'installed' === self::get_plugin_status( 'astra-addon/astra-addon.php' ) ? true : false, 'spectra_plugin_status' => self::get_plugin_status( 'ultimate-addons-for-gutenberg/ultimate-addons-for-gutenberg.php' ), 'theme_name' => astra_get_theme_name(), 'plugin_name' => astra_get_addon_name(), 'quick_settings' => self::astra_get_quick_links(), 'ajax_url' => admin_url( 'admin-ajax.php' ), 'is_whitelabel' => astra_is_white_labelled(), 'show_self_branding' => $show_self_branding, 'admin_url' => admin_url( 'admin.php' ), 'home_slug' => self::$plugin_slug, 'upgrade_url' => ASTRA_PRO_UPGRADE_URL, 'customize_url' => admin_url( 'customize.php' ), 'astra_base_url' => admin_url( 'admin.php?page=' . self::$plugin_slug ), 'logo_url' => apply_filters( 'astra_admin_menu_icon', ASTRA_THEME_URI . 'inc/assets/images/astra-logo.svg' ), 'update_nonce' => wp_create_nonce( 'astra_update_admin_setting' ), 'integrations' => self::astra_get_integrations(), 'show_plugins' => apply_filters( 'astra_show_free_extend_plugins', true ), // Legacy filter support. 'useful_plugins' => self::astra_get_useful_plugins(), 'extensions' => self::astra_get_pro_extensions(), 'plugin_manager_nonce' => wp_create_nonce( 'astra_plugin_manager_nonce' ), 'plugin_installer_nonce' => wp_create_nonce( 'updates' ), 'free_vs_pro_link' => admin_url( 'admin.php?page=' . self::$plugin_slug . '&path=free-vs-pro' ), 'show_builder_migration' => Astra_Builder_Helper::is_header_footer_builder_active(), 'plugin_installing_text' => esc_html__( 'Installing', 'astra' ), 'plugin_installed_text' => esc_html__( 'Installed', 'astra' ), 'plugin_activating_text' => esc_html__( 'Activating', 'astra' ), 'plugin_activated_text' => esc_html__( 'Activated', 'astra' ), 'plugin_activate_text' => esc_html__( 'Activate', 'astra' ), 'starter_templates_data' => self::get_starter_template_plugin_data(), 'astra_docs_data' => astra_remote_docs_data(), 'upgrade_notice' => astra_showcase_upgrade_notices(), 'show_banner_video' => apply_filters( 'astra_show_banner_video', true ), 'is_woo_active' => class_exists( 'WooCommerce' ) ? true : false, 'woo_extensions' => self::astra_get_woo_extensions( false ), ); $this->settings_app_scripts( apply_filters( 'astra_react_admin_localize', $localize ) ); } /** * Get customizer quick links for easy navigation. * * @return array * @since 4.0.0 */ public static function astra_get_quick_links() { return apply_filters( 'astra_quick_settings', array( 'logo-favicon' => array( 'title' => __( 'Site Identity', 'astra' ), 'quick_url' => admin_url( 'customize.php?autofocus[control]=site_icon' ), ), 'header' => array( 'title' => __( 'Header Settings', 'astra' ), 'quick_url' => admin_url( 'customize.php?autofocus[panel]=panel-header-group' ), ), 'footer' => array( 'title' => __( 'Footer Settings', 'astra' ), 'quick_url' => admin_url( 'customize.php?autofocus[section]=section-footer-group' ), ), 'colors' => array( 'title' => __( 'Color', 'astra' ), 'quick_url' => admin_url( 'customize.php?autofocus[section]=section-colors-background' ), ), 'typography' => array( 'title' => __( 'Typography', 'astra' ), 'quick_url' => admin_url( 'customize.php?autofocus[section]=section-typography' ), ), 'button' => array( 'title' => __( 'Button', 'astra' ), 'quick_url' => admin_url( 'customize.php?autofocus[section]=section-buttons' ), ), 'blog-options' => array( 'title' => __( 'Blog Options', 'astra' ), 'quick_url' => admin_url( 'customize.php?autofocus[section]=section-blog-group' ), ), 'layout' => array( 'title' => __( 'Layout', 'astra' ), 'quick_url' => admin_url( 'customize.php?autofocus[section]=section-container-layout' ), ), 'menus' => array( 'title' => __( 'Menus', 'astra' ), 'quick_url' => admin_url( 'nav-menus.php' ), ), ) ); } /** * Get Starter Templates plugin data. * * @return array * @since 4.0.0 */ public static function get_starter_template_plugin_data() { /** @psalm-suppress UndefinedClass */ // phpcs:ignore Generic.Commenting.DocComment.MissingShort $st_data = array( 'title' => is_callable( 'Astra_Ext_White_Label_Markup::get_whitelabel_string' ) ? Astra_Ext_White_Label_Markup::get_whitelabel_string( 'astra-sites', 'name', __( 'Starter Templates', 'astra' ) ) : __( 'Starter Templates', 'astra' ), 'description' => is_callable( 'Astra_Ext_White_Label_Markup::get_whitelabel_string' ) ? Astra_Ext_White_Label_Markup::get_whitelabel_string( 'astra-sites', 'description', __( 'Create professional designed pixel perfect websites in minutes. Get access to 280+ pre-made full website templates for your favorite page builder.', 'astra' ) ) : __( 'Create professional designed pixel perfect websites in minutes. Get access to 280+ pre-made full website templates for your favorite page builder.', 'astra' ), 'is_available' => defined( 'ASTRA_PRO_SITES_VER' ) || defined( 'ASTRA_SITES_VER' ) ? true : false, 'redirection' => admin_url( 'themes.php?page=starter-templates' ), 'icon_path' => 'https://ps.w.org/astra-sites/assets/icon-256x256.gif', ); /** @psalm-suppress UndefinedClass */ // phpcs:ignore Generic.Commenting.DocComment.MissingShort $skip_free_version = false; $pro_plugin_status = self::get_plugin_status( 'astra-pro-sites/astra-pro-sites.php' ); if ( 'installed' === $pro_plugin_status || 'activated' === $pro_plugin_status ) { $skip_free_version = true; $st_data['slug'] = 'astra-pro-sites'; $st_data['status'] = $pro_plugin_status; $st_data['path'] = 'astra-pro-sites/astra-pro-sites.php'; } $free_plugin_status = self::get_plugin_status( 'astra-sites/astra-sites.php' ); if ( ! $skip_free_version ) { $st_data['slug'] = 'astra-sites'; $st_data['status'] = $free_plugin_status; $st_data['path'] = 'astra-sites/astra-sites.php'; } return $st_data; } /** * Get plugin status * * @since 4.0.0 * * @param string $plugin_init_file Plguin init file. * @return mixed */ public static function get_plugin_status( $plugin_init_file ) { $installed_plugins = get_plugins(); if ( ! isset( $installed_plugins[ $plugin_init_file ] ) ) { return 'install'; } elseif ( is_plugin_active( $plugin_init_file ) ) { return 'activated'; } else { return 'installed'; } } /** * Get Astra's pro extension list. * * @since 4.0.0 * @return array * @access public */ public static function astra_get_pro_extensions() { return apply_filters( 'astra_addon_list', array( 'colors-and-background' => array( 'title' => __( 'Colors & Background', 'astra' ), 'class' => 'ast-addon', 'title_url' => astra_get_pro_url( 'https://wpastra.com/docs/colors-background-module/', 'dashboard', 'free-theme', 'documentation' ), 'links' => array( array( 'link_class' => 'ast-learn-more', 'link_url' => astra_get_pro_url( 'https://wpastra.com/docs/colors-background-module/', 'dashboard', 'free-theme', 'documentation' ), 'link_text' => __( 'Documentation', 'astra' ), 'target_blank' => true, ), ), ), 'typography' => array( 'title' => __( 'Typography', 'astra' ), 'class' => 'ast-addon', 'title_url' => astra_get_pro_url( 'https://wpastra.com/docs/typography-module/', 'dashboard', 'free-theme', 'documentation' ), 'links' => array( array( 'link_class' => 'ast-learn-more', 'link_url' => astra_get_pro_url( 'https://wpastra.com/docs/typography-module/', 'dashboard', 'free-theme', 'documentation' ), 'link_text' => __( 'Documentation', 'astra' ), 'target_blank' => true, ), ), ), 'spacing' => array( 'title' => __( 'Spacing', 'astra' ), 'class' => 'ast-addon', 'title_url' => astra_get_pro_url( 'https://wpastra.com/docs/spacing-addon-overview/', 'dashboard', 'free-theme', 'documentation' ), 'links' => array( array( 'link_class' => 'ast-learn-more', 'link_url' => astra_get_pro_url( 'https://wpastra.com/docs/spacing-addon-overview/', 'dashboard', 'free-theme', 'documentation' ), 'link_text' => __( 'Documentation', 'astra' ), 'target_blank' => true, ), ), ), 'blog-pro' => array( 'title' => __( 'Blog Pro', 'astra' ), 'class' => 'ast-addon', 'title_url' => astra_get_pro_url( 'https://wpastra.com/docs/blog-pro-overview/', 'dashboard', 'free-theme', 'documentation' ), 'links' => array( array( 'link_class' => 'ast-learn-more', 'link_url' => astra_get_pro_url( 'https://wpastra.com/docs/blog-pro-overview/', 'dashboard', 'free-theme', 'documentation' ), 'link_text' => __( 'Documentation', 'astra' ), 'target_blank' => true, ), ), ), 'mobile-header' => array( 'title' => __( 'Mobile Header', 'astra' ), 'class' => 'ast-addon', 'title_url' => astra_get_pro_url( 'https://wpastra.com/docs/mobile-header-with-astra/', 'dashboard', 'free-theme', 'documentation' ), 'links' => array( array( 'link_class' => 'ast-learn-more', 'link_url' => astra_get_pro_url( 'https://wpastra.com/docs/mobile-header-with-astra/', 'dashboard', 'free-theme', 'documentation' ), 'link_text' => __( 'Documentation', 'astra' ), 'target_blank' => true, ), ), ), 'header-sections' => array( 'title' => __( 'Header Sections', 'astra' ), 'class' => 'ast-addon', 'title_url' => astra_get_pro_url( 'https://wpastra.com/docs/header-sections-pro/', 'dashboard', 'free-theme', 'documentation' ), 'links' => array( array( 'link_class' => 'ast-learn-more', 'link_url' => astra_get_pro_url( 'https://wpastra.com/docs/header-sections-pro/', 'dashboard', 'free-theme', 'documentation' ), 'link_text' => __( 'Documentation', 'astra' ), 'target_blank' => true, ), ), ), 'sticky-header' => array( 'title' => __( 'Sticky Header', 'astra' ), 'class' => 'ast-addon', 'title_url' => astra_get_pro_url( 'https://wpastra.com/docs/sticky-header-pro/', 'dashboard', 'free-theme', 'documentation' ), 'links' => array( array( 'link_class' => 'ast-learn-more', 'link_url' => astra_get_pro_url( 'https://wpastra.com/docs/sticky-header-pro/', 'dashboard', 'free-theme', 'documentation' ), 'link_text' => __( 'Documentation', 'astra' ), 'target_blank' => true, ), ), ), 'site-layouts' => array( 'title' => __( 'Site Layouts', 'astra' ), 'class' => 'ast-addon', 'title_url' => astra_get_pro_url( 'https://wpastra.com/docs/site-layout-overview/', 'dashboard', 'free-theme', 'documentation' ), 'links' => array( array( 'link_class' => 'ast-learn-more', 'link_url' => astra_get_pro_url( 'https://wpastra.com/docs/site-layout-overview/', 'dashboard', 'free-theme', 'documentation' ), 'link_text' => __( 'Documentation', 'astra' ), 'target_blank' => true, ), ), ), 'advanced-footer' => array( 'title' => __( 'Footer Widgets', 'astra' ), 'class' => 'ast-addon', 'title_url' => astra_get_pro_url( 'https://wpastra.com/docs/footer-widgets-astra-pro/', 'dashboard', 'free-theme', 'documentation' ), 'links' => array( array( 'link_class' => 'ast-learn-more', 'link_url' => astra_get_pro_url( 'https://wpastra.com/docs/footer-widgets-astra-pro/', 'dashboard', 'free-theme', 'documentation' ), 'link_text' => __( 'Documentation', 'astra' ), 'target_blank' => true, ), ), ), 'nav-menu' => array( 'title' => __( 'Nav Menu', 'astra' ), 'class' => 'ast-addon', 'title_url' => astra_get_pro_url( 'https://wpastra.com/docs/nav-menu-addon/', 'dashboard', 'free-theme', 'documentation' ), 'links' => array( array( 'link_class' => 'ast-learn-more', 'link_url' => astra_get_pro_url( 'https://wpastra.com/docs/nav-menu-addon/', 'dashboard', 'free-theme', 'documentation' ), 'link_text' => __( 'Documentation', 'astra' ), 'target_blank' => true, ), ), ), 'advanced-hooks' => array( 'title' => ( defined( 'ASTRA_EXT_VER' ) && version_compare( ASTRA_EXT_VER, '4.5.0', '<' ) ) ? __( 'Custom Layouts', 'astra' ) : __( 'Site Builder', 'astra' ), 'description' => __( 'Add content conditionally in the various hook areas of the theme.', 'astra' ), 'manage_settings' => true, 'class' => 'ast-addon', 'title_url' => astra_get_pro_url( 'https://wpastra.com/docs/custom-layouts-pro/', 'dashboard', 'free-theme', 'documentation' ), 'links' => array( array( 'link_class' => 'ast-learn-more', 'link_url' => astra_get_pro_url( 'https://wpastra.com/docs/custom-layouts-pro/', 'dashboard', 'free-theme', 'documentation' ), 'link_text' => __( 'Documentation', 'astra' ), 'target_blank' => true, ), ), ), 'advanced-headers' => array( 'title' => __( 'Page Headers', 'astra' ), 'description' => __( 'Make your header layouts look more appealing and sexy!', 'astra' ), 'manage_settings' => true, 'class' => 'ast-addon', 'title_url' => astra_get_pro_url( 'https://wpastra.com/docs/page-headers-overview/', 'dashboard', 'free-theme', 'documentation' ), 'links' => array( array( 'link_class' => 'ast-learn-more', 'link_url' => astra_get_pro_url( 'https://wpastra.com/docs/page-headers-overview/', 'dashboard', 'free-theme', 'documentation' ), 'link_text' => __( 'Documentation', 'astra' ), 'target_blank' => true, ), ), ), 'woocommerce' => array( 'title' => 'WooCommerce', 'class' => 'ast-addon', 'condition' => defined( 'ASTRA_EXT_VER' ) && class_exists( 'WooCommerce' ) ? true : false, 'title_url' => astra_get_pro_url( 'https://wpastra.com/docs/woocommerce-module-overview/', 'dashboard', 'free-theme', 'documentation' ), 'links' => array( array( 'link_class' => 'ast-learn-more', 'link_url' => astra_get_pro_url( 'https://wpastra.com/docs/woocommerce-module-overview/', 'dashboard', 'free-theme', 'documentation' ), 'link_text' => __( 'Documentation', 'astra' ), 'target_blank' => true, ), ), ), 'edd' => array( 'title' => 'Easy Digital Downloads', 'class' => 'ast-addon', 'condition' => defined( 'ASTRA_EXT_VER' ) && class_exists( 'Easy_Digital_Downloads' ) ? true : false, 'title_url' => astra_get_pro_url( 'https://wpastra.com/docs/easy-digital-downloads-module-overview/', 'dashboard', 'free-theme', 'documentation' ), 'links' => array( array( 'link_class' => 'ast-learn-more', 'link_url' => astra_get_pro_url( 'https://wpastra.com/docs/easy-digital-downloads-module-overview/', 'dashboard', 'free-theme', 'documentation' ), 'link_text' => __( 'Documentation', 'astra' ), 'target_blank' => true, ), ), ), 'learndash' => array( 'title' => 'LearnDash', 'condition' => defined( 'ASTRA_EXT_VER' ) && class_exists( 'SFWD_LMS' ) ? true : false, 'description' => __( 'Supercharge your LearnDash website with amazing design features.', 'astra' ), 'class' => 'ast-addon', 'title_url' => astra_get_pro_url( 'https://wpastra.com/docs/learndash-integration-in-astra-pro/', 'dashboard', 'free-theme', 'documentation' ), 'links' => array( array( 'link_class' => 'ast-learn-more', 'link_url' => astra_get_pro_url( 'https://wpastra.com/docs/learndash-integration-in-astra-pro/', 'dashboard', 'free-theme', 'documentation' ), 'link_text' => __( 'Documentation', 'astra' ), 'target_blank' => true, ), ), ), 'lifterlms' => array( 'title' => 'LifterLMS', 'class' => 'ast-addon', 'condition' => defined( 'ASTRA_EXT_VER' ) && class_exists( 'LifterLMS' ) ? true : false, 'title_url' => astra_get_pro_url( 'https://wpastra.com/docs/lifterlms-module-pro/', 'dashboard', 'free-theme', 'documentation' ), 'links' => array( array( 'link_class' => 'ast-learn-more', 'link_url' => astra_get_pro_url( 'https://wpastra.com/docs/lifterlms-module-pro/', 'dashboard', 'free-theme', 'documentation' ), 'link_text' => __( 'Documentation', 'astra' ), 'target_blank' => true, ), ), ), 'white-label' => array( 'title' => __( 'White Label', 'astra' ), 'class' => 'ast-addon', 'title_url' => astra_get_pro_url( 'https://wpastra.com/docs/how-to-white-label-astra/', 'dashboard', 'free-theme', 'documentation' ), 'links' => array( array( 'link_class' => 'ast-learn-more', 'link_url' => astra_get_pro_url( 'https://wpastra.com/docs/how-to-white-label-astra/', 'dashboard', 'free-theme', 'documentation' ), 'link_text' => __( 'Documentation', 'astra' ), 'target_blank' => true, ), ), ), ) ); } /** * Get Astra's recommended WooCommerce extensions. * * @param bool $under_useful_plugins Add under useful plugins or not. * * @since 4.7.3 * @return array * @access public */ public static function astra_get_woo_extensions( $under_useful_plugins = true ) { $extensions = array( array( 'title' => 'CartFlows: Create Sales Funnel', 'subtitle' => $under_useful_plugins ? __( '#1 Sales Funnel WordPress Builder.', 'astra' ) : __( 'Build high-converting E-Commerce stores with CartFlows, the ultimate checkout and funnel builder.', 'astra' ), 'status' => self::get_plugin_status( 'cartflows/cartflows.php' ), 'slug' => 'cartflows', 'path' => 'cartflows/cartflows.php', 'redirection' => ( false === get_option( 'wcf_setup_complete', false ) && ! get_option( 'wcf_setup_skipped', false ) ) ? admin_url( 'index.php?page=cartflow-setup' ) : admin_url( 'admin.php?page=cartflows' ), 'ratings' => '(380+)', 'activations' => '200,000+', 'logoPath' => array( 'internal_icon' => false, 'icon_path' => 'https://ps.w.org/cartflows/assets/icon.svg' ), ), array( 'title' => 'Variations Swatches by CartFlows', 'subtitle' => $under_useful_plugins ? __( 'Beautiful store variation swatches.', 'astra' ) : __( 'Convert WooCommerce variation dropdown attributes into attractive swatches instantly.', 'astra' ), 'status' => self::get_plugin_status( 'variation-swatches-woo/variation-swatches-woo.php' ), 'slug' => 'variation-swatches-woo', 'path' => 'variation-swatches-woo/variation-swatches-woo.php', 'redirection' => admin_url( 'admin.php?page=cfvsw_settings' ), 'ratings' => '(30+)', 'activations' => '200,000+', 'logoPath' => array( 'internal_icon' => false, 'icon_path' => 'https://ps.w.org/variation-swatches-woo/assets/icon.svg', ), ), array( 'title' => 'Cart Abandonment Recovery', 'subtitle' => $under_useful_plugins ? __( 'Recover lost revenue automatically.', 'astra' ) : __( 'Capture emails at checkout and send follow-up emails to recover lost revenue.', 'astra' ), 'status' => self::get_plugin_status( 'woo-cart-abandonment-recovery/woo-cart-abandonment-recovery.php' ), 'slug' => 'woo-cart-abandonment-recovery', 'path' => 'woo-cart-abandonment-recovery/woo-cart-abandonment-recovery.php', 'redirection' => admin_url( 'admin.php?page=woo-cart-abandonment-recovery' ), 'ratings' => '(475+)', 'activations' => '200,000+', 'logoPath' => array( 'internal_icon' => false, 'icon_path' => 'https://ps.w.org/woo-cart-abandonment-recovery/assets/icon-128x128.png', ), ), ); if ( ! $under_useful_plugins ) { $extensions[] = array( 'title' => 'Stripe Payment Gateway for WooCommerce', 'subtitle' => __( 'Stripe Payments for WooCommerce ensures secure acceptance of credit cards, Apple Pay, and Google Pay.', 'astra' ), 'status' => self::get_plugin_status( 'checkout-plugins-stripe-woo/checkout-plugins-stripe-woo.php' ), 'slug' => 'checkout-plugins-stripe-woo', 'path' => 'checkout-plugins-stripe-woo/checkout-plugins-stripe-woo.php', 'redirection' => ( false === get_option( 'cpsw_setup_status', false ) ) ? admin_url( 'index.php?page=cpsw-onboarding' ) : admin_url( 'admin.php?page=wc-settings&tab=cpsw_api_settings' ), 'ratings' => '(15+)', 'activations' => '100,000+', 'logoPath' => array( 'internal_icon' => false, 'icon_path' => 'https://ps.w.org/checkout-plugins-stripe-woo/assets/icon-128x128.gif', ), ); $extensions[] = array( 'title' => 'PayPal Payments For WooCommerce', 'subtitle' => __( 'PayPal Payments For WooCommerce simplifies and secures PayPal transactions on your store.', 'astra' ), 'status' => self::get_plugin_status( 'checkout-paypal-woo/checkout-paypal-woo.php' ), 'slug' => 'checkout-paypal-woo', 'path' => 'checkout-paypal-woo/checkout-paypal-woo.php', 'redirection' => ( false === get_option( 'cpsw_setup_status', false ) ) ? admin_url( 'index.php?page=cpsw-onboarding' ) : admin_url( 'admin.php?page=wc-settings&tab=cpsw_api_settings' ), 'ratings' => '(2)', 'activations' => '3,000+', 'logoPath' => array( 'internal_icon' => false, 'icon_path' => 'https://ps.w.org/checkout-paypal-woo/assets/icon-128x128.jpg', ), ); } $extensions[] = array( 'title' => 'Spectra: Blocks Builder', 'subtitle' => $under_useful_plugins ? __( 'Free WordPress Page Builder.', 'astra' ) : __( 'Power-up block editor with advanced blocks for faster and effortlessly website creation.', 'astra' ), 'status' => self::get_plugin_status( 'ultimate-addons-for-gutenberg/ultimate-addons-for-gutenberg.php' ), 'slug' => 'ultimate-addons-for-gutenberg', 'path' => 'ultimate-addons-for-gutenberg/ultimate-addons-for-gutenberg.php', 'redirection' => admin_url( 'options-general.php?page=spectra' ), 'ratings' => '(1400+)', 'activations' => '800,000+', 'logoPath' => array( 'internal_icon' => false, 'icon_path' => 'https://ps.w.org/ultimate-addons-for-gutenberg/assets/icon.svg', ), ); return $extensions; } /** * Get Astra's useful plugins. * Extend this in following way - * * // array( * // 'title' => "Plugin Name", * // 'subtitle' => "Plugin description goes here.", * // 'path' => 'plugin-slug/plugin-slug.php', * // 'redirection' => admin_url( 'admin.php?page=sc-dashboard' ), * // 'status' => self::get_plugin_status( 'plugin-slug/plugin-slug.php' ), * // 'logoPath' => array( * // 'internal_icon' => true, // true = will take internal Astra's any icon. false = provide next custom icon link. * // 'icon_path' => "spectra", // If internal_icon false then - example custom SVG URL: ASTRA_THEME_URI . 'inc/assets/images/astra.svg'. * // ), * // ), * * @since 4.0.0 * @return array * @access public */ public static function astra_get_useful_plugins() { // Making useful plugin section dynamic. if ( class_exists( 'WooCommerce' ) ) { $useful_plugins = self::astra_get_woo_extensions(); } else { $sc_api_token = get_option( 'sc_api_token', '' ); $surecart_redirection = empty( $sc_api_token ) ? 'sc-getting-started' : 'sc-dashboard'; $useful_plugins = array( array( 'title' => 'SureCart', 'subtitle' => __( 'The new way to sell on WordPress.', 'astra' ), 'status' => self::get_plugin_status( 'surecart/surecart.php' ), 'slug' => 'surecart', 'path' => 'surecart/surecart.php', 'redirection' => admin_url( 'admin.php?page=' . esc_attr( $surecart_redirection ) ), 'logoPath' => array( 'internal_icon' => false, 'icon_path' => 'https://ps.w.org/surecart/assets/icon-128x128.png', ), ), array( 'title' => 'Spectra', 'subtitle' => __( 'Free WordPress Page Builder.', 'astra' ), 'status' => self::get_plugin_status( 'ultimate-addons-for-gutenberg/ultimate-addons-for-gutenberg.php' ), 'slug' => 'ultimate-addons-for-gutenberg', 'path' => 'ultimate-addons-for-gutenberg/ultimate-addons-for-gutenberg.php', 'redirection' => admin_url( 'options-general.php?page=spectra' ), 'logoPath' => array( 'internal_icon' => false, 'icon_path' => 'https://ps.w.org/ultimate-addons-for-gutenberg/assets/icon.svg', ), ), array( 'title' => 'SureTriggers', 'subtitle' => __( 'Automate your WordPress setup.', 'astra' ), 'isPro' => false, 'status' => self::get_plugin_status( 'suretriggers/suretriggers.php' ), 'slug' => 'suretriggers', 'path' => 'suretriggers/suretriggers.php', 'redirection' => admin_url( 'admin.php?page=suretriggers' ), 'logoPath' => array( 'internal_icon' => true, 'icon_path' => 'suretriggers', ), ), array( 'title' => 'Presto Player', 'subtitle' => __( 'Ultimate Video Player For WordPress.', 'astra' ), 'status' => self::get_plugin_status( 'presto-player/presto-player.php' ), 'slug' => 'presto-player', 'path' => 'presto-player/presto-player.php', 'redirection' => admin_url( 'edit.php?post_type=pp_video_block' ), 'logoPath' => array( 'internal_icon' => false, 'icon_path' => 'https://ps.w.org/presto-player/assets/icon-128x128.png', ), ), ); } return apply_filters( 'astra_useful_plugins', $useful_plugins ); } /** * Get Astra's recommended integrations. * Extend this in following way - * * // array( * // 'title' => "Plugin Name", * // 'subtitle' => "Plugin description goes here.", * // 'isPro' => false, * // 'status' => self::get_plugin_status( 'plugin-slug/plugin-slug.php' ), * // 'path' => 'plugin-slug/plugin-slug.php', * // 'redirection' => admin_url( 'admin.php?page=sc-dashboard' ), * // 'logoPath' => array( * // 'internal_icon' => true, // true = will take internal Astra's any icon. false = provide next custom icon link. * // 'icon_path' => "spectra", // If internal_icon false then - example custom SVG URL: ASTRA_THEME_URI . 'inc/assets/images/astra.svg'. * // ), * // ), * * @since 4.0.0 * @return array * @access public */ public static function astra_get_integrations() { $sc_api_token = get_option( 'sc_api_token', '' ); $surecart_redirection = empty( $sc_api_token ) ? 'sc-getting-started' : 'sc-dashboard'; return apply_filters( 'astra_integrated_plugins', array( array( 'title' => 'Spectra', 'subtitle' => __( 'Free WordPress Page Builder Plugin.', 'astra' ), 'isPro' => false, 'status' => self::get_plugin_status( 'ultimate-addons-for-gutenberg/ultimate-addons-for-gutenberg.php' ), 'slug' => 'ultimate-addons-for-gutenberg', 'path' => 'ultimate-addons-for-gutenberg/ultimate-addons-for-gutenberg.php', 'redirection' => admin_url( 'options-general.php?page=spectra' ), 'logoPath' => array( 'internal_icon' => false, 'icon_path' => 'https://ps.w.org/ultimate-addons-for-gutenberg/assets/icon.svg', ), ), array( 'title' => 'SureCart', 'subtitle' => __( 'Simplifying selling online with WordPress.', 'astra' ), 'isPro' => false, 'status' => self::get_plugin_status( 'surecart/surecart.php' ), 'redirection' => admin_url( 'admin.php?page=' . esc_attr( $surecart_redirection ) ), 'slug' => 'surecart', 'path' => 'surecart/surecart.php', 'logoPath' => array( 'internal_icon' => false, 'icon_path' => 'https://ps.w.org/surecart/assets/icon-128x128.png', ), ), array( 'title' => 'SureTriggers', 'subtitle' => __( 'Automate your WordPress setup.', 'astra' ), 'isPro' => false, 'status' => self::get_plugin_status( 'suretriggers/suretriggers.php' ), 'slug' => 'suretriggers', 'path' => 'suretriggers/suretriggers.php', 'redirection' => admin_url( 'admin.php?page=suretriggers' ), 'logoPath' => array( 'internal_icon' => true, 'icon_path' => 'suretriggers', ), ), ) ); } /** * Settings app scripts * * @since 4.0.0 * @param array $localize Variable names. */ public function settings_app_scripts( $localize ) { $handle = 'astra-admin-dashboard-app'; $build_path = ASTRA_THEME_ADMIN_DIR . 'assets/build/'; $build_url = ASTRA_THEME_ADMIN_URL . 'assets/build/'; $script_asset_path = $build_path . 'dashboard-app.asset.php'; /** @psalm-suppress MissingFile */ // phpcs:ignore Generic.Commenting.DocComment.MissingShort $script_info = file_exists( $script_asset_path ) ? include $script_asset_path : array( // phpcs:ignore WPThemeReview.CoreFunctionality.FileInclude.FileIncludeFound -- Not a template file so loading in a normal way. 'dependencies' => array(), 'version' => ASTRA_THEME_VERSION, ); /** @psalm-suppress MissingFile */ // phpcs:ignore Generic.Commenting.DocComment.MissingShort $script_dep = array_merge( $script_info['dependencies'], array( 'updates', 'wp-hooks' ) ); wp_register_script( $handle, $build_url . 'dashboard-app.js', $script_dep, $script_info['version'], true ); wp_register_style( $handle, $build_url . 'dashboard-app.css', array(), ASTRA_THEME_VERSION ); wp_register_style( 'astra-admin-google-fonts', 'https://fonts.googleapis.com/css2?family=Inter:wght@200&display=swap', array(), ASTRA_THEME_VERSION ); wp_enqueue_script( $handle ); wp_set_script_translations( $handle, 'astra' ); wp_enqueue_style( 'astra-admin-google-fonts' ); wp_enqueue_style( $handle ); wp_style_add_data( $handle, 'rtl', 'replace' ); wp_localize_script( $handle, 'astra_admin', $localize ); } /** * Add footer link. * * @since 4.0.0 */ public function astra_admin_footer_link() { $theme_name = astra_get_theme_name(); if ( astra_is_white_labelled() ) { $footer_text = '<span id="footer-thankyou">' . __( 'Thank you for using', 'astra' ) . '<span class="focus:text-astra-hover active:text-astra-hover hover:text-astra-hover"> ' . esc_html( $theme_name ) . '.</span></span>'; } else { $footer_text = sprintf( /* translators: 1: Astra, 2: Theme rating link */ __( 'Enjoyed %1$s? Please leave us a %2$s rating. We really appreciate your support!', 'astra' ), '<span class="ast-footer-thankyou"><strong>' . esc_html( $theme_name ) . '</strong>', '<a href="https://wordpress.org/support/theme/astra/reviews/?rate=5#new-post" target="_blank">★★★★★</a></span>' ); } return $footer_text; } } Astra_Menu::get_instance();