Astra_Builder_Helper
Class Astra_Builder_Helper.
Description
Source
File: inc/core/builder/class-astra-builder-helper.php
final class Astra_Builder_Helper {
/**
* Config context general tab.
*
* @var string[][]
*/
public static $general_tab = array(
array(
'setting' => 'ast_selected_tab',
'value' => 'general',
),
);
/**
* Config context general tab config.
*
* @var string[][]
*/
public static $general_tab_config = array(
'setting' => 'ast_selected_tab',
'value' => 'general',
);
/**
* Config context design tab.
*
* @var string[][]
*/
public static $design_tab = array(
array(
'setting' => 'ast_selected_tab',
'value' => 'design',
),
);
/**
* Config context design tab.
*
* @var string[][]
*/
public static $design_tab_config = array(
'setting' => 'ast_selected_tab',
'value' => 'design',
);
/**
* Config Tablet device context.
*
* @var string[][]
*/
public static $tablet_device = array(
array(
'setting' => 'ast_selected_device',
'operator' => 'in',
'value' => array( 'tablet' ),
),
);
/**
* Config Mobile device context.
*
* @var string[][]
*/
public static $mobile_device = array(
array(
'setting' => 'ast_selected_device',
'operator' => 'in',
'value' => array( 'mobile' ),
),
);
/**
* Config Mobile device context.
*
* @var string[][]
*/
public static $responsive_devices = array(
array(
'setting' => 'ast_selected_device',
'operator' => 'in',
'value' => array( 'tablet', 'mobile' ),
),
);
/**
* Config Mobile device context.
*
* @var string[][]
*/
public static $responsive_general_tab = array(
array(
'setting' => 'ast_selected_tab',
'value' => 'general',
),
array(
'setting' => 'ast_selected_device',
'operator' => 'in',
'value' => array( 'tablet', 'mobile' ),
),
);
/**
* Config Desktop device context.
*
* @var string[][]
*/
public static $desktop_general_tab = array(
array(
'setting' => 'ast_selected_tab',
'value' => 'general',
),
array(
'setting' => 'ast_selected_device',
'operator' => '==',
'value' => 'desktop',
),
);
/**
* Default responsive spacing control value.
*
* @var string[][]
*/
public static $default_responsive_spacing = array(
'desktop' => array(
'top' => '',
'right' => '',
'bottom' => '',
'left' => '',
),
'tablet' => array(
'top' => '',
'right' => '',
'bottom' => '',
'left' => '',
),
'mobile' => array(
'top' => '',
'right' => '',
'bottom' => '',
'left' => '',
),
'desktop-unit' => 'px',
'tablet-unit' => 'px',
'mobile-unit' => 'px',
);
/**
* Config Tablet device context.
*
* @var string[][]
*/
public static $tablet_general_tab = array(
array(
'setting' => 'ast_selected_tab',
'value' => 'general',
),
array(
'setting' => 'ast_selected_device',
'operator' => '==',
'value' => 'tablet',
),
);
/**
* Config Mobile device context.
*
* @var string[][]
*/
public static $mobile_general_tab = array(
array(
'setting' => 'ast_selected_tab',
'value' => 'general',
),
array(
'setting' => 'ast_selected_device',
'operator' => '==',
'value' => 'mobile',
),
);
/**
* No. Of. Component Limit.
*
* @var int
*/
public static $component_limit = 10;
/**
* No. Of. Component count array.
*
* @var int
*/
public static $component_count_array = array();
/**
* No. Of. Footer Widgets.
*
* @var int
*/
public static $num_of_footer_widgets;
/**
* No. Of. Footer HTML.
*
* @var int
*/
public static $num_of_footer_html;
/**
* No. Of. Header Widgets.
*
* @var int
*/
public static $num_of_header_widgets;
/**
* No. Of. Header Menu.
*
* @var int
*/
public static $num_of_header_menu;
/**
* No. Of. Header Buttons.
*
* @var int
*/
public static $num_of_header_button;
/**
* No. Of. Footer Buttons.
*
* @var int
*/
public static $num_of_footer_button;
/**
* No. Of. Header HTML.
*
* @var int
*/
public static $num_of_header_html;
/**
* No. Of. Footer Columns.
*
* @var int
*/
public static $num_of_footer_columns;
/**
* No. Of. Header Social Icons.
*
* @var int
*/
public static $num_of_header_social_icons;
/**
* No. Of. Footer Social Icons.
*
* @var int
*/
public static $num_of_footer_social_icons;
/**
* No. Of. Header Dividers.
*
* @since 3.0.0
* @var int
*/
public static $num_of_header_divider;
/**
* No. Of. Footer Dividers.
*
* @since 3.0.0
* @var int
*/
public static $num_of_footer_divider;
/**
* Check if migrated to new HFB.
*
* @var int
*/
public static $is_header_footer_builder_active;
/**
* Footer Row layout
*
* @var array
*/
public static $footer_row_layouts;
/**
* Header Desktop Items
*
* @var array
*/
public static $header_desktop_items = null;
/**
* Footer Desktop Items
*
* @var array
*/
public static $footer_desktop_items = null;
/**
* Header Mobile Items
*
* @var array
*/
public static $header_mobile_items = null;
/**
* Member Variable
*
* @var instance
*/
public static $loaded_grid = null;
/**
* Member Variable
*
* @var instance
*/
private static $instance = null;
/**
* Member Variable
*
* @var grid_size_mapping
*/
public static $grid_size_mapping = array(
'6-equal' => 'repeat( 6, 1fr )',
'5-equal' => 'repeat( 5, 1fr )',
'4-equal' => 'repeat( 4, 1fr )',
'4-lheavy' => '2fr 1fr 1fr 1fr',
'4-rheavy' => '1fr 1fr 1fr 2fr',
'3-equal' => 'repeat( 3, 1fr )',
'3-lheavy' => '2fr 1fr 1fr',
'3-rheavy' => '1fr 1fr 2fr',
'3-cheavy' => '1fr 2fr 1fr',
'3-cwide' => '1fr 3fr 1fr',
'3-firstrow' => '1fr 1fr',
'3-lastrow' => '1fr 1fr',
'2-equal' => 'repeat( 2, 1fr )',
'2-lheavy' => '2fr 1fr',
'2-rheavy' => '1fr 2fr',
'2-full' => '2fr',
'full' => '1fr',
);
/**
* Initiator
*/
public static function get_instance() {
if ( is_null( self::$instance ) ) {
self::$instance = new self();
}
return self::$instance;
}
/**
* Constructor
*/
public function __construct() {
self::$component_count_array = self::get_component_count();
self::$num_of_header_button = defined( 'ASTRA_EXT_VER' ) ? self::$component_count_array['header-button'] : 1;
self::$num_of_footer_button = defined( 'ASTRA_EXT_VER' ) ? self::$component_count_array['footer-button'] : 0;
self::$num_of_header_html = defined( 'ASTRA_EXT_VER' ) ? self::$component_count_array['header-html'] : 2;
self::$num_of_footer_html = defined( 'ASTRA_EXT_VER' ) ? self::$component_count_array['footer-html'] : 2;
self::$num_of_header_menu = defined( 'ASTRA_EXT_VER' ) ? self::$component_count_array['header-menu'] : 2;
self::$num_of_header_widgets = defined( 'ASTRA_EXT_VER' ) ? self::$component_count_array['header-widget'] : 2;
self::$num_of_footer_widgets = defined( 'ASTRA_EXT_VER' ) ? self::$component_count_array['footer-widget'] : 4;
self::$num_of_header_social_icons = defined( 'ASTRA_EXT_VER' ) ? self::$component_count_array['header-social-icons'] : 1;
self::$num_of_footer_social_icons = defined( 'ASTRA_EXT_VER' ) ? self::$component_count_array['footer-social-icons'] : 1;
// Divider.
self::$num_of_header_divider = defined( 'ASTRA_EXT_VER' ) ? self::$component_count_array['header-divider'] : 0;
self::$num_of_footer_divider = defined( 'ASTRA_EXT_VER' ) ? self::$component_count_array['footer-divider'] : 0;
self::$num_of_footer_columns = defined( 'ASTRA_EXT_VER' ) ? apply_filters( 'astra_footer_column_count', 6 ) : 6;
self::$footer_row_layouts = apply_filters(
'astra_footer_row_layout',
array(
'desktop' => array(
'6' => array(
'6-equal' => array(
'icon' => 'sixcol',
),
),
'5' => array(
'5-equal' => array(
'icon' => 'fivecol',
),
),
'4' => array(
'4-equal' => array(
'icon' => 'fourcol',
),
'4-lheavy' => array(
'icon' => 'lfourforty',
),
'4-rheavy' => array(
'icon' => 'rfourforty',
),
),
'3' => array(
'3-equal' => array(
'icon' => 'threecol',
),
'3-lheavy' => array(
'icon' => 'lefthalf',
),
'3-rheavy' => array(
'icon' => 'righthalf',
),
'3-cheavy' => array(
'icon' => 'centerhalf',
),
'3-cwide' => array(
'icon' => 'widecenter',
),
),
'2' => array(
'2-equal' => array(
'icon' => 'twocol',
),
'2-lheavy' => array(
'icon' => 'twoleftgolden',
),
'2-rheavy' => array(
'icon' => 'tworightgolden',
),
),
'1' => array(
'full' => array(
'icon' => 'row',
),
),
),
'tablet' => array(
'6' => array(
'6-equal' => array(
'tooltip' => __( 'Equal Width Columns', 'astra' ),
'icon' => 'sixcol',
),
'full' => array(
'tooltip' => __( 'Collapse to Rows', 'astra' ),
'icon' => 'collapserowsix',
),
),
'5' => array(
'5-equal' => array(
'tooltip' => __( 'Equal Width Columns', 'astra' ),
'icon' => 'fivecol',
),
'full' => array(
'tooltip' => __( 'Collapse to Rows', 'astra' ),
'icon' => 'collapserowfive',
),
),
'4' => array(
'4-equal' => array(
'tooltip' => __( 'Equal Width Columns', 'astra' ),
'icon' => 'fourcol',
),
'2-equal' => array(
'tooltip' => __( 'Two Column Grid', 'astra' ),
'icon' => 'grid',
),
'full' => array(
'tooltip' => __( 'Collapse to Rows', 'astra' ),
'icon' => 'collapserowfour',
),
),
'3' => array(
'3-equal' => array(
'tooltip' => __( 'Equal Width Columns', 'astra' ),
'icon' => 'threecol',
),
'3-lheavy' => array(
'tooltip' => __( 'Left Heavy 50/25/25', 'astra' ),
'icon' => 'lefthalf',
),
'3-rheavy' => array(
'tooltip' => __( 'Right Heavy 25/25/50', 'astra' ),
'icon' => 'righthalf',
),
'3-cheavy' => array(
'tooltip' => __( 'Center Heavy 25/50/25', 'astra' ),
'icon' => 'centerhalf',
),
'3-cwide' => array(
'tooltip' => __( 'Wide Center 20/60/20', 'astra' ),
'icon' => 'widecenter',
),
'3-firstrow' => array(
'tooltip' => __( 'First Row, Next Columns 100 - 50/50', 'astra' ),
'icon' => 'firstrow',
),
'3-lastrow' => array(
'tooltip' => __( 'Last Row, Previous Columns 50/50 - 100', 'astra' ),
'icon' => 'lastrow',
),
'full' => array(
'tooltip' => __( 'Collapse to Rows', 'astra' ),
'icon' => 'collapserowthree',
),
),
'2' => array(
'2-equal' => array(
'tooltip' => __( 'Equal Width Columns', 'astra' ),
'icon' => 'twocol',
),
'2-lheavy' => array(
'tooltip' => __( 'Left Heavy 66/33', 'astra' ),
'icon' => 'twoleftgolden',
),
'2-rheavy' => array(
'tooltip' => __( 'Right Heavy 33/66', 'astra' ),
'icon' => 'tworightgolden',
),
'full' => array(
'tooltip' => __( 'Collapse to Rows', 'astra' ),
'icon' => 'collapserow',
),
),
'1' => array(
'full' => array(
'tooltip' => __( 'Single Row', 'astra' ),
'icon' => 'row',
),
),
),
'mobile' => array(
'6' => array(
'6-equal' => array(
'tooltip' => __( 'Equal Width Columns', 'astra' ),
'icon' => 'sixcol',
),
'full' => array(
'tooltip' => __( 'Collapse to Rows', 'astra' ),
'icon' => 'collapserowsix',
),
),
'5' => array(
'5-equal' => array(
'tooltip' => __( 'Equal Width Columns', 'astra' ),
'icon' => 'fivecol',
),
'full' => array(
'tooltip' => __( 'Collapse to Rows', 'astra' ),
'icon' => 'collapserowfive',
),
),
'4' => array(
'4-equal' => array(
'icon' => 'fourcol',
),
'2-equal' => array(
'icon' => 'grid',
),
'full' => array(
'icon' => 'collapserowfour',
),
),
'3' => array(
'3-equal' => array(
'icon' => 'threecol',
),
'3-lheavy' => array(
'icon' => 'lefthalf',
),
'3-rheavy' => array(
'icon' => 'righthalf',
),
'3-cheavy' => array(
'icon' => 'centerhalf',
),
'3-cwide' => array(
'icon' => 'widecenter',
),
'3-firstrow' => array(
'icon' => 'firstrow',
),
'3-lastrow' => array(
'icon' => 'lastrow',
),
'full' => array(
'icon' => 'collapserowthree',
),
),
'2' => array(
'2-equal' => array(
'icon' => 'twocol',
),
'2-lheavy' => array(
'icon' => 'twoleftgolden',
),
'2-rheavy' => array(
'icon' => 'tworightgolden',
),
'full' => array(
'icon' => 'collapserow',
),
),
'1' => array(
'full' => array(
'icon' => 'row',
),
),
),
'responsive' => true,
)
);
self::$header_desktop_items = apply_filters(
'astra_header_desktop_items',
array(
'logo' => array(
'name' => __( 'Site Title & Logo', 'astra' ),
'icon' => 'admin-appearance',
'section' => 'title_tagline',
'delete' => false,
),
'search' => array(
'name' => __( 'Search', 'astra' ),
'icon' => 'search',
'section' => 'section-header-search',
'delete' => false,
),
'account' => array(
'name' => __( 'Account', 'astra' ),
'icon' => 'admin-users',
'section' => 'section-header-account',
'delete' => false,
),
)
);
self::$footer_desktop_items = apply_filters(
'astra_footer_desktop_items',
array(
'copyright' => array(
'name' => 'Copyright',
'icon' => 'nametag',
'section' => 'section-footer-copyright',
'delete' => false,
),
'menu' => array(
'name' => 'Footer Menu',
'icon' => 'menu',
'section' => 'section-footer-menu',
'delete' => false,
),
)
);
if ( class_exists( 'Astra_Woocommerce' ) ) {
$woo_cart_name = class_exists( 'Easy_Digital_Downloads' ) ? __( 'Woo Cart', 'astra' ) : __( 'Cart', 'astra' );
self::$header_desktop_items['woo-cart'] = array(
'name' => $woo_cart_name,
'icon' => 'cart',
'section' => 'section-header-woo-cart',
);
}
if ( class_exists( 'Easy_Digital_Downloads' ) ) {
$edd_cart_name = class_exists( 'Astra_Woocommerce' ) ? __( 'EDD Cart', 'astra' ) : __( 'Cart', 'astra' );
self::$header_desktop_items['edd-cart'] = array(
'name' => $edd_cart_name,
'icon' => 'cart',
'section' => 'section-header-edd-cart',
);
}
self::$header_mobile_items = apply_filters(
'astra_header_mobile_items',
array(
'logo' => array(
'name' => __( 'Site Title & Logo', 'astra' ),
'icon' => 'admin-appearance',
'section' => 'title_tagline',
),
'search' => array(
'name' => __( 'Search', 'astra' ),
'icon' => 'search',
'section' => 'section-header-search',
),
'mobile-trigger' => array(
'name' => __( 'Toggle Button', 'astra' ),
'icon' => 'menu-alt',
'section' => 'section-header-mobile-trigger',
),
'mobile-menu' => array(
'name' => __( 'Off-Canvas Menu', 'astra' ),
'icon' => 'menu-alt',
'section' => 'section-header-mobile-menu',
),
'account' => array(
'name' => __( 'Account', 'astra' ),
'icon' => 'admin-users',
'section' => 'section-header-account',
),
)
);
if ( class_exists( 'Astra_Woocommerce' ) ) {
self::$header_mobile_items['woo-cart'] = array(
'name' => $woo_cart_name,
'icon' => 'cart',
'section' => 'section-header-woo-cart',
);
}
if ( class_exists( 'Easy_Digital_Downloads' ) ) {
self::$header_mobile_items['edd-cart'] = array(
'name' => $edd_cart_name,
'icon' => 'cart',
'section' => 'section-header-edd-cart',
);
}
self::$is_header_footer_builder_active = self::is_header_footer_builder_active();
add_filter( 'astra_addon_list', array( $this, 'deprecate_old_header_and_footer' ) );
}
/**
* Get count of all components.
*
* @since 3.0.0
*
* @return int Number of all components.
*/
public static function get_component_count() {
$component_keys_count = array(
'header-button' => 2,
'footer-button' => 2,
'header-html' => 2,
'footer-html' => 2,
'header-menu' => 2,
'header-widget' => 4,
'footer-widget' => 4,
'header-social-icons' => 1,
'footer-social-icons' => 1,
'header-divider' => 0,
'footer-divider' => 0,
'removed-items' => array(),
);
$component_keys_count = array_merge(
$component_keys_count,
apply_filters(
'astra_builder_elements_count',
$component_keys_count
)
);
$skip_it_keys = array( 'removed-items', 'flag' );
foreach ( $component_keys_count as $component_type => $component_count ) {
if ( in_array( $component_type, $skip_it_keys, true ) ) {
continue;
}
$component_keys_count[ $component_type ] = min( $component_count, self::$component_limit );
}
return $component_keys_count;
}
/**
* Deprecate Header Sections, Mobile Headers, Footer Widgets for new users and migrated users.
*
* @since 3.0.0
* @param array $args The arguments as per the filter.
* @return array $args Updated arguments as per the filter.
*/
public function deprecate_old_header_and_footer( $args ) {
if ( self::$is_header_footer_builder_active ) {
unset( $args['mobile-header'] );
unset( $args['header-sections'] );
unset( $args['advanced-footer'] );
}
return $args;
}
/**
* For existing users, do not load the wide/full width image CSS by default.
*
* @since 3.0.0
* @return boolean false if it is an existing user , true if not.
*/
public static function is_header_footer_builder_active() {
$astra_settings = get_option( ASTRA_THEME_SETTINGS );
$is_header_footer_builder = isset( $astra_settings['is-header-footer-builder'] ) ? (bool) $astra_settings['is-header-footer-builder'] : true;
return apply_filters( 'astra_is_header_footer_builder_active', $is_header_footer_builder );
}
/**
* Check if Migrated to new Astra Builder.
*/
public static function is_new_user() {
return astra_get_option( 'header-footer-builder-notice', true );
}
/**
* Adds a check to see if the side columns should run.
*
* @param string $row the name of the row.
*/
public static function has_mobile_side_columns( $row = 'primary' ) {
$mobile_sides = false;
$elements = astra_get_option( 'header-mobile-items' );
if ( isset( $elements ) && isset( $elements[ $row ] ) ) {
if ( ( isset( $elements[ $row ][ $row . '_left' ] ) && is_array( $elements[ $row ][ $row . '_left' ] ) &&
! empty( $elements[ $row ][ $row . '_left' ] ) ) || ( isset( $elements[ $row ][ $row . '_left_center' ] ) &&
is_array( $elements[ $row ][ $row . '_left_center' ] ) &&
! empty( $elements[ $row ][ $row . '_left_center' ] ) ) || ( isset( $elements[ $row ][ $row . '_right_center' ] ) &&
is_array( $elements[ $row ][ $row . '_right_center' ] ) && ! empty( $elements[ $row ][ $row . '_right_center' ] ) ) ||
( isset( $elements[ $row ][ $row . '_right' ] ) && is_array( $elements[ $row ][ $row . '_right' ] ) &&
! empty( $elements[ $row ][ $row . '_right' ] ) ) ) {
$mobile_sides = true;
}
}
return $mobile_sides;
}
/**
* Adds a check to see if the center column should run.
*
* @param string $row the name of the row.
*/
public static function has_mobile_center_column( $row = 'primary' ) {
$mobile_center = false;
$elements = astra_get_option( 'header-mobile-items' );
if ( isset( $elements ) && isset( $elements[ $row ] ) && isset( $elements[ $row ][ $row . '_center' ] ) &&
is_array( $elements[ $row ][ $row . '_center' ] ) && ! empty( $elements[ $row ][ $row . '_center' ] ) ) {
$mobile_center = true;
}
return $mobile_center;
}
/**
* Adds support to render header columns.
*
* @param string $row the name of the row.
* @param string $column the name of the column.
* @param string $header the name of the header.
* @param string $builder the name of the builder.
*/
public static function render_builder_markup( $row = 'primary', $column = 'left', $header = 'desktop', $builder = 'header' ) {
$elements = astra_get_option( $builder . '-' . $header . '-items' );
if ( isset( $elements ) && isset( $elements[ $row ] ) && isset( $elements[ $row ][ $row . '_' . $column ] ) && is_array( $elements[ $row ][ $row . '_' . $column ] ) && ! empty( $elements[ $row ][ $row . '_' . $column ] ) ) {
foreach ( $elements[ $row ][ $row . '_' . $column ] as $key => $item ) {
if ( astra_wp_version_compare( '5.4.99', '>=' ) ) {
get_template_part(
'template-parts/' . $builder . '/builder/components',
'',
array(
'type' => $item,
'device' => $header,
)
);
} else {
set_query_var( 'type', $item );
get_template_part( 'template-parts/' . $builder . '/builder/components' );
}
}
}
}
/**
* Adds support to render Mobile Popup Markup.
*/
public static function render_mobile_popup_markup() {
if ( ! self::is_component_loaded( 'mobile-trigger', 'header' ) && ! is_customize_preview() ) {
return;
}
$off_canvas_slide = astra_get_option( 'off-canvas-slide' );
$mobile_header_type = astra_get_option( 'mobile-header-type' );
$content_alignment = astra_get_option( 'header-offcanvas-content-alignment' );
$side_class = 'content-align-' . $content_alignment . ' ';
if ( $mobile_header_type ) {
if ( 'off-canvas' === $mobile_header_type ) {
if ( $off_canvas_slide ) {
if ( 'left' === $off_canvas_slide ) {
$side_class .= 'ast-mobile-popup-left';
} else {
$side_class .= 'ast-mobile-popup-right';
}
}
} else {
$side_class .= 'ast-mobile-popup-full-width';
}
}
?>
<div id="ast-mobile-popup-wrapper">
<div id="ast-mobile-popup" class="ast-mobile-popup-drawer <?php echo esc_attr( $side_class ); ?>">
<div class="ast-mobile-popup-overlay"></div>
<div class="ast-mobile-popup-inner">
<div class="ast-mobile-popup-header">
<button id="menu-toggle-close" class="menu-toggle-close" aria-label="Close menu">
<span class="ast-svg-iconset">
<?php echo Astra_Builder_UI_Controller::fetch_svg_icon( 'close' ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped ?>
</span>
</button>
</div>
<div class="ast-mobile-popup-content">
<?php
/**
* Astra Off-Canvas
*/
do_action( 'astra_render_mobile_popup', 'popup', 'content' );
?>
</div>
<div class="ast-desktop-popup-content">
<?php
/**
* Astra Off-Canvas
*/
do_action( 'astra_render_desktop_popup', 'popup', 'content' );
?>
</div>
</div>
</div>
</div>
<?php
}
/**
* Check if Center column element exists.
*
* @param string $row the name of the row.
* @param string $builder_type the type of the builder.
* @param string $device Device.
*/
public static function has_center_column( $row = 'main', $builder_type = 'header', $device = 'desktop' ) {
$center = false;
$elements = astra_get_option( $builder_type . '-' . $device . '-items' );
if ( isset( $elements ) && isset( $elements[ $row ] ) &&
isset( $elements[ $row ][ $row . '_center' ] ) && is_array( $elements[ $row ][ $row . '_center' ] ) &&
! empty( $elements[ $row ][ $row . '_center' ] ) ) {
$center = true;
}
return $center;
}
/**
* Check if Side column element exists.
*
* @param string $row row.
* @param string $builder_type the type of the builder.
* @param string $device Device.
* @return bool
*/
public static function has_side_columns( $row = 'primary', $builder_type = 'header', $device = 'desktop' ) {
$sides = false;
$elements = astra_get_option( $builder_type . '-' . $device . '-items' );
if ( isset( $elements ) && isset( $elements[ $row ] ) ) {
if ( (
isset( $elements[ $row ][ $row . '_left' ] ) &&
is_array( $elements[ $row ][ $row . '_left' ] ) && ! empty( $elements[ $row ][ $row . '_left' ] ) ) ||
( isset( $elements[ $row ][ $row . '_left_center' ] ) &&
is_array( $elements[ $row ][ $row . '_left_center' ] ) && ! empty( $elements[ $row ][ $row . '_left_center' ] ) ) ||
( isset( $elements[ $row ][ $row . '_right_center' ] ) &&
is_array( $elements[ $row ][ $row . '_right_center' ] ) && ! empty( $elements[ $row ][ $row . '_right_center' ] ) ) ||
( isset( $elements[ $row ][ $row . '_right' ] ) &&
is_array( $elements[ $row ][ $row . '_right' ] ) && ! empty( $elements[ $row ][ $row . '_right' ] ) ) ) {
$sides = true;
}
}
return $sides;
}
/**
* Check if Footer Zone is empty.
*
* @param string $row row.
* @return bool
*/
public static function is_footer_row_empty( $row = 'primary' ) {
$sides = false;
$elements = astra_get_option( 'footer-desktop-items' );
if ( isset( $elements ) && isset( $elements[ $row ] ) ) {
for ( $i = 1; $i <= 5; $i++ ) {
if (
isset( $elements[ $row ][ $row . '_' . $i ] ) &&
is_array( $elements[ $row ][ $row . '_' . $i ] ) &&
! empty( $elements[ $row ][ $row . '_' . $i ] )
) {
$sides = true;
break;
}
}
}
return $sides;
}
/**
* Check if row is empty.
*
* @param string $row row.
* @param string $builder_type the type of the builder.
* @param string $device Device.
* @return bool
*/
public static function is_row_empty( $row = 'primary', $builder_type = 'header', $device = 'desktop' ) {
if ( false === self::has_center_column( $row, $builder_type, $device ) && false === self::has_side_columns( $row, $builder_type, $device ) ) {
return false;
}
return true;
}
/**
* Check if component placed on the builder.
*
* @param string $component_id component id.
* @param string $builder_type builder type.
* @param string $device Device type (mobile, desktop and both).
* @return bool
*/
public static function is_component_loaded( $component_id, $builder_type = 'header', $device = 'both' ) {
$loaded_components = array();
if ( is_null( self::$loaded_grid ) ) {
$grids['header_desktop'] = astra_get_option( 'header-desktop-items', array() );
$grids['header_mobile'] = astra_get_option( 'header-mobile-items', array() );
$grids['footer_both'] = astra_get_option( 'footer-desktop-items', array() );
if ( ! empty( $grids ) ) {
foreach ( $grids as $grid_row => $row_grids ) {
$components = array();
if ( ! empty( $row_grids ) ) {
foreach ( $row_grids as $row => $grid ) {
if ( ! in_array( $row, array( 'below', 'above', 'primary', 'popup' ) ) ) {
continue;
}
if ( ! is_array( $grid ) ) {
continue;
}
$result = array_values( $grid );
if ( is_array( $result ) ) {
$loaded_component = call_user_func_array( 'array_merge', $result );
$components[] = is_array( $loaded_component ) ? $loaded_component : array();
}
}
}
$loaded_components[ $grid_row ] = call_user_func_array( 'array_merge', $components );
}
}
if ( ! empty( $loaded_components ) ) {
// For both devices(mobile & desktop).
$loaded_components['header_both'] = array_merge( $loaded_components['header_desktop'], $loaded_components['header_mobile'] );
// For All device and builder type.
$all_components = call_user_func_array( 'array_merge', array_values( $loaded_components ) );
$loaded_components['all'] = array_unique( $all_components );
}
self::$loaded_grid = $loaded_components;
}
$loaded_components = self::$loaded_grid;
if ( 'all' === $builder_type && ! empty( $loaded_components['all'] ) ) {
$is_loaded = in_array( $component_id, $loaded_components['all'], true );
} else {
$is_loaded = in_array( $component_id, $loaded_components[ $builder_type . '_' . $device ], true );
}
return $is_loaded || is_customize_preview();
}
/**
* For existing users, do not apply dynamic CSS chages.
*
* @since 3.3.0
* @return boolean true if it is an existing user , false if not.
*/
public static function apply_flex_based_css() {
$astra_settings = get_option( ASTRA_THEME_SETTINGS );
$astra_settings['is-flex-based-css'] = isset( $astra_settings['is-flex-based-css'] ) ? $astra_settings['is-flex-based-css'] : true;
return apply_filters( 'astra_apply_flex_based_css', $astra_settings['is-flex-based-css'] );
}
}
Expand full source code Collapse full source code View on Trac
Methods
- __construct — Constructor
- apply_flex_based_css — For existing users, do not apply dynamic CSS chages.
- deprecate_old_header_and_footer — Deprecate Header Sections, Mobile Headers, Footer Widgets for new users and migrated users.
- get_component_count — Get count of all components.
- get_instance — Initiator
- get_translatable_string — Method to return single translatable string for builder components.
- get_translatable_strings — Method to return translatable strings for builder components.
- has_center_column — Check if Center column element exists.
- has_mobile_center_column — Adds a check to see if the center column should run.
- has_mobile_side_columns — Adds a check to see if the side columns should run.
- has_side_columns — Check if Side column element exists.
- is_component_loaded — Check if component placed on the builder.
- is_footer_row_empty — Check if Footer Zone is empty.
- is_header_footer_builder_active — For existing users, do not load the wide/full width image CSS by default.
- is_new_user — Check if Migrated to new Astra Builder.
- is_row_empty — Check if row is empty.
- render_builder_markup — Adds support to render header columns.
- render_mobile_popup_markup — Adds support to render Mobile Popup Markup.