File: /home4/cca63905/.trash/wp-content/themes/astra/inc/core/class-astra-admin-settings.php
<?php
/**
* Admin settings helper
*
* @link https://developer.wordpress.org/themes/basics/theme-functions/
*
* @package Astra
* @author Astra
* @copyright Copyright (c) 2020, Astra
* @link https://wpastra.com/
* @since Astra 1.0
*/
if ( ! defined( 'ABSPATH' ) ) {
exit;
}
if ( ! class_exists( 'Astra_Admin_Settings' ) ) {
/**
* Astra Admin Settings
*/
class Astra_Admin_Settings {
/**
* Menu page title
*
* @since 1.0
* @var array $menu_page_title
*/
public static $menu_page_title;
/**
* Page title
*
* @since 1.0
* @var string $page_title
*/
public static $page_title = 'Astra';
/**
* Plugin slug
*
* @since 1.0
* @var array $plugin_slug
*/
public static $plugin_slug = 'astra';
/**
* Default Menu position
*
* @since 1.0
* @var array $default_menu_position
*/
public static $default_menu_position = 'themes.php';
/**
* Parent Page Slug
*
* @since 1.0
* @var array $parent_page_slug
*/
public static $parent_page_slug = 'general';
/**
* Current Slug
*
* @since 1.0
* @var array $current_slug
*/
public static $current_slug = 'general';
/**
* Starter Templates Slug
*
* @since 2.3.2
* @var array $starter_templates_slug
*/
public static $starter_templates_slug = 'astra-sites';
/**
* Constructor
*/
public function __construct() {
if ( ! is_admin() ) {
return;
}
self::get_starter_templates_slug();
add_action( 'after_setup_theme', __CLASS__ . '::init_admin_settings', 99 );
}
/**
* Admin settings init
*/
public static function init_admin_settings() {
self::$menu_page_title = apply_filters( 'astra_menu_page_title', __( 'Astra Options', 'astra' ) );
self::$page_title = apply_filters( 'astra_page_title', __( 'Astra', 'astra' ) );
self::$plugin_slug = self::get_theme_page_slug();
add_action( 'admin_enqueue_scripts', __CLASS__ . '::register_scripts' );
if ( ! is_customize_preview() ) {
// add css on the admin init action to resolve the error in the PWA service worker js.
add_action( 'admin_head', __CLASS__ . '::admin_submenu_css' );
}
$requested_page = isset( $_REQUEST['page'] ) ? sanitize_text_field( wp_unslash( $_REQUEST['page'] ) ) : '';// phpcs:ignore WordPress.Security.NonceVerification.Recommended
if ( strpos( $requested_page, self::$plugin_slug ) !== false ) {
add_action( 'admin_enqueue_scripts', __CLASS__ . '::styles_scripts' );
// Let extensions hook into saving.
do_action( 'astra_admin_settings_scripts' );
if ( defined( 'ASTRA_EXT_VER' ) && version_compare( ASTRA_EXT_VER, '2.5.0', '<' ) ) {
self::save_settings();
}
}
add_action( 'customize_controls_enqueue_scripts', __CLASS__ . '::customizer_scripts' );
add_action( 'admin_menu', __CLASS__ . '::add_admin_menu', 99 );
add_action( 'astra_menu_general_action', __CLASS__ . '::general_page' );
add_action( 'astra_header_right_section', __CLASS__ . '::top_header_right_section' );
add_action( 'astra_welcome_page_right_sidebar_content', __CLASS__ . '::astra_welcome_page_starter_sites_section', 10 );
add_action( 'astra_welcome_page_right_sidebar_content', __CLASS__ . '::external_important_links_section', 11 );
add_action( 'astra_welcome_page_right_sidebar_content', __CLASS__ . '::astra_upgrade_pro_postbox', 12 );
add_action( 'astra_welcome_page_content', __CLASS__ . '::astra_welcome_page_content' );
add_action( 'astra_welcome_page_content', __class__ . '::astra_available_plugins', 30 );
// AJAX.
add_action( 'wp_ajax_astra-sites-plugin-activate', __CLASS__ . '::required_plugin_activate' );
add_action( 'wp_ajax_astra-sites-plugin-deactivate', __CLASS__ . '::required_plugin_deactivate' );
add_action( 'astra_notice_before_markup_astra-sites-on-active', __CLASS__ . '::load_astra_admin_script' );
add_action( 'admin_init', __CLASS__ . '::register_notices' );
add_action( 'astra_notice_before_markup', __CLASS__ . '::notice_assets' );
add_action( 'admin_init', __CLASS__ . '::minimum_addon_version_notice' );
if ( astra_showcase_upgrade_notices() ) {
add_action( 'admin_menu', __CLASS__ . '::register_pro_menu', 100 );
add_action( 'admin_init', __CLASS__ . '::upgrade_to_pro_wc_notice' );
add_action( 'wp_nav_menu_item_custom_fields', __CLASS__ . '::add_custom_fields', 10, 4 );
}
}
/**
* Add custom megamenu fields data to the menu.
*
* @access public
* @param int $id menu item id.
* @param object $item A single menu item.
* @param int $depth menu item depth.
* @param array $args menu item arguments.
* @return void
*
* @since 3.9.4
*/
public static function add_custom_fields( $id, $item, $depth, $args ) {
?>
<p class="description description-wide">
<button class="button button-secondary button-large astra-megamenu-opts-btn" style="margin: 8px 8px 8px 0;" disabled>
<?php echo esc_html__( 'Astra Menu Settings', 'astra' ); ?>
<svg width="17" height="16" style="vertical-align: sub; opacity: 0.5;" viewBox="0 0 17 16" fill="none" xmlns="http://www.w3.org/2000/svg"> <path d="M12.5002 7.2001H11.7002V4.8001C11.7002 3.0401 10.2602 1.6001 8.5002 1.6001C6.7402 1.6001 5.3002 3.0401 5.3002 4.8001V7.2001H4.5002C4.1002 7.2001 3.7002 7.6001 3.7002 8.0001V13.6001C3.7002 14.0001 4.1002 14.4001 4.5002 14.4001H12.5002C12.9002 14.4001 13.3002 14.0001 13.3002 13.6001V8.0001C13.3002 7.6001 12.9002 7.2001 12.5002 7.2001ZM9.3002 12.8001H7.7002L8.0202 11.0401C7.6202 10.8801 7.3002 10.4001 7.3002 10.0001C7.3002 9.3601 7.8602 8.8001 8.5002 8.8001C9.1402 8.8001 9.7002 9.3601 9.7002 10.0001C9.7002 10.4801 9.4602 10.8801 8.9802 11.0401L9.3002 12.8001ZM10.1002 7.2001H6.9002V4.8001C6.9002 3.9201 7.6202 3.2001 8.5002 3.2001C9.3802 3.2001 10.1002 3.9201 10.1002 4.8001V7.2001Z" fill="#0284C7"></path> </svg>
</button>
<a href="<?php echo esc_url( ASTRA_PRO_UPGRADE_URL ); ?>" target="_blank" title="<?php echo __( 'Unlock with Astra Pro', 'astra' ); ?>">
<?php echo esc_html__( 'Unlock', 'astra' ); ?>
</a>
</p>
<?php
}
/**
* Register Custom Layout & Page Header Pro sub-menus.
*
* Add new admin pages as sub-menu under the main Astra Options menu.
*
* Fired by `admin_menu` action.
*
* @since 3.9.4
* @access public
*/
public static function register_pro_menu() {
add_theme_page(
__( 'Custom Layouts', 'astra' ),
__( 'Custom Layouts', 'astra' ),
'edit_theme_options',
'astra-advanced-hook',
__CLASS__ . '::preview_custom_layout'
);
add_theme_page(
__( 'Page Headers', 'astra' ),
__( 'Page Headers', 'astra' ),
'edit_theme_options',
'astra_adv_header',
__CLASS__ . '::preview_page_header'
);
}
/**
* Showcase Custom Layout highlight.
*
* @since 3.9.4
* @access public
*/
public static function preview_custom_layout() {
$ast_icon = apply_filters( 'astra_page_top_icon', true );
$ast_visit_site_url = apply_filters( 'astra_site_url', 'https://wpastra.com/?utm_source=welcome_page&utm_medium=logo_link&utm_campaign=astra_theme' );
$ast_wrapper_class = apply_filters( 'astra_welcome_wrapper_class', array() );
?>
<div class="ast-menu-page-wrapper wrap ast-clear <?php echo esc_attr( implode( ' ', $ast_wrapper_class ) ); ?>">
<div class="ast-theme-page-header">
<div class="ast-container ast-flex">
<div class="ast-theme-title">
<a href="<?php echo esc_url( $ast_visit_site_url ); ?>" target="_blank" rel="noopener" >
<?php if ( $ast_icon ) { ?>
<img src="<?php echo esc_url( ASTRA_THEME_URI . 'inc/assets/images/astra.svg' ); ?>" class="ast-theme-icon" alt="<?php echo esc_attr( self::$page_title ); ?> " >
<span class="astra-theme-version"><?php echo esc_html( ASTRA_THEME_VERSION ); ?></span>
<?php } ?>
<?php do_action( 'astra_welcome_page_header_title' ); ?>
</a>
</div>
<?php do_action( 'astra_header_right_section' ); ?>
</div>
</div>
<div class="ast-pro-posttype-preview-container">
<img src="<?php echo esc_url( ASTRA_THEME_URI . 'inc/assets/images/custom-layout.svg' ); ?>"/>
</div>
</div>
<div class="ast-pro-posttype-popup">
<div class="ast-pro-posttype-popup-innerwrap">
<img src="<?php echo esc_url( ASTRA_THEME_URI . 'inc/assets/images/astra-logo.svg' ); ?>"/>
<p><span class="ast-posttype-title"> <?php echo __( 'Custom Layouts', 'astra' ); ?> </span></p>
<p class="ast-posttype-description"> <?php echo __( 'Upgrade to Astra Pro for instant access to your website\'s full potential. Create unique layouts, headers and footers, custom pages and content areas with ease!', 'astra' ); ?> </p>
<a href="<?php echo esc_url( ASTRA_PRO_UPGRADE_URL ); ?>" target="_blank" class="button button-primary button-hero ast-upgrade-cpt-link">
<?php _e( 'Upgrade Now', 'astra' ); ?>
</a>
</div>
</div>
<?php
}
/**
* Showcase Page Header highlight.
*
* @since 3.9.4
* @access public
*/
public static function preview_page_header() {
$ast_icon = apply_filters( 'astra_page_top_icon', true );
$ast_visit_site_url = apply_filters( 'astra_site_url', 'https://wpastra.com/?utm_source=welcome_page&utm_medium=logo_link&utm_campaign=astra_theme' );
$ast_wrapper_class = apply_filters( 'astra_welcome_wrapper_class', array() );
?>
<div class="ast-menu-page-wrapper wrap ast-clear <?php echo esc_attr( implode( ' ', $ast_wrapper_class ) ); ?>">
<div class="ast-theme-page-header">
<div class="ast-container ast-flex">
<div class="ast-theme-title">
<a href="<?php echo esc_url( $ast_visit_site_url ); ?>" target="_blank" rel="noopener" >
<?php if ( $ast_icon ) { ?>
<img src="<?php echo esc_url( ASTRA_THEME_URI . 'inc/assets/images/astra.svg' ); ?>" class="ast-theme-icon" alt="<?php echo esc_attr( self::$page_title ); ?> " >
<span class="astra-theme-version"><?php echo esc_html( ASTRA_THEME_VERSION ); ?></span>
<?php } ?>
<?php do_action( 'astra_welcome_page_header_title' ); ?>
</a>
</div>
<?php do_action( 'astra_header_right_section' ); ?>
</div>
</div>
<div class="ast-pro-posttype-preview-container">
<img src="<?php echo esc_url( ASTRA_THEME_URI . 'inc/assets/images/page-header.svg' ); ?>"/>
</div>
</div>
<div class="ast-pro-posttype-popup">
<div class="ast-pro-posttype-popup-innerwrap">
<img src="<?php echo esc_url( ASTRA_THEME_URI . 'inc/assets/images/astra-logo.svg' ); ?>"/>
<p><span class="ast-posttype-title"> <?php echo __( 'Page Headers', 'astra' ); ?> </span></p>
<p class="ast-posttype-description"> <?php echo __( 'Make that instant connection with engaging page headers. Unlock the full potential of pages with full control over the look and feel of your page headers!', 'astra' ); ?> </p>
<a href="<?php echo esc_url( ASTRA_PRO_UPGRADE_URL ); ?>" target="_blank" class="button button-primary button-hero ast-upgrade-cpt-link">
<?php _e( 'Upgrade Now', 'astra' ); ?>
</a>
</div>
</div>
<?php
}
/**
* Astra upgrade to pro postbox.
*
* @since 3.9.4
*/
public static function astra_upgrade_pro_postbox() {
if ( defined( 'ASTRA_EXT_VER' ) ) {
return;
}
$status = astra_get_option( 'ast-disable-upgrade-notices', true );
?>
<div class="postbox">
<h2 class="hndle ast-normal-cursor">
<span><?php echo esc_html( apply_filters( 'astra_upgrade_pro_postbox', __( 'Build Better Websites with Astra Pro', 'astra' ) ) ); ?></span>
</h2>
<div class="inside">
</p>
<?php echo esc_html__( 'Access powerful features for painless WordPress design without the high costs.', 'astra' ); ?>
<p>
</p>
<?php echo esc_html__( 'Powerful tools, premium support, limitless opportunity with Astra Pro!', 'astra' ); ?>
<p>
</p>
<?php echo esc_html__( 'Toggle upgrade notices on or off ', 'astra' ); ?>
<a href="#" class="ast-disable-notices" data-value="<?php echo $status ? 0 : 1; ?>" target="_blank" rel="noopener">
<?php echo __( 'here.', 'astra' ); ?>
</a>
<p>
<label for="astra_upgrade_pro_postbox">
<a class="button button-primary" href="<?php echo esc_url( ASTRA_PRO_UPGRADE_URL ); ?>" target="_blank" rel="noopener">
<?php echo esc_html__( 'Upgrade to Astra Pro!', 'astra' ); ?>
</a>
</label>
</div>
</div>
<?php
}
/**
* Save All admin settings here
*/
public static function save_settings() {
// Only admins can save settings.
if ( ! current_user_can( 'manage_options' ) ) {
return;
}
// Let extensions hook into saving.
do_action( 'astra_admin_settings_save' );
}
/**
* Theme options page Slug getter including White Label string.
*
* @since 2.1.0
* @return string Theme Options Page Slug.
*/
public static function get_theme_page_slug() {
return apply_filters( 'astra_theme_page_slug', self::$plugin_slug );
}
/**
* Ask Theme Rating
*
* @since 1.4.0
*/
public static function register_notices() {
// Return if white labeled.
if ( astra_is_white_labelled() ) {
return;
}
/** @psalm-suppress PossiblyInvalidArgument */ // phpcs:ignore Generic.Commenting.DocComment.MissingShort
$current_slug = isset( $_GET['page'] ) ? sanitize_text_field( wp_unslash( $_GET['page'] ) ) : ''; // phpcs:ignore WordPress.Security.NonceVerification.Recommended
/** @psalm-suppress PossiblyInvalidArgument */ // phpcs:ignore Generic.Commenting.DocComment.MissingShort
// Force Astra welcome notice on theme activation.
if ( current_user_can( 'install_plugins' ) && ! defined( 'ASTRA_SITES_NAME' ) && '1' == get_option( 'fresh_site' ) && ! in_array( $current_slug, array( 'astra-advanced-hook', 'astra_adv_header' ), true ) ) {
$image_path = ASTRA_THEME_URI . 'inc/assets/images/astra-logo.svg';
$ast_sites_notice_btn = self::astra_sites_notice_button();
if ( file_exists( WP_PLUGIN_DIR . '/astra-sites/astra-sites.php' ) && is_plugin_inactive( 'astra-sites/astra-sites.php' ) && is_plugin_inactive( 'astra-pro-sites/astra-pro-sites.php' ) ) {
$ast_sites_notice_btn['button_text'] = __( 'Get Started', 'astra' );
$ast_sites_notice_btn['class'] .= ' button button-primary button-hero';
} elseif ( ! file_exists( WP_PLUGIN_DIR . '/astra-sites/astra-sites.php' ) && is_plugin_inactive( 'astra-pro-sites/astra-pro-sites.php' ) ) {
$ast_sites_notice_btn['button_text'] = __( 'Get Started', 'astra' );
$ast_sites_notice_btn['class'] .= ' button button-primary button-hero';
// Astra Premium Sites - Active.
} else {
$ast_sites_notice_btn['class'] = ' button button-primary button-hero astra-notice-close';
}
$astra_sites_notice_args = array(
'id' => 'astra-sites-on-active',
'type' => 'info',
'message' => sprintf(
'<div class="notice-image">
<img src="%1$s" class="custom-logo" alt="Astra" itemprop="logo"></div>
<div class="notice-content">
<h2 class="notice-heading">
%2$s
</h2>
<p>%3$s</p>
<div class="astra-review-notice-container">
<a class="%4$s" %5$s %6$s %7$s %8$s %9$s %10$s> %11$s </a>
</div>
</div>',
$image_path,
__( 'Thank you for installing Astra!', 'astra' ),
__( 'Did you know Astra comes with dozens of ready-to-use <a href="https://wpastra.com/starter-templates/?utm_source=welcome_page&utm_medium=helpful_information&utm_campaign=astra_theme" target="_blank">starter templates</a>? Install the Starter Templates plugin to get started.', 'astra' ),
esc_attr( $ast_sites_notice_btn['class'] ),
'href="' . astra_get_prop( $ast_sites_notice_btn, 'link', '' ) . '"',
'data-slug="' . astra_get_prop( $ast_sites_notice_btn, 'data_slug', '' ) . '"',
'data-init="' . astra_get_prop( $ast_sites_notice_btn, 'data_init', '' ) . '"',
'data-settings-link-text="' . astra_get_prop( $ast_sites_notice_btn, 'data_settings_link_text', '' ) . '"',
'data-settings-link="' . astra_get_prop( $ast_sites_notice_btn, 'data_settings_link', '' ) . '"',
'data-activating-text="' . astra_get_prop( $ast_sites_notice_btn, 'activating_text', '' ) . '"',
esc_html( $ast_sites_notice_btn['button_text'] )
),
'priority' => 5,
'display-with-other-notices' => false,
'show_if' => class_exists( 'Astra_Ext_White_Label_Markup' ) ? Astra_Ext_White_Label_Markup::show_branding() : true,
);
Astra_Notices::add_notice(
$astra_sites_notice_args
);
}
}
/**
* Upgrade to Pro notice for Astra on WooCommerce pages.
*
* @since 3.9.4
*/
public static function upgrade_to_pro_wc_notice() {
/** @psalm-suppress PossiblyInvalidArgument */ // phpcs:ignore Generic.Commenting.DocComment.MissingShort
$current_slug = isset( $_GET['page'] ) ? sanitize_text_field( wp_unslash( $_GET['page'] ) ) : ''; // phpcs:ignore WordPress.Security.NonceVerification.Recommended
/** @psalm-suppress PossiblyInvalidArgument */ // phpcs:ignore Generic.Commenting.DocComment.MissingShort
if ( '' !== $current_slug && function_exists( 'WC' ) && in_array( $current_slug, array( 'wc-admin', 'wc-reports', 'wc-status', 'wc-addons', 'wc-settings' ), true ) ) {
$image_path = ASTRA_THEME_URI . 'inc/assets/images/astra-logo.svg';
$astra_sites_notice_args = array(
'id' => 'astra-upgrade-pro-wc',
'type' => 'info',
'message' => sprintf(
'<div class="notice-image">
<img src="%1$s" class="custom-logo" alt="Astra" itemprop="logo"></div>
<div class="notice-content">
<h2 class="notice-heading">
%2$s
</h2>
<p>%3$s</p>
<div class="astra-review-notice-container">
<a class="%4$s" %5$s> %6$s </a>
</div>
</div>',
$image_path,
__( 'Astra Works Seamlessly with WooCommerce!', 'astra' ),
__( 'Use every tool at your disposal to optimize your online store for conversion. All the advantages you need to make more profit!', 'astra' ),
esc_attr( 'button button-primary' ),
'href="' . ASTRA_PRO_UPGRADE_URL . '" target="_blank"',
__( 'Upgrade Now', 'astra' )
),
'priority' => 5,
'show_if' => is_admin() ? true : false,
'display-with-other-notices' => false,
);
Astra_Notices::add_notice(
$astra_sites_notice_args
);
}
}
/**
* Display notice for minimun version for Astra addon.
*
* @since 2.0.0
*/
public static function minimum_addon_version_notice() {
if ( ! defined( 'ASTRA_EXT_VER' ) ) {
return;
}
if ( version_compare( ASTRA_EXT_VER, ASTRA_EXT_MIN_VER ) < 0 ) {
$message = sprintf(
/* translators: %1$1s: Theme Name, %2$2s: Minimum Required version of the addon */
__( 'Please update the %1$1s to version %2$2s or higher. Ignore if already updated.', 'astra' ),
astra_get_addon_name(),
ASTRA_EXT_MIN_VER
);
$min_version = get_user_meta( get_current_user_id(), 'ast-minimum-addon-version-notice-min-ver', true );
if ( ! $min_version ) {
update_user_meta( get_current_user_id(), 'ast-minimum-addon-version-notice-min-ver', ASTRA_EXT_MIN_VER );
}
if ( version_compare( $min_version, ASTRA_EXT_MIN_VER, '!=' ) ) {
delete_user_meta( get_current_user_id(), 'ast-minimum-addon-version-notice' );
update_user_meta( get_current_user_id(), 'ast-minimum-addon-version-notice-min-ver', ASTRA_EXT_MIN_VER );
}
$notice_args = array(
'id' => 'ast-minimum-addon-version-notice',
'type' => 'warning',
'message' => $message,
'show_if' => true,
'repeat-notice-after' => false,
'priority' => 18,
'display-with-other-notices' => true,
);
Astra_Notices::add_notice( $notice_args );
}
}
/**
* Enqueue Astra Notices CSS.
*
* @since 2.0.0
*
* @return void
*/
public static function notice_assets() {
if ( is_rtl() ) {
wp_enqueue_style( 'astra-custom-notices-rtl', ASTRA_THEME_URI . 'inc/assets/css/astra-notices-rtl.css', array(), ASTRA_THEME_VERSION );
} else {
wp_enqueue_style( 'astra-custom-notices', ASTRA_THEME_URI . 'inc/assets/css/astra-notices.css', array(), ASTRA_THEME_VERSION );
}
}
/**
* Render button for Astra Site notices
*
* @since 1.6.5
* @return array $ast_sites_notice_btn Rendered button
*/
public static function astra_sites_notice_button() {
$ast_sites_notice_btn = array();
// Any of the Starter Templtes plugin - Active.
if ( is_plugin_active( 'astra-pro-sites/astra-pro-sites.php' ) || is_plugin_active( 'astra-sites/astra-sites.php' ) ) {
$ast_sites_notice_btn['class'] = 'active';
$ast_sites_notice_btn['button_text'] = __( 'See Library »', 'astra' );
$ast_sites_notice_btn['link'] = admin_url( 'themes.php?page=' . self::$starter_templates_slug );
return $ast_sites_notice_btn;
}
// Starter Templates PRO Plugin - Installed but Inactive.
if ( file_exists( WP_PLUGIN_DIR . '/astra-pro-sites/astra-pro-sites.php' ) && is_plugin_inactive( 'astra-pro-sites/astra-pro-sites.php' ) ) {
$ast_sites_notice_btn['class'] = 'astra-activate-recommended-plugin';
$ast_sites_notice_btn['button_text'] = __( 'Activate Importer Plugin', 'astra' );
$ast_sites_notice_btn['data_slug'] = 'astra-pro-sites';
$ast_sites_notice_btn['data_init'] = '/astra-pro-sites/astra-pro-sites.php';
$ast_sites_notice_btn['data_settings_link'] = admin_url( 'themes.php?page=' . self::$starter_templates_slug );
$ast_sites_notice_btn['data_settings_link_text'] = __( 'See Library »', 'astra' );
$ast_sites_notice_btn['activating_text'] = __( 'Activating Importer Plugin ', 'astra' ) . '…';
return $ast_sites_notice_btn;
}
// Starter Templates FREE Plugin - Installed but Inactive.
if ( file_exists( WP_PLUGIN_DIR . '/astra-sites/astra-sites.php' ) && is_plugin_inactive( 'astra-sites/astra-sites.php' ) ) {
$ast_sites_notice_btn['class'] = 'astra-activate-recommended-plugin';
$ast_sites_notice_btn['button_text'] = __( 'Activate Importer Plugin', 'astra' );
$ast_sites_notice_btn['data_slug'] = 'astra-sites';
$ast_sites_notice_btn['data_init'] = '/astra-sites/astra-sites.php';
$ast_sites_notice_btn['data_settings_link'] = admin_url( 'themes.php?page=' . self::$starter_templates_slug );
$ast_sites_notice_btn['data_settings_link_text'] = __( 'See Library »', 'astra' );
$ast_sites_notice_btn['activating_text'] = __( 'Activating Importer Plugin ', 'astra' ) . '…';
return $ast_sites_notice_btn;
}
// Any of the Starter Templates plugin not available.
if ( ! file_exists( WP_PLUGIN_DIR . '/astra-sites/astra-sites.php' ) || ! file_exists( WP_PLUGIN_DIR . '/astra-pro-sites/astra-pro-sites.php' ) ) {
$ast_sites_notice_btn['class'] = 'astra-install-recommended-plugin';
$ast_sites_notice_btn['button_text'] = __( 'Install Importer Plugin', 'astra' );
$ast_sites_notice_btn['data_slug'] = 'astra-sites';
$ast_sites_notice_btn['data_init'] = '/astra-sites/astra-sites.php';
$ast_sites_notice_btn['data_settings_link'] = admin_url( 'themes.php?page=' . self::$starter_templates_slug );
$ast_sites_notice_btn['data_settings_link_text'] = __( 'See Library »', 'astra' );
$ast_sites_notice_btn['detail_link_class'] = 'plugin-detail thickbox open-plugin-details-modal astra-starter-sites-detail-link';
$ast_sites_notice_btn['detail_link'] = network_admin_url( 'plugin-install.php?tab=plugin-information&plugin=astra-sites&TB_iframe=true&width=772&height=400' );
$ast_sites_notice_btn['detail_link_text'] = __( 'Details »', 'astra' );
return $ast_sites_notice_btn;
}
$ast_sites_notice_btn['class'] = 'active';
$ast_sites_notice_btn['button_text'] = __( 'See Library »', 'astra' );
$ast_sites_notice_btn['link'] = admin_url( 'themes.php?page=' . self::$starter_templates_slug );
return $ast_sites_notice_btn;
}
/**
* Check if installed Starter Sites plugin is new.
*
* @since 2.3.2
*/
public static function get_starter_templates_slug() {
if ( defined( 'ASTRA_PRO_SITES_VER' ) && version_compare( ASTRA_PRO_SITES_VER, '2.0.0', '>=' ) ) {
self::$starter_templates_slug = 'starter-templates';
}
if ( defined( 'ASTRA_SITES_VER' ) && version_compare( ASTRA_SITES_VER, '2.0.0', '>=' ) ) {
self::$starter_templates_slug = 'starter-templates';
}
}
/**
* Load the scripts and styles in the customizer controls.
*
* @since 1.2.1
*/
public static function customizer_scripts() {
$color_palettes = wp_json_encode( astra_color_palette() );
wp_add_inline_script( 'wp-color-picker', 'jQuery.wp.wpColorPicker.prototype.options.palettes = ' . $color_palettes . ';' );
}
/**
* Register admin scripts.
*
* @param String $hook Screen name where the hook is fired.
* @return void
*/
public static function register_scripts( $hook ) {
if ( in_array( $hook, array( 'post.php', 'post-new.php' ) ) ) {
$post_types = get_post_types( array( 'public' => true ) );
$screen = get_current_screen();
$post_type = $screen->id;
if ( in_array( $post_type, (array) $post_types ) ) {
echo '<style class="astra-meta-box-style">
.block-editor-page #side-sortables #astra_settings_meta_box select { min-width: 84%; padding: 3px 24px 3px 8px; height: 20px; }
.block-editor-page #normal-sortables #astra_settings_meta_box select { min-width: 200px; }
.block-editor-page .edit-post-meta-boxes-area #poststuff #astra_settings_meta_box h2.hndle { border-bottom: 0; }
.block-editor-page #astra_settings_meta_box .components-base-control__field, .block-editor-page #astra_settings_meta_box .block-editor-page .transparent-header-wrapper, .block-editor-page #astra_settings_meta_box .adv-header-wrapper, .block-editor-page #astra_settings_meta_box .stick-header-wrapper, .block-editor-page #astra_settings_meta_box .disable-section-meta div { margin-bottom: 8px; }
.block-editor-page #astra_settings_meta_box .disable-section-meta div label { vertical-align: inherit; }
.block-editor-page #astra_settings_meta_box .post-attributes-label-wrapper { margin-bottom: 4px; }
#side-sortables #astra_settings_meta_box select { min-width: 100%; }
#normal-sortables #astra_settings_meta_box select { min-width: 200px; }
</style>';
/**
* Register admin script for missing Layout option from nested Column Blocks inside Group/Cover blocks.
*
* @see https://github.com/WordPress/gutenberg/issues/33374 & https://gist.github.com/Luehrsen/c4aad3b33435058c19ea80f5f1c268e8 - Remove this once the issue is fixed.
*
* @since 3.7.9
*/
wp_enqueue_script( 'astra-column-block-comp-js', ASTRA_THEME_URI . 'inc/assets/js/column-block-compatibility.js', array( 'wp-util', 'wp-hooks', 'wp-blocks' ), ASTRA_THEME_VERSION, false );
}
}
/* Add CSS for the Submenu for BSF plugins added in Appearance Menu */
if ( ! is_customize_preview() ) {
if ( ! current_user_can( 'manage_options' ) ) {
return;
}
wp_register_script( 'astra-admin-settings', ASTRA_THEME_URI . 'inc/assets/js/astra-admin-menu-settings.js', array( 'jquery', 'wp-util', 'updates' ), ASTRA_THEME_VERSION, false );
$localize = array(
'ajaxUrl' => admin_url( 'admin-ajax.php' ),
'btnActivating' => __( 'Activating Importer Plugin ', 'astra' ) . '…',
'astraSitesLink' => admin_url( 'themes.php?page=' ),
'astraSitesLinkTitle' => __( 'See Library »', 'astra' ),
'recommendedPluiginActivatingText' => __( 'Activating', 'astra' ) . '…',
'recommendedPluiginDeactivatingText' => __( 'Deactivating', 'astra' ) . '…',
'recommendedPluiginActivateText' => __( 'Activate', 'astra' ),
'recommendedPluiginDeactivateText' => __( 'Deactivate', 'astra' ),
'recommendedPluiginSettingsText' => __( 'Settings', 'astra' ),
'astraPluginManagerNonce' => wp_create_nonce( 'astra-recommended-plugin-nonce' ),
'ajax_nonce' => wp_create_nonce( 'astra-builder-module-nonce' ),
'notices_ajax_nonce' => wp_create_nonce( 'astra-upgrade-notices-nonce' ),
'noticeEnableText' => __( 'Disabled', 'astra' ),
'noticeDisableText' => __( 'Enabled', 'astra' ),
'noticeEnablingText' => __( 'Enabling...', 'astra' ),
'noticeDisablingText' => __( 'Disabling...', 'astra' ),
'old_header_footer' => __( 'Use Old Header/Footer', 'astra' ),
'migrate_to_builder' => __( 'Use New Header/Footer Builder', 'astra' ),
);
wp_localize_script( 'astra-admin-settings', 'astra', apply_filters( 'astra_theme_js_localize', $localize ) );
}
}
/**
* Enqueues the needed CSS/JS for the builder's admin settings page.
*
* @since 1.0
*/
public static function styles_scripts() {
// Styles.
if ( is_rtl() ) {
wp_enqueue_style( 'astra-admin-settings-rtl', ASTRA_THEME_URI . 'inc/assets/css/astra-admin-menu-settings-rtl.css', array(), ASTRA_THEME_VERSION );
} else {
wp_enqueue_style( 'astra-admin-settings', ASTRA_THEME_URI . 'inc/assets/css/astra-admin-menu-settings.css', array(), ASTRA_THEME_VERSION );
}
if ( ! current_user_can( 'manage_options' ) ) {
return;
}
if ( ! file_exists( WP_PLUGIN_DIR . '/astra-sites/astra-sites.php' ) && is_plugin_inactive( 'astra-pro-sites/astra-pro-sites.php' ) ) {
// For starter site plugin popup detail "Details »" on Astra Options page.
wp_enqueue_script( 'plugin-install' );
wp_enqueue_script( 'thickbox' );
wp_enqueue_style( 'thickbox' );
}
// Script.
wp_enqueue_script( 'astra-admin-settings' );
}
/**
* Get register & enqueue astra-admin scripts.
*
* @since 3.6.6
*/
public static function load_astra_admin_script() {
if ( ! current_user_can( 'manage_options' ) ) {
return;
}
wp_register_script( 'astra-admin-settings', ASTRA_THEME_URI . 'inc/assets/js/astra-admin-menu-settings.js', array( 'jquery', 'wp-util', 'updates' ), ASTRA_THEME_VERSION, false );
$localize = array(
'ajaxUrl' => admin_url( 'admin-ajax.php' ),
'btnActivating' => __( 'Activating Importer Plugin ', 'astra' ) . '…',
'astraSitesLink' => admin_url( 'themes.php?page=' ),
'astraSitesLinkTitle' => __( 'See Library »', 'astra' ),
'recommendedPluiginActivatingText' => __( 'Activating', 'astra' ) . '…',
'recommendedPluiginDeactivatingText' => __( 'Deactivating', 'astra' ) . '…',
'recommendedPluiginActivateText' => __( 'Activate', 'astra' ),
'recommendedPluiginDeactivateText' => __( 'Deactivate', 'astra' ),
'recommendedPluiginSettingsText' => __( 'Settings', 'astra' ),
'astraPluginManagerNonce' => wp_create_nonce( 'astra-recommended-plugin-nonce' ),
'ajax_nonce' => wp_create_nonce( 'astra-builder-module-nonce' ),
'old_header_footer' => __( 'Use Old Header/Footer', 'astra' ),
'migrate_to_builder' => __( 'Use New Header/Footer Builder', 'astra' ),
);
wp_localize_script( 'astra-admin-settings', 'astra', apply_filters( 'astra_theme_js_localize', $localize ) );
// Script.
wp_enqueue_script( 'astra-admin-settings' );
}
/**
* Get and return page URL
*
* @param string $menu_slug Menu name.
* @since 1.0
* @return string page url
*/
public static function get_page_url( $menu_slug ) {
$parent_page = self::$default_menu_position;
if ( strpos( $parent_page, '?' ) !== false ) {
$query_var = '&page=' . self::$plugin_slug;
} else {
$query_var = '?page=' . self::$plugin_slug;
}
$parent_page_url = admin_url( $parent_page . $query_var );
$url = $parent_page_url . '&action=' . $menu_slug;
return esc_url( $url );
}
/**
* Add main menu
*
* @since 1.0
*/
public static function add_admin_menu() {
$parent_page = self::$default_menu_position;
$page_title = self::$menu_page_title;
$capability = 'manage_options';
$page_menu_slug = self::$plugin_slug;
$page_menu_func = __CLASS__ . '::menu_callback';
if ( apply_filters( 'astra_dashboard_admin_menu', true ) ) {
add_theme_page( $page_title, $page_title, $capability, $page_menu_slug, $page_menu_func );
} else {
do_action( 'astra_register_admin_menu', $parent_page, $page_title, $capability, $page_menu_slug, $page_menu_func );
}
}
/**
* Menu callback
*
* @since 1.0
*/
public static function menu_callback() {
$current_slug = isset( $_GET['action'] ) ? sanitize_text_field( wp_unslash( $_GET['action'] ) ) : self::$current_slug; // phpcs:ignore WordPress.Security.NonceVerification.Recommended
$current_slug = str_replace( '-', '_', $current_slug );
$ast_icon = apply_filters( 'astra_page_top_icon', true );
$ast_visit_site_url = apply_filters( 'astra_site_url', 'https://wpastra.com/?utm_source=welcome_page&utm_medium=logo_link&utm_campaign=astra_theme' );
$ast_wrapper_class = apply_filters( 'astra_welcome_wrapper_class', array( $current_slug ) );
?>
<div class="ast-menu-page-wrapper wrap ast-clear <?php echo esc_attr( implode( ' ', $ast_wrapper_class ) ); ?>">
<div class="ast-theme-page-header">
<div class="ast-container ast-flex">
<div class="ast-theme-title">
<a href="<?php echo esc_url( $ast_visit_site_url ); ?>" target="_blank" rel="noopener" >
<?php if ( $ast_icon ) { ?>
<img src="<?php echo esc_url( ASTRA_THEME_URI . 'inc/assets/images/astra.svg' ); ?>" class="ast-theme-icon" alt="<?php echo esc_attr( self::$page_title ); ?> " >
<span class="astra-theme-version"><?php echo esc_html( ASTRA_THEME_VERSION ); ?></span>
<?php } ?>
<?php do_action( 'astra_welcome_page_header_title' ); ?>
</a>
</div>
<?php do_action( 'astra_header_right_section' ); ?>
</div>
</div>
<?php do_action( 'astra_menu_' . esc_attr( $current_slug ) . '_action' ); ?>
</div>
<?php
}
/**
* Include general page
*
* @since 1.0
*/
public static function general_page() {
require_once ASTRA_THEME_DIR . 'inc/core/view-general.php';// phpcs:ignore WPThemeReview.CoreFunctionality.FileInclude.FileIncludeFound
}
/**
* External links through Astra Options page.
*
* @since 3.4.0
*/
public static function external_important_links_section() {
if ( astra_is_white_labelled() ) {
return;
}
?>
<div class="postbox">
<h2 class="hndle ast-normal-cursor">
<span><?php echo esc_html( apply_filters( 'astra_other_links_postbox_title', __( 'Important Links', 'astra' ) ) ); ?></span>
</h2>
<div class="inside">
<ul class="ast-other-links-list">
<li>
<span class="dashicons dashicons-admin-home"></span>
<a href="https://wpastra.com/?utm_source=welcome_page&utm_medium=sidebar&utm_campaign=astra_theme" target="_blank" rel="noopener"> <?php esc_html_e( 'Astra Website', 'astra' ); ?> </a>
</li>
<li>
<span class="dashicons dashicons-book"></span>
<a href="https://wpastra.com/docs/?utm_source=welcome_page&utm_medium=sidebar&utm_campaign=astra_theme" target="_blank" rel="noopener"> <?php esc_html_e( 'Knowledge Base', 'astra' ); ?> </a>
</li>
<li>
<span class="dashicons dashicons-sos"></span>
<a href="https://wpastra.com/contact/?utm_source=welcome_page&utm_medium=sidebar&utm_campaign=astra_theme" target="_blank" rel="noopener"> <?php esc_html_e( 'Five Star Support', 'astra' ); ?> </a>
</li>
<li>
<span class="dashicons dashicons-groups"></span>
<a href="https://www.facebook.com/groups/wpastra" target="_blank" rel="noopener"> <?php esc_html_e( 'Users Community Group', 'astra' ); ?> </a>
</li>
<li>
<span class="dashicons dashicons-star-filled"></span>
<a href="https://wordpress.org/support/theme/astra/reviews/?rate=5#new-post" target="_blank" rel="noopener"> <?php esc_html_e( 'Rate Us ★★★★★', 'astra' ); ?> </a>
</li>
</ul>
</div>
</div>
<?php
}
/**
* Starter Templates Post Box Title.
*
* @since 3.4.0
*
* @return string Starter Templates Plugin name.
*/
public static function get_starter_templates_title() {
$astra_sites_name = __( '230+ Starter Templates', 'astra' );
if ( method_exists( 'Astra_Ext_White_Label_Markup', 'get_whitelabel_string' ) ) {
$white_labelled_astra_sites_name = Astra_Ext_White_Label_Markup::get_whitelabel_string( 'astra-sites', 'name' );
if ( ! empty( $white_labelled_astra_sites_name ) ) {
$astra_sites_name = $white_labelled_astra_sites_name;
}
}
return $astra_sites_name;
}
/**
* Include Welcome page right starter sites content
*
* @since 1.2.4
*/
public static function astra_welcome_page_starter_sites_section() {
if ( astra_is_white_labelled() ) {
return;
}
?>
<div class="postbox">
<h2 class="hndle ast-normal-cursor">
<span class="dashicons dashicons-admin-customizer"></span>
<span><?php echo self::get_starter_templates_title(); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped ?></span>
</h2>
<img class="ast-starter-sites-img" alt="Starter Templates" src="<?php echo esc_url( ASTRA_THEME_URI . 'assets/images/astra-starter-sites.jpg' ); ?>">
<div class="inside">
<p>
<?php
$astra_starter_sites_doc_link = apply_filters( 'astra_starter_sites_documentation_link', astra_get_pro_url( 'https://wpastra.com/starter-templates/', 'welcome_page', 'sidebar', 'astra_theme' ) );
$astra_starter_sites_doc_link_text = apply_filters( 'astra_starter_sites_doc_link_text', __( 'Starter Templates?', 'astra' ) );
printf(
/* translators: %1$s: Starter site link. */
esc_html__( 'Did you know %1$s offers a free library of %2$s ', 'astra' ),
self::$page_title,
! empty( $astra_starter_sites_doc_link ) ? '<a href=' . esc_url( $astra_starter_sites_doc_link ) . ' target="_blank" rel="noopener">' . esc_html( $astra_starter_sites_doc_link_text ) . '</a>' :
esc_html( $astra_starter_sites_doc_link_text )
);
?>
</p>
<p>
<?php
esc_html_e( 'Choose from over 180 beautiful templates and kickstart your project!', 'astra' );
?>
</p>
<?php
$ast_sites_notice_btn = self::astra_sites_notice_button();
printf(
'<a class="%1$s" %2$s %3$s %4$s %5$s %6$s %7$s> %8$s </a>',
esc_attr( $ast_sites_notice_btn['class'] ),
'href="' . esc_url( astra_get_prop( $ast_sites_notice_btn, 'link', '' ) ) . '"',
'data-slug="' . esc_attr( astra_get_prop( $ast_sites_notice_btn, 'data_slug', '' ) ) . '"',
'data-init="' . esc_attr( astra_get_prop( $ast_sites_notice_btn, 'data_init', '' ) ) . '"',
'data-settings-link-text="' . esc_attr( astra_get_prop( $ast_sites_notice_btn, 'data_settings_link_text', '' ) ) . '"',
'data-settings-link="' . esc_attr( astra_get_prop( $ast_sites_notice_btn, 'data_settings_link', '' ) ) . '"',
'data-activating-text="' . esc_attr( astra_get_prop( $ast_sites_notice_btn, 'activating_text', '' ) ) . '"',
esc_html( $ast_sites_notice_btn['button_text'] )
);
printf(
'<a class="%1$s" %2$s target="_blank" rel="noopener"> %3$s </a>',
isset( $ast_sites_notice_btn['detail_link_class'] ) ? esc_attr( $ast_sites_notice_btn['detail_link_class'] ) : '',
isset( $ast_sites_notice_btn['detail_link'] ) ? 'href="' . esc_url( $ast_sites_notice_btn['detail_link'] ) . '"' : '', // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
isset( $ast_sites_notice_btn['detail_link_class'] ) ? esc_html( $ast_sites_notice_btn['detail_link_text'] ) : '' // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
);
?>
<div>
</div>
</div>
</div>
<?php
}
/**
* Include Welcome page content
*
* @since 1.2.4
*/
public static function astra_welcome_page_content() {
$astra_addon_tagline = apply_filters( 'astra_addon_list_tagline', __( 'More Options Available with Astra Pro!', 'astra' ) );
// Quick settings.
$quick_settings = apply_filters(
'astra_quick_settings',
array(
'header' => array(
'title' => __( 'Header Options', 'astra' ),
'dashicon' => 'dashicons-align-center',
'quick_url' => admin_url( 'customize.php?autofocus[panel]=panel-header-group' ),
),
'logo-favicon' => array(
'title' => __( 'Upload Logo', 'astra' ),
'dashicon' => 'dashicons-format-image',
'quick_url' => admin_url( 'customize.php?autofocus[control]=custom_logo' ),
),
'footer' => array(
'title' => __( 'Footer Settings', 'astra' ),
'dashicon' => 'dashicons-align-wide',
'quick_url' => admin_url( 'customize.php?autofocus[section]=section-footer-group' ),
),
'colors' => array(
'title' => __( 'Set Colors', 'astra' ),
'dashicon' => 'dashicons-admin-customizer',
'quick_url' => admin_url( 'customize.php?autofocus[section]=section-colors-background' ),
),
'layout' => array(
'title' => __( 'Layout Options', 'astra' ),
'dashicon' => 'dashicons-layout',
'quick_url' => admin_url( 'customize.php?autofocus[section]=section-container-layout' ),
),
'typography' => array(
'title' => __( 'Customize Fonts', 'astra' ),
'dashicon' => 'dashicons-editor-textcolor',
'quick_url' => admin_url( 'customize.php?autofocus[section]=section-typography' ),
),
'blog-layout' => array(
'title' => __( 'Blog Layouts', 'astra' ),
'dashicon' => 'dashicons-welcome-write-blog',
'quick_url' => admin_url( 'customize.php?autofocus[section]=section-blog-group' ),
),
'sidebars' => array(
'title' => __( 'Sidebar Options', 'astra' ),
'dashicon' => 'dashicons-align-left',
'quick_url' => admin_url( 'customize.php?autofocus[section]=section-sidebars' ),
),
)
);
$extensions = 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/', 'welcome_page', 'features', 'astra_theme' ),
'links' => array(
array(
'link_class' => 'ast-learn-more',
'link_url' => astra_get_pro_url( 'https://wpastra.com/docs/colors-background-module/', 'welcome_page', 'features', 'astra_theme' ),
'link_text' => __( 'Learn More »', 'astra' ),
'target_blank' => true,
),
),
),
'typography' => array(
'title' => __( 'Typography', 'astra' ),
'class' => 'ast-addon',
'title_url' => astra_get_pro_url( 'https://wpastra.com/docs/typography-module/', 'welcome_page', 'features', 'astra_theme' ),
'links' => array(
array(
'link_class' => 'ast-learn-more',
'link_url' => astra_get_pro_url( 'https://wpastra.com/docs/typography-module/', 'welcome_page', 'features', 'astra_theme' ),
'link_text' => __( 'Learn More »', '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/', 'welcome_page', 'features', 'astra_theme' ),
'links' => array(
array(
'link_class' => 'ast-learn-more',
'link_url' => astra_get_pro_url( 'https://wpastra.com/docs/spacing-addon-overview/', 'welcome_page', 'features', 'astra_theme' ),
'link_text' => __( 'Learn More »', '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/', 'welcome_page', 'features', 'astra_theme' ),
'links' => array(
array(
'link_class' => 'ast-learn-more',
'link_url' => astra_get_pro_url( 'https://wpastra.com/docs/blog-pro-overview/', 'welcome_page', 'features', 'astra_theme' ),
'link_text' => __( 'Learn More »', '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/', 'astra-dashboard', 'learn-more', 'welcome-page' ),
'links' => array(
array(
'link_class' => 'ast-learn-more',
'link_url' => astra_get_pro_url( 'https://wpastra.com/docs/mobile-header-with-astra/', 'astra-dashboard', 'learn-more', 'welcome-page' ),
'link_text' => __( 'Learn More »', '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/', 'astra-dashboard', 'learn-more', 'welcome-page' ),
'links' => array(
array(
'link_class' => 'ast-learn-more',
'link_url' => astra_get_pro_url( 'https://wpastra.com/docs/header-sections-pro/', 'astra-dashboard', 'learn-more', 'welcome-page' ),
'link_text' => __( 'Learn More »', '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/', 'welcome_page', 'features', 'astra_theme' ),
'links' => array(
array(
'link_class' => 'ast-learn-more',
'link_url' => astra_get_pro_url( 'https://wpastra.com/docs/nav-menu-addon/', 'welcome_page', 'features', 'astra_theme' ),
'link_text' => __( 'Learn More »', '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/', 'welcome_page', 'features', 'astra_theme' ),
'links' => array(
array(
'link_class' => 'ast-learn-more',
'link_url' => astra_get_pro_url( 'https://wpastra.com/docs/sticky-header-pro/', 'welcome_page', 'features', 'astra_theme' ),
'link_text' => __( 'Learn More »', '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/', 'welcome_page', 'features', 'astra_theme' ),
'links' => array(
array(
'link_class' => 'ast-learn-more',
'link_url' => astra_get_pro_url( 'https://wpastra.com/docs/page-headers-overview/', 'welcome_page', 'features', 'astra_theme' ),
'link_text' => __( 'Learn More »', 'astra' ),
'target_blank' => true,
),
),
),
'advanced-hooks' => array(
'title' => __( 'Custom Layouts', 'astra' ),
// 'icon' => ASTRA_THEME_URI . 'assets/img/astra-advanced-hooks.png',
'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/', 'welcome_page', 'features', 'astra_theme' ),
'links' => array(
array(
'link_class' => 'ast-learn-more',
'link_url' => astra_get_pro_url( 'https://wpastra.com/docs/custom-layouts-pro/', 'welcome_page', 'features', 'astra_theme' ),
'link_text' => __( 'Learn More »', '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/', 'welcome_page', 'features', 'astra_theme' ),
'links' => array(
array(
'link_class' => 'ast-learn-more',
'link_url' => astra_get_pro_url( 'https://wpastra.com/docs/site-layout-overview/', 'welcome_page', 'features', 'astra_theme' ),
'link_text' => __( 'Learn More »', '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/', 'astra-dashboard', 'learn-more', 'welcome-page' ),
'links' => array(
array(
'link_class' => 'ast-learn-more',
'link_url' => astra_get_pro_url( 'https://wpastra.com/docs/footer-widgets-astra-pro/', 'astra-dashboard', 'learn-more', 'welcome-page' ),
'link_text' => __( 'Learn More »', 'astra' ),
'target_blank' => true,
),
),
),
'scroll-to-top' => array(
'title' => __( 'Scroll To Top', 'astra' ),
'class' => 'ast-addon',
'title_url' => astra_get_pro_url( 'https://wpastra.com/docs/scroll-to-top-pro/', 'welcome_page', 'features', 'astra_theme' ),
'links' => array(
array(
'link_class' => 'ast-learn-more',
'link_url' => astra_get_pro_url( 'https://wpastra.com/docs/scroll-to-top-pro/', 'welcome_page', 'features', 'astra_theme' ),
'link_text' => __( 'Learn More »', 'astra' ),
'target_blank' => true,
),
),
),
'woocommerce' => array(
'title' => __( 'WooCommerce', 'astra' ),
'class' => 'ast-addon',
'title_url' => astra_get_pro_url( 'https://wpastra.com/docs/woocommerce-module-overview/', 'welcome_page', 'features', 'astra_theme' ),
'links' => array(
array(
'link_class' => 'ast-learn-more',
'link_url' => astra_get_pro_url( 'https://wpastra.com/docs/woocommerce-module-overview/', 'welcome_page', 'features', 'astra_theme' ),
'link_text' => __( 'Learn More »', 'astra' ),
'target_blank' => true,
),
),
),
'edd' => array(
'title' => __( 'Easy Digital Downloads', 'astra' ),
'class' => 'ast-addon',
'title_url' => astra_get_pro_url( 'https://wpastra.com/docs/easy-digital-downloads-module-overview/', 'welcome_page', 'features', 'astra_theme' ),
'links' => array(
array(
'link_class' => 'ast-learn-more',
'link_url' => astra_get_pro_url( 'https://wpastra.com/docs/easy-digital-downloads-module-overview/', 'welcome_page', 'features', 'astra_theme' ),
'link_text' => __( 'Learn More »', 'astra' ),
'target_blank' => true,
),
),
),
'learndash' => array(
'title' => __( 'LearnDash', 'astra' ),
'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/', 'welcome_page', 'features', 'astra_theme' ),
'links' => array(
array(
'link_class' => 'ast-learn-more',
'link_url' => astra_get_pro_url( 'https://wpastra.com/docs/learndash-integration-in-astra-pro/', 'welcome_page', 'features', 'astra_theme' ),
'link_text' => __( 'Learn More »', 'astra' ),
'target_blank' => true,
),
),
),
'lifterlms' => array(
'title' => __( 'LifterLMS', 'astra' ),
'class' => 'ast-addon',
'title_url' => astra_get_pro_url( 'https://wpastra.com/docs/lifterlms-module-pro/', 'welcome_page', 'features', 'astra_theme' ),
'links' => array(
array(
'link_class' => 'ast-learn-more',
'link_url' => astra_get_pro_url( 'https://wpastra.com/docs/lifterlms-module-pro/', 'welcome_page', 'features', 'astra_theme' ),
'link_text' => __( 'Learn More »', '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/', 'welcome_page', 'features', 'astra_theme' ),
'links' => array(
array(
'link_class' => 'ast-learn-more',
'link_url' => astra_get_pro_url( 'https://wpastra.com/docs/how-to-white-label-astra/', 'welcome_page', 'features', 'astra_theme' ),
'link_text' => __( 'Learn More »', 'astra' ),
'target_blank' => true,
),
),
),
)
);
?>
<div class="postbox">
<h2 class="hndle ast-normal-cursor"><span><?php esc_html_e( 'Links to Customizer Settings:', 'astra' ); ?></span></h2>
<div class="ast-quick-setting-section">
<?php
if ( ! empty( $quick_settings ) ) :
?>
<div class="ast-quick-links">
<ul class="ast-flex">
<?php
foreach ( (array) $quick_settings as $key => $link ) {
echo '<li class="' . esc_attr( $key ) . '"><span class="dashicons ' . esc_attr( $link['dashicon'] ) . '"></span><a class="ast-quick-setting-title" href="' . esc_url( $link['quick_url'] ) . '" target="_blank" rel="noopener">' . esc_html( $link['title'] ) . '</a></li>';
}
?>
</ul>
</div>
<?php endif; ?>
</div>
</div>
<div class="postbox">
<h2 class="hndle ast-normal-cursor ast-addon-heading ast-flex"><span><?php echo esc_html( $astra_addon_tagline ); ?></span>
<?php do_action( 'astra_addon_bulk_action' ); ?>
</h2>
<div class="ast-addon-list-section">
<?php
if ( ! empty( $extensions ) ) :
?>
<div>
<ul class="ast-addon-list">
<?php
foreach ( (array) $extensions as $addon => $info ) {
$title_url = ( isset( $info['title_url'] ) && ! empty( $info['title_url'] ) ) ? 'href="' . esc_url( $info['title_url'] ) . '"' : '';
$anchor_target = ( isset( $info['title_url'] ) && ! empty( $info['title_url'] ) ) ? "target='_blank' rel='noopener'" : '';
echo '<li id="' . esc_attr( $addon ) . '" class="' . esc_attr( $info['class'] ) . '"><a class="ast-addon-title"' . $title_url . $anchor_target . ' >' . esc_html( $info['title'] ) . '</a><div class="ast-addon-link-wrapper">'; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
foreach ( $info['links'] as $key => $link ) {
printf(
'<a class="%1$s" %2$s %3$s> %4$s </a>',
esc_attr( $link['link_class'] ),
isset( $link['link_url'] ) ? 'href="' . esc_url( $link['link_url'] ) . '"' : '',
( isset( $link['target_blank'] ) && $link['target_blank'] ) ? 'target="_blank" rel="noopener"' : '', // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
esc_html( $link['link_text'] )
);
}
echo '</div></li>';
}
?>
</ul>
</div>
<?php endif; ?>
</div>
</div>
<?php
}
/**
* Check if Spectra is installed.
*
* @since 3.9.2
*
* @access public
* @return array
*/
public static function astra_get_spectra_plugin_data() {
$path = 'ultimate-addons-for-gutenberg/ultimate-addons-for-gutenberg.php';
$plugins = get_plugins();
/** @psalm-suppress PossiblyUndefinedStringArrayOffset */ // phpcs:ignore Generic.Commenting.DocComment.MissingShort
return array(
'is_exist' => isset( $plugins[ $path ] ),
'version' => ( isset( $plugins[ $path ] ) && $plugins[ $path ]['Version'] ) ? $plugins[ $path ]['Version'] : '2.0.0',
);
/** @psalm-suppress PossiblyUndefinedStringArrayOffset */ // phpcs:ignore Generic.Commenting.DocComment.MissingShort
}
/**
* Include Welcome page content
*
* @since 1.2.4
*/
public static function astra_available_plugins() {
// Return if white labeled.
if ( astra_is_white_labelled() ) {
return;
}
$astra_addon_tagline = apply_filters(
'astra_available_plugins',
sprintf(
/* translators: %1s Astra Theme */
__( 'Extend %1s with free plugins!', 'astra' ),
astra_get_theme_name()
)
);
$spectra_plugin_data = self::astra_get_spectra_plugin_data();
/** @psalm-suppress PossiblyUndefinedStringArrayOffset */ // phpcs:ignore Generic.Commenting.DocComment.MissingShort
$spectra_plugin_slug = ( ! $spectra_plugin_data['is_exist'] ) || version_compare( $spectra_plugin_data['version'], '2.0.0', '>=' ) ? 'spectra' : 'uag';
/** @psalm-suppress PossiblyUndefinedStringArrayOffset */ // phpcs:ignore Generic.Commenting.DocComment.MissingShort
$recommended_plugins = apply_filters(
'astra_recommended_plugins',
array(
'ultimate-addons-for-gutenberg' =>
array(
'plugin-name' => __( 'Spectra — Free WordPress Page Builder Plugin', 'astra' ),
'plugin-init' => 'ultimate-addons-for-gutenberg/ultimate-addons-for-gutenberg.php',
'settings-link' => admin_url( 'options-general.php?page=' . esc_attr( $spectra_plugin_slug ) ),
'settings-link-text' => 'Settings',
'highlight-label' => __( 'Popular', 'astra' ),
'display' => function_exists( 'register_block_type' ),
),
'astra-import-export' =>
array(
'plugin-name' => __( 'Import / Export Customizer Settings', 'astra' ),
'plugin-init' => 'astra-import-export/astra-import-export.php',
'settings-link' => '',
'settings-link-text' => 'Settings',
),
'reset-astra-customizer' =>
array(
'plugin-name' => __( 'Astra Customizer Reset', 'astra' ),
'plugin-init' => 'reset-astra-customizer/class-astra-theme-customizer-reset.php',
'settings-link' => admin_url( 'customize.php' ),
'settings-link-text' => 'Settings',
),
'customizer-search' =>
array(
'plugin-name' => __( 'Customizer Search', 'astra' ),
'plugin-init' => 'customizer-search/customizer-search.php',
'settings-link' => admin_url( 'customize.php' ),
'settings-link-text' => 'Settings',
),
'astra-bulk-edit' =>
array(
'plugin-name' => __( 'Astra Bulk Edit', 'astra' ),
'plugin-init' => 'astra-bulk-edit/astra-bulk-edit.php',
'settings-link' => '',
'settings-link-text' => 'Settings',
),
'astra-widgets' =>
array(
'plugin-name' => __( 'Astra Widgets', 'astra' ),
'plugin-init' => 'astra-widgets/astra-widgets.php',
'settings-link' => admin_url( 'widgets.php' ),
'settings-link-text' => 'Settings',
),
'custom-fonts' =>
array(
'plugin-name' => __( 'Custom Fonts', 'astra' ),
'plugin-init' => 'custom-fonts/custom-fonts.php',
'settings-link' => admin_url( 'edit-tags.php?taxonomy=bsf_custom_fonts' ),
'settings-link-text' => 'Settings',
),
'custom-typekit-fonts' =>
array(
'plugin-name' => __( 'Custom Typekit Fonts', 'astra' ),
'plugin-init' => 'custom-typekit-fonts/custom-typekit-fonts.php',
'settings-link' => admin_url( 'themes.php?page=custom-typekit-fonts' ),
'settings-link-text' => 'Settings',
),
'sidebar-manager' =>
array(
'plugin-name' => __( 'Sidebar Manager', 'astra' ),
'plugin-init' => 'sidebar-manager/sidebar-manager.php',
'settings-link' => admin_url( 'edit.php?post_type=bsf-sidebar' ),
'settings-link-text' => 'Settings',
),
)
);
if ( apply_filters( 'astra_show_free_extend_plugins', true ) ) {
?>
<div class="postbox">
<h2 class="hndle ast-normal-cursor ast-addon-heading ast-flex"><span><?php echo esc_html( $astra_addon_tagline ); ?></span>
</h2>
<div class="ast-addon-list-section">
<?php
if ( ! empty( $recommended_plugins ) ) :
?>
<div>
<ul class="ast-addon-list">
<?php
foreach ( $recommended_plugins as $slug => $plugin ) {
$highlight_label_attr = isset( $plugin['highlight-label'] ) ? 'highlight-label="' . esc_html( $plugin['highlight-label'] ) . '"' : '';
// If display condition for the plugin does not meet, skip the plugin from displaying.
if ( isset( $plugin['display'] ) && false === $plugin['display'] ) {
continue;
}
$plugin_active_status = '';
if ( is_plugin_active( $plugin['plugin-init'] ) ) {
$plugin_active_status = ' active';
}
echo '<li ' . astra_attr(
'astra-recommended-plugin-' . esc_attr( $slug ),
array(
'id' => esc_attr( $slug ),
'class' => 'astra-recommended-plugin' . $plugin_active_status,
'data-slug' => $slug,
)
) . '>';
echo '<a href="' . esc_url( self::build_worg_plugin_link( $slug ) ) . '" target="_blank"' . $highlight_label_attr . '>';
echo esc_html( $plugin['plugin-name'] );
echo '</a>';
echo '<div class="ast-addon-link-wrapper">';
if ( ! is_plugin_active( $plugin['plugin-init'] ) ) {
if ( file_exists( WP_CONTENT_DIR . '/plugins/' . $plugin['plugin-init'] ) ) {
echo '<a ' . astra_attr(
'astra-activate-recommended-plugin',
array(
'data-slug' => $slug,
'href' => '#',
'data-init' => $plugin['plugin-init'],
'data-settings-link' => esc_url( $plugin['settings-link'] ),
'data-settings-link-text' => $plugin['settings-link-text'],
)
) . '>';
esc_html_e( 'Activate', 'astra' );
echo '</a>';
} else {
echo '<a ' . astra_attr(
'astra-install-recommended-plugin',
array(
'data-slug' => $slug,
'href' => '#',
'data-init' => $plugin['plugin-init'],
'data-settings-link' => esc_url( $plugin['settings-link'] ),
'data-settings-link-text' => $plugin['settings-link-text'],
)
) . '>';
esc_html_e( 'Activate', 'astra' );
echo '</a>';
}
} else {
echo '<a ' . astra_attr(
'astra-deactivate-recommended-plugin',
array(
'data-slug' => $slug,
'href' => '#',
'data-init' => $plugin['plugin-init'],
'data-settings-link' => esc_url( $plugin['settings-link'] ),
'data-settings-link-text' => $plugin['settings-link-text'],
)
) . '>';
esc_html_e( 'Deactivate', 'astra' );
echo '</a>';
if ( '' !== $plugin['settings-link'] ) {
echo '<a ' . astra_attr(
'astra-recommended-plugin-links',
array(
'data-slug' => $slug,
'href' => $plugin['settings-link'],
)
) . '>';
echo esc_html( $plugin['settings-link-text'] );
echo '</a>';
}
}
echo '</div>';
echo '</li>';
}
?>
</ul>
</div>
<?php endif; ?>
</div>
</div>
<?php
}
}
/**
* Build plugin's page URL on WordPress.org
* https://wordpress.org/plugins/{plugin-slug}
*
* @since 1.6.9
* @param String $slug plugin slug.
* @return String Plugin URL on WordPress.org
*/
private static function build_worg_plugin_link( $slug ) {
return esc_url( trailingslashit( 'https://wordpress.org/plugins/' . $slug ) );
}
/**
* Required Plugin Activate
*
* @since 1.2.4
*/
public static function required_plugin_activate() {
/** @psalm-suppress PossiblyInvalidArgument */ // phpcs:ignore Generic.Commenting.DocComment.MissingShort
$nonce = ( isset( $_POST['nonce'] ) ) ? sanitize_key( $_POST['nonce'] ) : '';
/** @psalm-suppress PossiblyInvalidArgument */ // phpcs:ignore Generic.Commenting.DocComment.MissingShort
if ( false === wp_verify_nonce( $nonce, 'astra-recommended-plugin-nonce' ) ) {
wp_send_json_error( esc_html_e( 'WordPress Nonce not validated.', 'astra' ) );
}
if ( ! current_user_can( 'install_plugins' ) || ! isset( $_POST['init'] ) || ! sanitize_text_field( wp_unslash( $_POST['init'] ) ) ) {
wp_send_json_error(
array(
'success' => false,
'message' => __( 'No plugin specified', 'astra' ),
)
);
}
$plugin_init = ( isset( $_POST['init'] ) ) ? sanitize_text_field( wp_unslash( $_POST['init'] ) ) : '';
$activate = activate_plugin( $plugin_init, '', false, true );
if ( '/astra-pro-sites/astra-pro-sites.php' === $plugin_init || '/astra-sites/astra-sites.php' === $plugin_init ) {
self::get_starter_templates_slug();
}
if ( is_wp_error( $activate ) ) {
wp_send_json_error(
array(
'success' => false,
'message' => $activate->get_error_message(),
'starter_template_slug' => self::$starter_templates_slug,
)
);
}
wp_send_json_success(
array(
'success' => true,
'message' => __( 'Plugin Successfully Activated', 'astra' ),
'starter_template_slug' => self::$starter_templates_slug,
)
);
}
/**
* Required Plugin Activate
*
* @since 1.2.4
*/
public static function required_plugin_deactivate() {
/** @psalm-suppress PossiblyInvalidArgument */ // phpcs:ignore Generic.Commenting.DocComment.MissingShort
$nonce = ( isset( $_POST['nonce'] ) ) ? sanitize_key( $_POST['nonce'] ) : '';
/** @psalm-suppress PossiblyInvalidArgument */ // phpcs:ignore Generic.Commenting.DocComment.MissingShort
if ( false === wp_verify_nonce( $nonce, 'astra-recommended-plugin-nonce' ) ) {
wp_send_json_error( esc_html_e( 'WordPress Nonce not validated.', 'astra' ) );
}
if ( ! current_user_can( 'install_plugins' ) || ! isset( $_POST['init'] ) || ! sanitize_text_field( wp_unslash( $_POST['init'] ) ) ) {
wp_send_json_error(
array(
'success' => false,
'message' => __( 'No plugin specified', 'astra' ),
)
);
}
$plugin_init = ( isset( $_POST['init'] ) ) ? sanitize_text_field( wp_unslash( $_POST['init'] ) ) : '';
$deactivate = deactivate_plugins( $plugin_init, '', false );
if ( is_wp_error( $deactivate ) ) {
wp_send_json_error(
array(
'success' => false,
'message' => $deactivate->get_error_message(),
)
);
}
wp_send_json_success(
array(
'success' => true,
'message' => __( 'Plugin Successfully Deactivated', 'astra' ),
)
);
}
/**
* Astra Header Right Section Links
*
* @since 1.2.4
*/
public static function top_header_right_section() {
$top_links = apply_filters(
'astra_header_top_links',
array(
'astra-theme-info' => array(
'title' => '<img src=" ' . ASTRA_THEME_URI . 'inc/assets/images/lightning-speed.svg" class="astra-lightning-icon" alt="Astra Lightning Speed">' . __( ' Lightning Fast & Fully Customizable WordPress theme!', 'astra' ),
),
)
);
if ( ! empty( $top_links ) ) {
?>
<div class="ast-top-links">
<ul>
<?php
foreach ( (array) $top_links as $key => $info ) {
/* translators: %1$s: Top Link URL wrapper, %2$s: Top Link URL, %3$s: Top Link URL target attribute */
printf(
'<li><%1$s %2$s %3$s > %4$s </%1$s>',
isset( $info['url'] ) ? 'a' : 'span',
isset( $info['url'] ) ? 'href="' . esc_url( $info['url'] ) . '"' : '', // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
isset( $info['url'] ) ? 'target="_blank" rel="noopener"' : '', // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
$info['title']// phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
);
}
?>
</ul>
</div>
<?php
}
}
/**
* Add custom CSS for admin area sub menu icons.
*
* @since 2.5.4
*/
public static function admin_submenu_css() {
echo '<style class="astra-menu-appearance-style">
#menu-appearance a[href^="edit.php?post_type=astra-"]:before,
#menu-appearance a[href^="themes.php?page=astra-"]:before,
#menu-appearance a[href^="themes.php?page=astra_"]:before,
#menu-appearance a[href^="edit.php?post_type=astra_"]:before,
#menu-appearance a[href^="edit-tags.php?taxonomy=bsf_custom_fonts"]:before,
#menu-appearance a[href^="themes.php?page=custom-typekit-fonts"]:before,
#menu-appearance a[href^="edit.php?post_type=bsf-sidebar"]:before {
content: "\21B3";
margin-right: 0.5em;
opacity: 0.5;
}
</style>';
}
}
new Astra_Admin_Settings();
}