, >=, ==, lt, le, gt, ge etc.
*
* @return bool|int
*/
function zakra_plugin_version_compare( $plugin_base_name, $version_to_compare, $operator ) {
if ( ! function_exists( 'get_plugins' ) ) {
require_once ABSPATH . 'wp-admin/includes/plugin.php';
}
$installed_plugins = get_plugins();
// Plugin not installed.
if ( ! isset( $installed_plugins[ $plugin_base_name ] ) ) {
return false;
}
$plugin_version = $installed_plugins[ $plugin_base_name ]['Version'];
return version_compare( $plugin_version, $version_to_compare, $operator );
}
}
if ( ! function_exists( 'zakra_is_header_transparent_enabled' ) ) {
/**
* Check if header transparent is enabled.
*
* @return mixed|void
*/
function zakra_is_header_transparent_enabled() {
// Zakra Pro Customizer.
$customizer_result = apply_filters( 'zakra_header_transparency_filter', false );
// Meta box.
$meta_result = get_post_meta( zakra_get_post_id(), 'zakra_transparent_header', true );
$transparency = false;
if ( zakra_is_zakra_pro_active() && ( is_404() || is_search() || is_archive() ) && get_theme_mod( 'zakra_transparent_header_custom_enable', false ) && $customizer_result ) {
$transparency = true;
} elseif ( zakra_is_zakra_pro_active() && ( is_front_page() && is_home() ) && get_theme_mod( 'zakra_transparent_header_latest_posts_enable', false ) && $customizer_result ) {
$transparency = true;
} elseif ( '1' === $meta_result || true === $meta_result ) { // Enabled in meta.
$transparency = true;
} elseif ( ( 'customizer' === $meta_result || '' === $meta_result ) && $customizer_result ) { // Enabled in Customizer
$transparency = true;
}
return apply_filters( 'zakra_header_transparency_enable', $transparency );
}
}
if ( ! function_exists( 'zakra_is_page_title_enabled' ) ) {
/**
* Return the page title position.
*/
function zakra_is_page_title_enabled() {
$result = get_theme_mod( 'zakra_page_title_enabled', 'page-header' );
// If invalid: return default.
if ( ! in_array( $result, array( 'page-header', 'content-area' ), true ) ) {
return 'page-header';
}
return apply_filters( 'zakra_page_title_enabled', $result );
}
}
if ( ! function_exists( 'zakra_is_breadcrumbs_enabled' ) ) {
/**
* Check if breadcrumbs is enabled.
*/
function zakra_is_breadcrumbs_enabled() {
// Return false if disabled via Customizer.
$result = get_theme_mod( 'zakra_breadcrumbs_enabled', true );
// If invalid: return default.
if ( ! in_array( $result, array( 1, '', true ), true ) ) {
return false;
}
return apply_filters( 'zakra_breadcrumbs_enabled', $result );
}
}
if ( ! function_exists( 'zakra_is_header_top_enabled' ) ) {
/**
* Check if header top is enabled.
*/
function zakra_is_header_top_enabled() {
$result = get_theme_mod( 'zakra_header_top_enabled', false );
// If invalid: return default.
if ( ! in_array( $result, array( 1, '' ) ) ) { // phpcs:ignore WordPress.PHP.StrictInArray.MissingTrueStrict
return false;
}
// Return false if disabled via Customizer.
return apply_filters( 'zakra_header_top_enabled', $result );
}
}
if ( ! function_exists( 'zakra_is_footer_widgets_enabled' ) ) {
/**
* Check if header top is enabled.
*/
function zakra_is_footer_widgets_enabled() {
$result = get_theme_mod( 'zakra_footer_widgets_enabled', true );
// If invalid: return default.
if ( ! in_array( $result, array( 1, '', true ), true ) ) {
return false;
}
// Return false if disabled via Customizer.
return apply_filters( 'zakra_footer_widgets_enabled', $result );
}
}
if ( ! function_exists( 'zakra_is_footer_bar_enabled' ) ) {
/**
* Check if footer bar is enabled.
*/
function zakra_is_footer_bar_enabled() {
return apply_filters( 'zakra_footer_bar_enabled', '__return_true' );
}
}
if ( ! function_exists( 'zakra_footer_copyright' ) ) {
/**
* Get Copyright text.
*
* @param string $section 'one' or 'two' only should be passed as param.
*
* @return array|string|string[]|null
*/
function zakra_footer_copyright( $section ) {
if ( 'one' === $section ) {
$default = sprintf(
/* translators: 1: Current Year, 2: Site Name, 3: Theme Link, 4: WordPress Link. */
esc_html__( 'Copyright © %1$s %2$s. Powered by %3$s and %4$s.', 'zakra' ),
'{the-year}',
'{site-link}',
'{theme-link}',
'{wp-link}'
);
} else {
$default = '';
}
$content = get_theme_mod( "zakra_footer_bar_section_{$section}_html", $default );
$theme_author = apply_filters(
'zakra_theme_author',
array(
'theme_name' => __( 'Zakra', 'zakra' ),
'theme_author_url' => 'https://zakratheme.com/',
)
);
$site_link = '' . get_bloginfo( 'name', 'display' ) . '';
$theme_link = '' . $theme_author['theme_name'] . '';
$wp_link = '' . __( 'WordPress', 'zakra' ) . '';
if ( $content || is_customize_preview() ) {
$content = str_replace( '{the-year}', date_i18n( 'Y' ), $content );
$content = str_replace( '{site-link}', $site_link, $content );
$content = str_replace( '{theme-link}', $theme_link, $content );
$content = str_replace( '{wp-link}', $wp_link, $content );
}
return $content;
}
}
if ( ! function_exists( 'zakra_search_icon_menu_item' ) ) {
/**
* Renders search icon menu item.
*/
function zakra_search_icon_menu_item() {
$output = '';
$data_attrs = apply_filters( 'zakra_header_search_icon_data_attrs', '' );
if ( get_theme_mod( 'tg_header_menu_search_enabled', true ) ) {
$output = '
';
$output .= '';
}
return $output;
}
}
if ( ! function_exists( 'zakra_get_layout_type' ) ) {
/**
* Get layout type.
*
* @return string A layout type.
*/
function zakra_get_layout_type() {
global $post;
$layout = 'tg-site-layout--right'; // Set default.
if ( $post ) {
// Meta value.
$layout_meta_arr = get_post_meta( zakra_get_post_id(), 'zakra_layout' );
$layout_meta = isset( $layout_meta_arr[0] ) ? $layout_meta_arr[0] : 'tg-site-layout--customizer';
// Get layout from Customizer.
if ( 'tg-site-layout--customizer' === $layout_meta ) {
if ( is_single() ) {
$layout = get_theme_mod( 'zakra_structure_post', 'tg-site-layout--right' );
} elseif ( is_page() ) {
$layout = get_theme_mod( 'zakra_structure_page', 'tg-site-layout--right' );
} elseif ( is_archive() ) {
$layout = get_theme_mod( 'zakra_structure_archive', 'tg-site-layout--right' );
} else {
$layout = get_theme_mod( 'zakra_structure_default', 'tg-site-layout--right' );
}
} else { // Get layout from Meta box.
$layout = $layout_meta;
}
}
return $layout;
}
}
if ( ! function_exists( 'zakra_strpos' ) ) :
/**
* Find the position of the first occurrence of a substring in an array.
*
* @param $haystack
* @param array $needles
* @param int $offset
*
* @return bool
*/
function zakra_strpos( $haystack, $needles = array(), $offset = 0 ) {
if ( ! is_array( $needles ) ) {
$needles = array( $needles );
}
foreach ( $needles as $needle ) {
if ( strpos( $haystack, $needle, $offset ) !== false ) {
return true;
}
}
return false;
}
endif;
if ( ! function_exists( 'zakra_get_menu_options' ) ) :
/**
* Provides an array of Menu slug => name for dropdown.
*
*
* @param string $key Type of key in the menu item associative array.
* @return array
*/
function zakra_get_menu_options( $key = 'slug' ) {
$all_menus = get_terms(
array(
'taxonomy' => 'nav_menu',
'hide_empty' => true,
)
);
$menu_options = array();
$menu_options['none'] = esc_html__( 'None', 'zakra' );
foreach ( $all_menus as $menu_item ) {
if ( 'term_id' === $key ) {
$menu_options[ $menu_item->term_id ] = esc_html( $menu_item->name );
} else {
$menu_options[ $menu_item->slug ] = esc_html( $menu_item->name );
}
}
return $menu_options;
}
endif;
if ( ! function_exists( 'zakra_parse_css' ) ) :
/**
* Parses CSS.
*
* @param string|array $default_value Default value.
* @param string|array $output_value Updated value.
* @param array $css_output Array of CSS.
* @param string $min_media Min Media breakpoint.
* @param string $max_media Max Media breakpoint.
*
* @return string Generated CSS.
*/
function zakra_parse_css( $default_value, $output_value, $css_output = array(), $min_media = '', $max_media = '' ) {
// Return if default value matches.
if ( $default_value === $output_value ) {
return;
}
$parse_css = '';
if ( is_array( $css_output ) && count( $css_output ) > 0 ) {
foreach ( $css_output as $selector => $properties ) {
if ( null === $properties ) {
break;
}
if ( ! count( $properties ) ) {
continue;
}
$temp_parse_css = $selector . '{';
$properties_added = 0;
foreach ( $properties as $property => $value ) {
if ( '' === $value ) {
continue;
}
$properties_added ++;
$temp_parse_css .= $property . ':' . $value . ';';
}
$temp_parse_css .= '}';
if ( $properties_added > 0 ) {
$parse_css .= $temp_parse_css;
}
}
if ( '' !== $parse_css && ( '' !== $min_media || '' !== $max_media ) ) {
$media_css = '@media ';
$min_media_css = '';
$max_media_css = '';
$media_separator = '';
if ( '' !== $min_media ) {
$min_media_css = 'screen and (min-width:' . $min_media . 'px)';
}
if ( '' !== $max_media ) {
$max_media_css = 'screen and (max-width:' . $max_media . 'px)';
}
if ( '' !== $min_media && '' !== $max_media ) {
$media_separator = ' and ';
}
$media_css .= $min_media_css . $media_separator . $max_media_css . '{' . $parse_css . '}';
return $media_css;
}
}
return $parse_css;
}
endif;
if ( ! function_exists( 'zakra_parse_background_css' ) ) :
/**
* Returns the background CSS property for dynamic CSS generation.
*
* @param string|array $default_value Default value.
* @param string|array $output_value Updated value.
* @param string $selector CSS selector.
*
* @return string|void Generated CSS for background CSS property.
*/
function zakra_parse_background_css( $default_value, $output_value, $selector ) {
if ( $default_value === $output_value ) {
return;
}
$parse_css = $selector . '{';
// For background color.
if ( isset( $output_value['background-color'] ) && ! empty( $output_value['background-color'] ) && ( $output_value['background-color'] !== $default_value['background-color'] ) ) {
$parse_css .= 'background-color:' . $output_value['background-color'] . ';';
}
// For background image.
if ( isset( $output_value['background-image'] ) && ! empty( $output_value['background-image'] ) && ( $output_value['background-image'] !== $default_value['background-image'] ) ) {
$parse_css .= 'background-image:url(' . $output_value['background-image'] . ');';
}
// For background position.
if ( isset( $output_value['background-position'] ) && ! empty( $output_value['background-position'] ) && ( $output_value['background-position'] !== $default_value['background-position'] ) ) {
$parse_css .= 'background-position:' . $output_value['background-position'] . ';';
}
// For background size.
if ( isset( $output_value['background-size'] ) && ! empty( $output_value['background-size'] ) && ( $output_value['background-size'] !== $default_value['background-size'] ) ) {
$parse_css .= 'background-size:' . $output_value['background-size'] . ';';
}
// For background attachment.
if ( isset( $output_value['background-attachment'] ) && ! empty( $output_value['background-attachment'] ) && ( $output_value['background-attachment'] !== $default_value['background-attachment'] ) ) {
$parse_css .= 'background-attachment:' . $output_value['background-attachment'] . ';';
}
// For background repeat.
if ( isset( $output_value['background-repeat'] ) && ! empty( $output_value['background-repeat'] ) && ( $output_value['background-repeat'] !== $default_value['background-repeat'] ) ) {
$parse_css .= 'background-repeat:' . $output_value['background-repeat'] . ';';
}
$parse_css .= '}';
return $parse_css;
}
endif;
if ( ! function_exists( 'zakra_parse_typography_css' ) ) :
/**
* Returns the typography CSS property for dynamic CSS generation.
*
* @param string|array $default_value Default value.
* @param string|array $output_value Updated value.
* @param string $selector CSS selector.
* @param array $devices Devices for breakpoints.
*
* @return string|void Generated CSS for typography CSS.
*/
function zakra_parse_typography_css( $default_value, $output_value, $selector, $devices = array() ) {
if ( $default_value === $output_value ) {
return;
}
$parse_css = $selector . '{';
// For font family.
if ( isset( $output_value['font-family'] ) && ! empty( $output_value['font-family'] ) && ( $output_value['font-family'] !== $default_value['font-family'] ) ) {
$parse_css .= 'font-family:' . $output_value['font-family'] . ';';
}
// For font style.
if ( isset( $output_value['font-style'] ) && ! empty( $output_value['font-style'] ) && ( $output_value['font-style'] !== $default_value['font-style'] ) ) {
$parse_css .= 'font-style:' . $output_value['font-style'] . ';';
}
// For text transform.
if ( isset( $output_value['text-transform'] ) && ! empty( $output_value['text-transform'] ) && ( $output_value['text-transform'] !== $default_value['text-transform'] ) ) {
$parse_css .= 'text-transform:' . $output_value['text-transform'] . ';';
}
// For text decoration.
if ( isset( $output_value['text-decoration'] ) && ! empty( $output_value['text-decoration'] ) && ( $output_value['text-decoration'] !== $default_value['text-decoration'] ) ) {
$parse_css .= 'text-decoration:' . $output_value['text-decoration'] . ';';
}
// For font weight.
if ( isset( $output_value['font-weight'] ) && ! empty( $output_value['font-weight'] ) && ( $output_value['font-weight'] !== $default_value['font-weight'] ) ) {
$font_weight_value = $output_value['font-weight'];
if ( 'italic' === $font_weight_value || 'regular' === $font_weight_value ) {
$parse_css .= 'font-weight:' . 400 . ';';
} else {
$parse_css .= 'font-weight:' . str_replace( 'italic', '', $font_weight_value ) . ';';
}
}
// For font size on desktop.
if ( isset( $output_value['font-size']['desktop'] ) && ! empty( $output_value['font-size']['desktop'] ) && ( $output_value['font-size']['desktop'] !== $default_value['font-size']['desktop'] ) ) {
$parse_css .= 'font-size:' . $output_value['font-size']['desktop'] . ';';
}
// For line height on desktop.
if ( isset( $output_value['line-height']['desktop'] ) && ! empty( $output_value['line-height']['desktop'] ) && ( $output_value['line-height']['desktop'] !== $default_value['line-height']['desktop'] ) ) {
$parse_css .= 'line-height:' . $output_value['line-height']['desktop'] . ';';
}
// For letter spacing on desktop.
if ( isset( $output_value['letter-spacing']['desktop'] ) && ! empty( $output_value['letter-spacing']['desktop'] ) && ( $output_value['letter-spacing']['desktop'] !== $default_value['letter-spacing']['desktop'] ) ) {
$parse_css .= 'letter-spacing:' . $output_value['letter-spacing']['desktop'] . ';';
}
$parse_css .= '}';
// For responsive devices.
if ( is_array( $devices ) ) {
foreach ( $devices as $device => $size ) {
// For tablet devices.
if ( 'tablet' === $device && $size ) {
if ( ( isset( $output_value['font-size']['tablet'] ) && ! isset( $output_value['font-size']['tablet'] ) && $output_value['font-size']['tablet'] ) || ( isset( $output_value['line-height']['tablet'] ) && ! empty( $output_value['line-height']['tablet'] ) && $output_value['line-height']['tablet'] ) || ( isset( $output_value['letter-spacing']['tablet'] ) && ! empty( $output_value['letter-spacing']['tablet'] ) && $output_value['letter-spacing']['tablet'] ) ) {
$parse_css .= '@media(max-width:' . $size . 'px){';
$parse_css .= $selector . '{';
// For font size on tablet.
if ( isset( $output_value['font-size']['tablet'] ) && ! isset( $output_value['font-size']['tablet'] ) && ( $output_value['font-size']['tablet'] !== $default_value['font-size']['tablet'] ) ) {
$parse_css .= 'font-size:' . $output_value['font-size']['tablet'] . ';';
}
// For line height on tablet.
if ( isset( $output_value['line-height']['tablet'] ) && ! isset( $output_value['line-height']['tablet'] ) && ( $output_value['line-height']['tablet'] !== $default_value['line-height']['tablet'] ) ) {
$parse_css .= 'line-height:' . $output_value['line-height']['tablet'] . ';';
}
// For letter spacing on tablet.
if ( isset( $output_value['letter-spacing']['tablet'] ) && ! isset( $output_value['letter-spacing']['tablet'] ) && ( $output_value['letter-spacing']['tablet'] !== $default_value['letter-spacing']['tablet'] ) ) {
$parse_css .= 'letter-spacing:' . $output_value['letter-spacing']['tablet'] . ';';
}
$parse_css .= '}';
$parse_css .= '}';
}
}
// For mobile devices.
if ( 'mobile' === $device && $size ) {
if ( ( isset( $output_value['font-size']['mobile'] ) && ! empty( $output_value['font-size']['mobile'] ) && $output_value['font-size']['mobile'] ) || ( isset( $output_value['line-height']['mobile'] ) && ! empty( $output_value['line-height']['mobile'] ) && $output_value['line-height']['mobile'] ) || ( isset( $output_value['letter-spacing']['mobile'] ) && ! empty( $output_value['letter-spacing']['mobile'] ) && $output_value['letter-spacing']['mobile'] ) ) {
$parse_css .= '@media(max-width:' . $size . 'px){';
$parse_css .= $selector . '{';
// For font size on mobile.
if ( isset( $output_value['font-size']['mobile'] ) && ! empty( $output_value['font-size']['mobile'] ) && ( $output_value['font-size']['mobile'] !== $default_value['font-size']['mobile'] ) ) {
$parse_css .= 'font-size:' . $output_value['font-size']['mobile'] . ';';
}
// For line height on mobile.
if ( isset( $output_value['line-height']['mobile'] ) && ! empty( $output_value['line-height']['mobile'] ) && ( $output_value['line-height']['mobile'] !== $default_value['line-height']['mobile'] ) ) {
$parse_css .= 'line-height:' . $output_value['line-height']['mobile'] . ';';
}
// For letter spacing on mobile.
if ( isset( $output_value['letter-spacing']['mobile'] ) && ! empty( $output_value['letter-spacing']['mobile'] ) && ( $output_value['letter-spacing']['mobile'] !== $default_value['letter-spacing']['mobile'] ) ) {
$parse_css .= 'letter-spacing:' . $output_value['letter-spacing']['mobile'] . ';';
}
$parse_css .= '}';
$parse_css .= '}';
}
}
}
}
return $parse_css;
}
endif;
if ( ! function_exists( 'zakra_parse_dimension_css' ) ) :
/**
* Returns the background CSS property for dynamic CSS generation.
*
* @param string|array $default_value Default value.
* @param string|array $output_value Updated value.
* @param string $selector CSS selector.
* @param string $property CSS property.
*
* @return string|void Generated CSS for dimension CSS.
*/
function zakra_parse_dimension_css( $default_value, $output_value, $selector, $property ) {
if ( $default_value === $output_value ) {
return;
}
$parse_css = $selector . '{';
if ( isset( $output_value['top'] ) && ! empty( $output_value['top'] ) && ( $output_value['top'] !== $default_value['top'] ) ) {
$parse_css .= $property . '-top:' . $output_value['top'] . ';';
}
if ( isset( $output_value['top'] ) && ! empty( $output_value['top'] ) && ( $output_value['right'] !== $default_value['right'] ) ) {
$parse_css .= $property . '-right:' . $output_value['right'] . ';';
}
if ( isset( $output_value['bottom'] ) && ! empty( $output_value['bottom'] ) && ( $output_value['bottom'] !== $default_value['bottom'] ) ) {
$parse_css .= $property . '-bottom:' . $output_value['bottom'] . ';';
}
if ( isset( $output_value['left'] ) && ! empty( $output_value['left'] ) && ( $output_value['left'] !== $default_value['left'] ) ) {
$parse_css .= $property . '-left:' . $output_value['left'] . ';';
}
$parse_css .= '}';
return $parse_css;
}
endif;
if ( ! function_exists( 'zakra_remove_filters_with_method_name' ) ) :
/**
* Remove action or filter which has method as callback.
*
* @since 2.0.0
*
* @param string $hook_name Hook handle name.
* @param string $method_name Callback method name.
* @param int $priority Priority of the hook to run.
*/
function zakra_remove_filters_with_method_name( $hook_name = '', $method_name = '', $priority = 0 ) {
global $wp_filter;
// Take only filters on right hook name and priority.
if ( ! isset( $wp_filter[ $hook_name ][ $priority ] ) || ! is_array( $wp_filter[ $hook_name ][ $priority ] ) ) {
return;
}
// Loop on filters registered.
foreach ( (array) $wp_filter[ $hook_name ][ $priority ] as $id => $filter_array ) {
// Check if filter is an array (always for class/method).
if ( isset( $filter_array['function'] ) && is_array( $filter_array['function'] ) ) {
// Check if object is a class and method is equal to param.
if ( is_object( $filter_array['function'][0] ) && get_class( $filter_array['function'][0] ) && $filter_array['function'][1] == $method_name ) { // phpcs:ignore WordPress.PHP.StrictComparisons.LooseComparison
unset( $wp_filter[ $hook_name ]->callbacks[ $priority ][ $id ] );
}
}
}
}
endif;
if ( ! function_exists( 'zakra_get_sidebar_name_by_id' ) ) :
/**
* Get sidebar name.
*
* @param string $sidebar_id
* @return mixed|string
*/
function zakra_get_sidebar_name_by_id( $sidebar_id = '' ) {
global $wp_registered_sidebars;
$sidebar_name = '';
if ( isset( $wp_registered_sidebars[ $sidebar_id ] ) ) {
$sidebar_name = $wp_registered_sidebars[ $sidebar_id ]['name'];
}
return $sidebar_name;
}
endif;