';
/**
* Filters the HTML output of the search form.
*
* @param string $form The search form HTML output.
*/
$result = apply_filters( 'astra_get_search_form', $form ); // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedHooknameFound
if ( null === $result ) {
$result = $form;
}
if ( $echo ) {
echo wp_kses( $result, Astra_Addon_Kses::astra_addon_form_with_post_kses_protocols() );
} else {
return $result;
}
}
endif;
/**
* Get instance of WP_Filesystem.
*
* @since 2.6.4
*
* @return WP_Filesystem
*/
function astra_addon_filesystem() {
return astra_addon_filesystem::instance();
}
/**
* Check the WordPress version.
*
* @since 2.7.0
* @param string $version WordPress version to compare with the current version.
* @param string $compare Comparison value i.e > or < etc.
* @return bool True/False based on the $version and $compare value.
*/
function astra_addon_wp_version_compare( $version, $compare ) {
return version_compare( get_bloginfo( 'version' ), $version, $compare );
}
/**
* Adjust Brightness
*
* @param array $bg_obj Color code in HEX.
*
* @return array Color code in HEX.
*
* @since 2.7.1
*/
function astra_addon_get_megamenu_background_obj( $bg_obj ) {
$gen_bg_css = array();
$bg_img = isset( $bg_obj['background-image'] ) ? $bg_obj['background-image'] : '';
$bg_color = isset( $bg_obj['background-color'] ) ? $bg_obj['background-color'] : '';
if ( '' !== $bg_img && '' !== $bg_color ) {
$gen_bg_css = array(
'background-image' => 'linear-gradient(to right, ' . esc_attr( $bg_color ) . ', ' . esc_attr( $bg_color ) . '), url(' . esc_url( $bg_img ) . ')',
);
} elseif ( '' !== $bg_img ) {
$gen_bg_css = array( 'background-image' => 'url(' . esc_url( $bg_img ) . ')' );
} elseif ( '' !== $bg_color ) {
$gen_bg_css = array( 'background-color' => esc_attr( $bg_color ) );
}
if ( '' !== $bg_img ) {
if ( isset( $bg_obj['background-repeat'] ) ) {
$gen_bg_css['background-repeat'] = esc_attr( $bg_obj['background-repeat'] );
}
if ( isset( $bg_obj['background-position'] ) ) {
$gen_bg_css['background-position'] = esc_attr( $bg_obj['background-position'] );
}
if ( isset( $bg_obj['background-size'] ) ) {
$gen_bg_css['background-size'] = esc_attr( $bg_obj['background-size'] );
}
if ( isset( $bg_obj['background-attachment'] ) ) {
$gen_bg_css['background-attachment'] = esc_attr( $bg_obj['background-attachment'] );
}
}
return $gen_bg_css;
}
/**
* Calculate Astra Mega-menu spacing.
*
* @param array $spacing_obj - Spacing dimensions with their values.
*
* @return array parsed CSS.
*
* @since 3.0.0
*/
function astra_addon_get_megamenu_spacing_css( $spacing_obj ) {
$gen_spacing_css = array();
foreach ( $spacing_obj as $property => $value ) {
if ( '' == $value && 0 !== $value ) {
continue;
}
$gen_spacing_css[ $property ] = esc_attr( $spacing_obj[ $property ] ) . 'px';
}
return $gen_spacing_css;
}
/**
* Check whether blogs post structure title & meta is disabled or not.
*
* @since 4.0.0
* @return bool True if blogs post structure title & meta is disabled else false.
*/
function astra_addon_is_blog_title_meta_disabled() {
$blog_title_meta = astra_get_option( 'blog-post-structure' );
if ( is_array( $blog_title_meta ) && ! in_array( 'title-meta', $blog_title_meta ) ) {
return true;
}
return false;
}
/**
* Function which will return CSS for font-extras control.
* It includes - line-height, letter-spacing, text-decoration, font-style.
*
* @param array $config contains extra font settings.
* @param string $setting basis on this setting will return.
* @param mixed $unit Unit.
*
* @since 4.0.0
*/
function astra_addon_get_font_extras( $config, $setting, $unit = false ) {
$css = isset( $config[ $setting ] ) ? $config[ $setting ] : '';
if ( $unit && $css ) {
$unit_val = isset( $config[ $unit ] ) ? $config[ $unit ] : '';
$unit_val = 'line-height-unit' === $unit ? apply_filters( 'astra_font_line_height_unit', $unit_val ) : $unit_val; // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedHooknameFound
$css .= $unit_val;
}
return $css;
}
/**
* Function which will return CSS array for font specific props for further parsing CSS.
* It includes - font-family, font-weight, font-size, line-height, text-transform, letter-spacing, text-decoration, color (optional).
*
* @param string $font_family Font family.
* @param string $font_weight Font weight.
* @param array $font_size Font size.
* @param string $font_extras contains all font controls.
* @param string $color In most of cases color is also added, so included optional param here.
*
* @return array
*
* @since 4.0.0
*/
function astra_addon_get_font_array_css( $font_family, $font_weight, $font_size, $font_extras, $color = '' ) {
$font_extras_ast_option = astra_get_option( $font_extras );
return array(
'color' => esc_attr( $color ),
'font-family' => astra_get_css_value( $font_family, 'font' ),
'font-weight' => astra_get_css_value( $font_weight, 'font' ),
'font-size' => ! empty( $font_size ) ? astra_responsive_font( $font_size, 'desktop' ) : '',
'line-height' => astra_addon_get_font_extras( $font_extras_ast_option, 'line-height', 'line-height-unit' ),
'text-transform' => astra_addon_get_font_extras( $font_extras_ast_option, 'text-transform' ),
'letter-spacing' => astra_addon_get_font_extras( $font_extras_ast_option, 'letter-spacing', 'letter-spacing-unit' ),
'text-decoration' => astra_addon_get_font_extras( $font_extras_ast_option, 'text-decoration' ),
);
}
/**
* Checks reveal effect option for blog , WooCommerce and for custom post type.
*
* @param string $type - Type of condition.
* @return bool
*
* @since 4.6.0
*/
function astra_addon_check_reveal_effect_condition( $type = '' ) {
$supported_post_types = class_exists( 'Astra_Posts_Structure_Loader' ) && is_callable( 'Astra_Posts_Structure_Loader::get_supported_post_types' ) ? Astra_Posts_Structure_Loader::get_supported_post_types() : array( 'post' );
$post_type = strval( get_post_type() );
$blog_layout = astra_addon_get_blog_layout();
$blog_list_layout = ( 'blog-layout-2' === $blog_layout || 'blog-layout-3' === $blog_layout || 'blog-layout-5' === $blog_layout );
$woo_reveal_condition = ( function_exists( 'is_woocommerce' ) && is_woocommerce() && ( is_shop() || is_product_taxonomy() ) && astra_get_option( 'shop-reveal-effect' ) );
$blog_reveal_condition = ( ( ( is_front_page() && 'posts' === get_option( 'show_on_front' ) ) || is_category() || is_tag() || is_home() ) && astra_get_option( 'blog-reveal-effect' ) && ( $blog_list_layout || ! astra_get_option( 'blog-masonry' ) ) );
$search_reveal_condition = ( is_search() && astra_get_option( 'blog-reveal-effect' ) );
$custom_post_reveal = in_array( $post_type, $supported_post_types ) && astra_get_option( 'archive-' . $post_type . '-ast-reveal-effect', false );
$condition = '';
if ( '' === $type || 'all' === $type ) {
$condition = $woo_reveal_condition || $blog_reveal_condition || $search_reveal_condition || $custom_post_reveal;
}
if ( 'blog' === $type ) {
$condition = $blog_reveal_condition || $search_reveal_condition;
}
if ( 'woocommerce' === $type ) {
$condition = $woo_reveal_condition;
}
if ( 'cpt' === $type ) {
$condition = $custom_post_reveal;
}
return $condition;
}
/**
* Check Astra with modern blog setup.
*
* @since 4.6.0
*/
function astra_addon_4_6_0_compatibility() {
return is_callable( 'Astra_Dynamic_CSS::astra_4_6_0_compatibility' ) ? Astra_Dynamic_CSS::astra_4_6_0_compatibility() : false;
}