prepareAtts()
if ( is_array( $atts ) ) {
foreach ( $atts as $key => $val ) {
$atts[ $key ] = str_replace( array(
'`{`',
'`}`',
'``',
), array(
'[',
']',
'"',
), $val );
}
}
return vc_map_get_attributes( $shortcode, $atts );
}
/**
* Filters module grid to return active blocks
*
* @since 4.4
*/
function vcex_filter_grid_blocks_array( $blocks ) {
$new_blocks = array();
foreach ( $blocks as $key => $value ) {
if ( 'true' == $value ) {
$new_blocks[$key] = '';
}
}
return $new_blocks;
}
/**
* Check if VC theme mode is enabled
*
* @since 3.5.0
*/
function vcex_theme_mode_check() {
$theme_mode = wpex_get_mod( 'visual_composer_theme_mode', true );
if ( vc_license()->isActivated() ) {
$theme_mode = false; // disable if VC is active
}
return $theme_mode;
}
/**
* Displays notice when functions aren't found
*
* @since 3.5.0
*/
function vcex_function_needed_notice() {
echo '
This module can not work without the required functions. Please make sure all your plugins and WordPress is up to date. If you still have issues contact the developer for assistance.
';
}
/**
* Returns correct classes for grid modules
* Does NOT use post_class to prevent conflicts
*
* @since 3.5.0
*/
function vcex_grid_get_post_class( $classes = array(), $post_id ) {
// Get post
$post_id = $post_id ? $post_id : get_the_ID();
// Get post type
$type = get_post_type( $post_id );
// Add post ID class
$classes[] = 'post-'. $post_id;
// Add entry class
$classes[] = 'entry';
// Add type class
$classes[] = 'type-'. $type;
// Add has media class
if ( wpex_post_has_media( $post_id, true ) ) {
$classes[] = 'has-media';
} else {
$classes[] = 'no-media';
}
// Add terms
if ( $terms = vcex_get_post_term_classes( $post_id, $type ) ) {
$classes[] = $terms;
}
// Custom link class
if ( wpex_get_post_redirect_link() ) {
$classes[] = 'has-redirect';
}
// Apply filters
$classes = apply_filters( 'vcex_grid_get_post_class', $classes );
// Turn into string
$classes = implode( ' ', $classes );
// Sanitize and return
return 'class="'. esc_attr( $classes ) .'"';
}
/**
* Returns entry classes for vcex module entries
*
* @since 3.5.3
*/
function vcex_get_post_term_classes( $post_id, $post_type ) {
// Define vars
$classes = array();
// Loop through tax objects and save in taxonomies var
$taxonomies = get_object_taxonomies( $post_type, 'names' );
// Return of there is an error
if ( is_wp_error( $taxonomies ) || ! $taxonomies ) {
return;
}
// Loop through taxomies
foreach ( $taxonomies as $tax ) {
// Get terms
$terms = get_the_terms( $post_id, $tax );
// Make sure terms aren't empty before loop
if ( ! is_wp_error( $terms ) && $terms ) {
// Loop through terms
foreach ( $terms as $term ) {
// Set prefix as taxonomy name
$prefix = esc_html( $term->taxonomy );
// Add class if we have a prefix
if ( $prefix ) {
// Get total post types to parse
$parse_types = wpex_theme_post_types();
if ( in_array( $post_type, $parse_types ) ) {
$search = array( $post_type .'_category', $post_type .'_tag' );
$replace = array( 'cat', 'tag' );
$prefix = str_replace( $search, $replace, $prefix );
}
// Category prefix
if ( 'category' == $prefix ) {
$prefix = 'cat';
}
// Add term
$classes[] = $prefix .'-'. $term->term_id;
// Add term parent
if ( $term->parent ) {
$classes[] = $prefix .'-'. $term->parent;
}
}
}
}
}
// Return classes
return $classes ? implode( ' ', $classes ) : '';
}
/**
* Returns correct class for columns
*
* @since 4.0
*/
function vcex_get_grid_column_class( $atts ) {
$return_class = '';
if ( isset( $atts['columns'] ) ) {
$return_class .= 'span_1_of_' . $atts['columns'];
}
if ( isset( $atts['single_column_style'] ) && 'left_thumbs' == $atts['single_column_style'] ) {
return $return_class;
}
if ( ! empty( $atts['columns_responsive_settings'] ) ) {
$rs = vcex_parse_multi_attribute( $atts['columns_responsive_settings'], array() );
foreach ( $rs as $key => $val ) {
if ( $val ) {
$return_class .= ' span_1_of_' . $val . '_' . $key;
}
}
}
return $return_class;
}
/**
* Returns correct class for columns
*
* @version 4.4.1
*/
function vcex_parse_multi_attribute( $value = '', $default = array() ) {
$result = $default;
$params_pairs = explode( '|', $value );
if ( ! empty( $params_pairs ) ) {
foreach ( $params_pairs as $pair ) {
$param = preg_split( '/\:/', $pair );
if ( ! empty( $param[0] ) && isset( $param[1] ) ) {
if ( 'http' == $param[1] && isset( $param[2] ) ) {
$param[1] = rawurlencode( 'http:' . $param[2] ); // fix for incorrect urls that are not encoded
}
$result[ $param[0] ] = rawurldecode( $param[1] );
}
}
}
return $result;
}
/**
* Helper function enqueues icon fonts from Visual Composer
*
* @since 2.0.0
*/
function vcex_enqueue_icon_font( $family = '' ) {
// Return if there isn't an icon or it's set to fontawesome
if ( ! $family || 'fontawesome' == $family ) {
return;
}
// Return if VC function doesn't exist
if ( ! function_exists( 'vc_icon_element_fonts_enqueue' ) ) {
return;
}
// Check for custom enqueue
$fonts = vcex_get_icon_font_families();
// Custom stylesheet check
if ( ! empty( $fonts[$family]['style'] ) ) {
wp_enqueue_style( $fonts[$family]['style'] );
}
// Default core styles
else {
vc_icon_element_fonts_enqueue( $family );
}
}
/**
* Returns font icon options
*
* @since 4.0
*/
function vcex_get_icon_font_families( $module = '' ) {
return apply_filters( 'vcex_vc_map_icon_font_families', array(
'fontawesome' => array(
'label' => __( 'Font Awesome', 'total' ),
'source' => '',
'default' => 'fa fa-info-circle',
),
'openiconic' => array(
'label' => __( 'Open Iconic', 'total' ),
),
'typicons' => array(
'label' =>__( 'Typicons', 'total' ),
),
'entypo' => array(
'label' =>__( 'Entypo', 'total' ),
),
'linecons' => array(
'label' =>__( 'Linecons', 'total' ),
),
'pixelicons' => array(
'label' =>__( 'Pixel', 'total' ),
'source' => vcex_pixel_icons()
),
'monosocial' => array(
'label' =>__( 'Mono Social', 'total' ),
),
), $module );
}
/**
* Returns font icon options
*
* @since 4.0
*/
function vcex_vc_map_add_icon_font( $args = '', $module ) {
$settings = array();
$defaults = array(
'type_param_name' => 'icon_type',
'icon_param_name' => 'icon',
'group' => '',
'include' => 'all'
);
if ( is_array( $args ) ) {
$args = wp_parse_args( $args, $defaults );
} else {
$defaults['group'] = $args;
$args = $defaults;
}
$icon_families = vcex_get_icon_font_families( $module );
$settings[] = array(
'type' => 'dropdown',
'heading' => __( 'Icon library', 'total' ),
'param_name' => $args['type_param_name'],
'description' => __( 'Select icon library.', 'total' ),
'group' => $args['group'],
);
$settings_values = array();
foreach ( $icon_families as $key => $val ) {
if ( 'all' != $args['include'] && is_array( $args['include'] ) && ! in_array( $key, $args['include'] ) ) {
continue;
}
$settings_values[$val['label']] = $key;
$default = isset( $val['default'] ) ? $val['default'] : '';
if ( 'fontawesome' == $key ) {
$param_name = $args['icon_param_name'];
} else {
$param_name = $args['icon_param_name'] .'_'. $key;
}
$settings[$key] = array(
'type' => 'iconpicker',
'heading' => __( 'Icon', 'total' ),
'param_name' => $param_name,
'value' => $default,
'settings' => array(
'type' => $key,
'emptyIcon' => true,
'iconsPerPage' => 200,
),
'dependency' => array(
'element' => $args['type_param_name'],
'value' => $key,
),
'group' => $args['group'],
);
if ( ! empty( $val['source'] ) ) {
$settings[$key]['settings']['source'] = $val['source'];
}
}
$settings[0]['value'] = $settings_values;
return $settings;
}
/**
* Returns array for adding CSS Animation to VC modules
*
* @since 4.0
*/
function vcex_vc_map_add_css_animation( $args = array() ) {
// Fallback pre VC 5.0
if ( ! function_exists( 'vcex_vc_map_add_css_animation' ) ) {
return array(
'type' => 'dropdown',
'heading' => __( 'Appear Animation', 'total' ),
'param_name' => 'css_animation',
'value' => array_flip( wpex_css_animations() ),
'dependency' => array( 'element' => 'filter', 'value' => 'false' ),
);
}
// New since VC 5.0
$defaults = array(
'type' => 'animation_style',
'heading' => __( 'CSS Animation', 'total' ),
'param_name' => 'css_animation',
'value' => 'none',
'std' => 'none',
'settings' => array(
'type' => 'in',
'custom' => array(
array(
'label' => __( 'Default', 'total' ),
'values' => array(
__( 'Top to bottom', 'total' ) => 'top-to-bottom',
__( 'Bottom to top', 'total' ) => 'bottom-to-top',
__( 'Left to right', 'total' ) => 'left-to-right',
__( 'Right to left', 'total' ) => 'right-to-left',
__( 'Appear from center', 'total' ) => 'appear',
),
),
),
),
'description' => __( 'Select type of animation for element to be animated when it "enters" the browsers viewport (Note: works only in modern browsers).', 'total' ),
);
$args = wp_parse_args( $args, $defaults );
return apply_filters( 'vc_map_add_css_animation', $args );
}
/**
* Returns animation class and loads animation js
*
* @since 3.5.0
*/
function vcex_get_css_animation( $css_animation = '' ) {
if ( $css_animation && 'none' != $css_animation ) {
wp_enqueue_script( 'waypoints' );
wp_enqueue_style( 'animate-css' );
return' wpb_animate_when_almost_visible wpb_' . $css_animation . ' ' . $css_animation;
}
}
/**
* Return unique ID for responsive class
*
* @since 4.3
*/
function vcex_get_reponsive_unique_id( $unique_id = '' ) {
return $unique_id ? '.wpex-'. $unique_id : uniqid( 'wpex-' );
}
/**
* Return responsive font-size data
*
* @since 4.3
*/
function vcex_get_responsive_font_size_data( $value ) {
// Font size is needed
if ( ! $value ) {
return;
}
// Not needed for simple font_sizes
if ( strpos( $value, '|' ) === false ) {
return;
}
// Parse data to return array
$data = vcex_parse_multi_attribute( $value );
if ( ! $data && ! is_array( $data ) ) {
return;
}
$sanitized_data = array();
// Sanitize
foreach ( $data as $key => $val ) {
$sanitized_data[$key] = wpex_sanitize_data( $val, 'font_size' );
}
return $sanitized_data;
}
/**
* Return responsive font-size data
*
* @since 4.0
*/
function vcex_get_module_responsive_data( $atts, $type = '' ) {
if ( ! $atts ) {
return; // No need to do anything if atts is empty
}
$return = array();
$parsed_data = array();
$settings = array( 'font_size' );
if ( $type && ! is_array( $atts ) ) {
$settings = array( $type );
$atts = array( $type => $atts );
}
foreach ( $settings as $setting ) {
if ( 'font_size' == $setting ) {
// Get value from params
$value = isset( $atts['font_size'] ) ? $atts['font_size'] : '';
// Value needed
if ( ! $value ) {
break;
}
// Get font size data
$value = vcex_get_responsive_font_size_data( $value );
// Add to new array
if ( $value ) {
$parsed_data['font-size'] = $value;
}
} // End font_size
} // End foreach
// Return
if ( $parsed_data ) {
return "data-wpex-rcss='" . json_encode( $parsed_data ) . "'";
}
}
/**
* Get Extra class
*
* @since 2.0.0
*/
function vcex_get_extra_class( $classes = '' ) {
if ( ! $classes ) {
return;
}
return esc_attr( str_replace( '.', '', $classes ) );
}
/**
* Returns list of post types
*
* @since 2.1.0
*/
function vcex_get_post_types() {
$post_types_list = array();
$post_types = get_post_types( array(
'public' => true
) );
if ( $post_types ) {
foreach ( $post_types as $post_type ) {
if ( 'revision' != $post_type && 'nav_menu_item' != $post_type && 'attachment' != $post_type ) {
$post_types_list[$post_type] = $post_type;
}
}
}
return $post_types_list;
}
/**
* Array of Google Font options
*
* @since 2.1.0
*/
function vcex_fonts_array() {
// Default array
$array = array(
__( 'Default', 'total' ) => '',
);
// Add custom fonts
if ( $custom_fonts = wpex_add_custom_fonts() ) {
$array = array_merge( $array, wpex_add_custom_fonts() );
}
// Add standard fonts
$std_fonts = wpex_standard_fonts();
$array = array_merge( $array, $std_fonts );
// Add Google Fonts
if ( $google_fonts = wpex_google_fonts_array() ) {
$array = array_merge( $array, $google_fonts );
}
// Return fonts
return apply_filters( 'vcex_google_fonts_array', $array );
}
/**
* Parses lightbox dimensions
*
* @since 2.1.2
*/
function vcex_parse_lightbox_dims( $dims = '' ) {
// Return if no dims
if ( ! $dims ) {
return;
}
// Parse data
$dims = explode( 'x', $dims );
$w = isset( $dims[0] ) ? $dims[0] : '1920';
$h = isset( $dims[1] ) ? $dims[1] : '1080';
// Return dimensions
return 'width:'. $w .',height:'. $h .'';
}
/**
* Parses textarea HTML
*
* @since 2.1.2
*/
function vcex_parse_textarea_html( $html = '' ) {
if ( $html && base64_decode( $html, true ) ) {
return rawurldecode( base64_decode( strip_tags( $html ) ) );
}
return $html;
}
/**
* Parses the font_control / typography param
*
* @since 2.0.0
*/
function vcex_parse_typography_param( $value ) {
// Conter value to array
$value = vc_parse_multi_attribute( $value );
// Define defaults
$defaults = array(
'tag' => '',
'text_align' => '',
'font_size' => '',
'line_height' => '',
'color' => '',
'font_style_italic' => '',
'font_style_bold' => '',
'font_family' => '',
'letter_spacing' => '',
'font_family' => '',
);
// Parse values so keys exist
$values = wp_parse_args( $value, $defaults );
// Return values
return $values;
}
/**
* Url param to check for for filters
*
* @since 3.2.0
*/
function vcex_grid_filter_url_param() {
return apply_filters( 'vcex_grid_filter_url_param', 'filter' );
}
/**
* Get vcex grid filter active item
*
* @since 4.5.5
*/
function vcex_grid_filter_get_active_item( $tax = '' ) {
$param = vcex_grid_filter_url_param();
if ( empty( $_GET[$param] ) ) {
return;
}
$paramv = esc_html( $_GET[$param] );
if ( $tax && ! is_numeric( $paramv ) ) {
$get_term = get_term_by( 'slug', $paramv, $tax );
if ( $get_term ) {
return $get_term->term_id;
} else {
$get_term = get_term_by( 'name', $paramv, $tax );
if ( $get_term ) {
return $get_term->term_id;
}
}
}
return $paramv;
}
/**
* Return grid filter arguments
*
* @since 2.0.0
*/
function vcex_grid_filter_args( $atts = '', $query = '' ) {
// Return if no attributes found
if ( ! $atts ) {
return;
}
// Define args
$args = $include = array();
// Don't get empty
$args['hide_empty'] = true;
// Taxonomy
if ( ! empty( $atts['filter_taxonomy'] ) ) {
$taxonomy = $atts['filter_taxonomy'];
} elseif ( isset( $atts['taxonomy'] ) ) {
$taxonomy = $atts['taxonomy']; // Fallback
} else {
$taxonomy = null;
}
// Define post type and taxonomy
$post_type = ! empty( $atts['post_type'] ) ? $atts['post_type'] : '';
// Define include/exclude category vars
$include_cats = ! empty( $atts['include_categories'] ) ? vcex_string_to_array( $atts['include_categories'] ) : '';
// Check if only 1 category is included
// If so check if it's a parent item so we can display children as the filter links
if ( $include_cats && '1' == count( $include_cats )
&& $children = get_term_children( $include_cats[0], $taxonomy )
) {
$include = $children;
}
// Include only terms from current query
if ( empty( $include ) && $query ) {
// Pluck ids from query
$post_ids = wp_list_pluck( $query->posts, 'ID' );
// Loop through post ids
foreach ( $post_ids as $post_id ) {
// Get post terms
$terms = wp_get_post_terms( $post_id, $taxonomy );
// Make sure there is no errors with terms and post has terms
if ( ! is_wp_error( $terms ) && $terms ) {
// Loop through terms
foreach( $terms as $term ) {
// Store term id
$term_id = $term->term_id;
// Include terms if include_cats variable is empty
if ( ! $include_cats ) {
// Include term
$include[$term_id] = $term_id;
/* Include parent
if ( $term->parent ) {
$include[$term->parent] = $term->parent;
}*/
}
// Include terms if include_cats is enabled and term is in var
elseif ( $include_cats && in_array( $term_id, $include_cats ) ) {
$include[$term_id] = $term_id;
}
}
}
}
// Add included terms to include param
$args['include'] = $include;
}
// Add to args
if ( ! empty( $include ) ) {
$args['include'] = $include;
}
if ( ! empty( $exclude ) ) {
$args['exclude'] = $exclude;
}
// Apply filters @todo deprecate?
if ( $post_type ) {
$args = apply_filters( 'vcex_'. $post_type .'_grid_filter_args', $args );
}
// Return args
return apply_filters( 'vcex_grid_filter_args', $args, $post_type );
}
/**
* Convert to array
*
* @since 2.0.0
*/
function vcex_string_to_array( $value = array() ) {
// Return wpex function if it exists
if ( function_exists( 'wpex_string_to_array' ) ) {
return wpex_string_to_array( $value );
}
// Create our own return
else {
// Return null for empty array
if ( empty( $value ) && is_array( $value ) ) {
return null;
}
// Return if already array
if ( ! empty( $value ) && is_array( $value ) ) {
return $value;
}
// Clean up value
$items = preg_split( '/\,[\s]*/', $value );
// Create array
foreach ( $items as $item ) {
if ( strlen( $item ) > 0 ) {
$array[] = $item;
}
}
// Return array
return $array;
}
}
/**
* Generates various types of HTML based on a value
*
* @since 2.0.0
*/
function vcex_parse_old_design_js() {
return WPEX_VCEX_DIR_URI . 'assets/parse-old-design.js';
}
/**
* Generates various types of HTML based on a value
*
* @since 2.0.0
*/
function vcex_html( $type, $value, $trim = false ) {
// Return nothing by default
$return = '';
// Return if value is empty
if ( ! $value ) {
return;
}
// Title attribute
if ( 'id_attr' == $type ) {
$value = trim ( str_replace( '#', '', $value ) );
$value = str_replace( ' ', '', $value );
if ( $value ) {
$return = ' id="'. esc_attr( $value ) .'"';
}
}
// Title attribute
if ( 'title_attr' == $type ) {
$return = ' title="'. esc_attr( $value ) .'"';
}
// Link Target
elseif ( 'target_attr' == $type ) {
if ( 'blank' == $value
|| '_blank' == $value
|| strpos( $value, 'blank' ) ) {
$return = ' target="_blank"';
}
}
// Link rel
elseif ( 'rel_attr' == $type ) {
if ( 'nofollow' == $value ) {
$return = ' rel="nofollow"';
}
}
// Return HTMl
if ( $trim ) {
return trim( $return );
} else {
return $return;
}
}
/**
* Returns array of image sizes for use in the Customizer
*
* @since 2.0.0
*/
function vcex_image_sizes() {
$sizes = array(
__( 'Custom Size', 'total' ) => 'wpex_custom',
);
$get_sizes = get_intermediate_image_sizes();
array_unshift( $get_sizes, 'full' );
$get_sizes = array_combine( $get_sizes, $get_sizes );
$sizes = array_merge( $sizes, $get_sizes );
return $sizes;
}
/**
* Notice when no posts are found
*
* @since 2.0.0
*/
function vcex_no_posts_found_message( $atts ) {
$message = null;
if ( wpex_vc_is_inline() ) {
$message = '
' . esc_html__( 'No posts found for your query.', 'total' ) . '
';
}
return apply_filters( 'vcex_no_posts_found_message', $message, $atts );
}
/**
* Echos unique ID html for VC modules
*
* @since 2.0.0
*/
function vcex_unique_id( $id = '' ) {
echo vcex_get_unique_id( $id );
}
/**
* Returns unique ID html for VC modules
*
* @since 2.0.0
*/
function vcex_get_unique_id( $id = '' ) {
if ( $id ) {
return vcex_html( 'id_attr', $id );
}
}
/**
* Returns dummy image
*
* @since 2.0.0
*/
function vcex_dummy_image_url() {
return WPEX_THEME_URI .'/images/dummy-image.jpg';
}
/**
* Outputs dummy image
*
* @since 2.0.0
*/
function vcex_dummy_image() {
echo '';
}
/**
* Used to enqueue styles for Visual Composer modules
*
* @since 2.0.0
*/
function vcex_enque_style( $type, $value = '' ) {
// iLightbox
if ( 'ilightbox' == $type ) {
wpex_enqueue_ilightbox_skin( $value );
}
// Hover animation
elseif ( 'hover-animations' == $type ) {
wp_enqueue_style( 'wpex-hover-animations' );
}
}
/**
* Array of Icon box styles
*
* @since 2.0.0
*/
function vcex_icon_box_styles() {
// Define array
$array = array(
'one' => __( 'Left Icon', 'total' ),
'seven' => __( 'Right Icon', 'total' ),
'two' => __( 'Top Icon', 'total' ),
'three' => __( 'Top Icon Style 2 - legacy', 'total' ),
'four' => __( 'Outlined and Top Icon - legacy', 'total' ),
'five' => __( 'Boxed and Top Icon - legacy', 'total' ),
'six' => __( 'Boxed and Top Icon Style 2 - legacy', 'total' ),
);
// Apply filters
$array = apply_filters( 'vcex_icon_box_styles', $array );
// Flip array around for use with VC
$array = array_flip( $array );
// Return array
return $array;
}
/**
* Array of orderby options
*
* @since 2.0.0
*/
function vcex_orderby_array( $type = 'post' ) {
$array = array(
__( 'Default', 'total' ) => '',
__( 'Date', 'total' ) => 'date',
__( 'Title', 'total' ) => 'title',
__( 'Name', 'total' ) => 'name',
__( 'Modified', 'total' ) => 'modified',
__( 'Author', 'total' ) => 'author',
__( 'Random', 'total' ) => 'rand',
__( 'Parent', 'total' ) => 'parent',
__( 'Type', 'total' ) => 'type',
__( 'ID', 'total' ) => 'ID',
__( 'Comment Count', 'total' ) => 'comment_count',
__( 'Menu Order', 'total' ) => 'menu_order',
__( 'Meta Key Value', 'total' ) => 'meta_value',
__( 'Meta Key Value Num', 'total' ) => 'meta_value_num',
);
if ( 'woo_product' == $type ) {
$array[ __( 'Best Selling', 'total' ) ] = 'woo_best_selling';
$array[ __( 'Top Rated', 'total' ) ] = 'woo_top_rated';
}
return apply_filters( 'vcex_orderby', $array );
}
/**
* Array of ilightbox skins
*
* @since 2.0.0
* @todo deprecate this function and remove extra vcex_lightbox_skins settings from modules force people to use global setting
*/
function vcex_ilightbox_skins() {
$skins = array(
'' => __( 'Default', 'total' ),
);
$skins = array_merge( $skins, wpex_ilightbox_skins() );
$skins = array_flip( $skins );
return $skins;
}
/**
* Border Radius Classname
*
* @since 1.4.0
*/
function vcex_get_border_radius_class( $val ) {
if ( 'none' == $val || '' == $val ) {
return;
}
return 'wpex-'. $val;
}
/**
* Helper function for building links using link param
*
* @since 2.0.0
*/
function vcex_build_link( $link, $fallback = '' ) {
// If empty return fallback
if ( empty( $link ) ) {
return $fallback;
}
// Return if there isn't any link
if ( '||' == $link || '|||' == $link || '||||' == $link ) {
return;
}
// Return simple link escaped (fallback for old textfield input)
if ( false === strpos( $link, 'url:' ) ) {
return esc_url( $link );
}
// Build link
// Needs to use total function to fix issue with fallbacks
$link = vcex_parse_multi_attribute( $link, array( 'url' => '', 'title' => '', 'target' => '', 'rel' => '' ) );
// Sanitize
$link = is_array( $link ) ? $link : '';
// Return link
return $link;
}
/**
* Returns link data (used for fallback link settings)
*
* @since 2.0.0
*/
function vcex_get_link_data( $return, $link, $fallback = '' ) {
$link = vcex_build_link( $link, $fallback );
if ( 'url' == $return ) {
if ( is_array( $link ) && ! empty( $link['url'] ) ) {
return $link['url'];
} else {
return is_array( $link ) ? $fallback : $link;
}
}
if ( 'title' == $return ) {
if ( is_array( $link ) && ! empty( $link['title'] ) ) {
return $link['title'];
} else {
return $fallback;
}
}
if ( 'target' == $return ) {
if ( is_array( $link ) && ! empty( $link['target'] ) ) {
return $link['target'];
} else {
return $fallback;
}
}
if ( 'rel' == $return ) {
if ( is_array( $link ) && ! empty( $link['rel'] ) ) {
return $link['rel'];
} else {
return $fallback;
}
}
}
/**
* Returns correct icon class based on icon type
*
* @since 2.0.0
*/
function vcex_get_icon_class( $atts, $icon_location ) {
// Define vars
$icon = '';
$icon_type = ! empty( $atts['icon_type'] ) ? $atts['icon_type'] : 'fontawesome';
// Generate fontawesome icon class
if ( 'fontawesome' == $icon_type && ! empty( $atts[$icon_location] ) ) {
$icon = $atts[$icon_location];
$icon = str_replace( 'fa-', '', $icon );
$icon = str_replace( 'fa ', '', $icon );
$icon = 'fa fa-' . $icon;
} elseif ( ! empty( $atts[ $icon_location .'_'. $icon_type ] ) ) {
$icon = $atts[ $icon_location .'_'. $icon_type ];
}
// Sanitize
$icon = in_array( $icon, array( 'icon', 'none' ) ) ? '' : $icon;
// Return icon class
return $icon;
}
/**
* Adds inner row margin to compensate for the VC negative margins
*
*
* @since 2.0.0
*/
function vcex_offset_vc( $atts ) {
// No offset added here
if ( ! empty( $atts['full_width'] ) || ! empty( $atts['max_width'] ) ) {
return;
}
// Get column spacing
$spacing = ! empty( $atts['column_spacing'] ) ? $atts['column_spacing'] : '30';
// Return if spacing set to 0px
if ( '0px' == $spacing ) {
return;
}
// Define offset class
$classes = 'wpex-offset-vc-'. $spacing/2;
// Parallax check
if ( vcex_supports_advanced_parallax() ) {
if ( ! empty( $atts['vcex_parallax'] ) && ! empty( $atts['parallax_image'] ) ) {
return $classes;
}
}
// Self hosted video
if ( 'self_hosted' == $atts['video_bg'] && ! empty( $atts['video_bg_mp4'] ) ) {
return $classes;
}
// Youtube videos
if ( 'youtube' == $atts['video_bg'] && ! empty( $atts['video_bg_url'] ) ) {
return $classes;
}
// Overlays
$overlay = isset( $atts['wpex_bg_overlay'] ) ? $atts['wpex_bg_overlay'] : '';
if ( $overlay ) {
return $classes;
}
// Check for custom CSS
if ( ! empty( $atts['css'] ) ) {
if ( strpos( $atts['css'], 'background' )
|| strpos( $atts['css'], 'border' )
) {
return $classes;
}
} elseif ( ! empty( $atts['center_row'] )
|| ! empty( $atts['bg_image'] )
|| ! empty( $atts['bg_color'] )
|| ! empty( $atts['border_width'] )
) {
return $classes;
}
}
/**
* Returns video row background
*
* @since 2.0.0
*/
if ( ! function_exists( 'vcex_row_video' ) ) {
function vcex_row_video( $atts ) {
// Define output
$output = '';
// Return if disabled
if ( empty( $atts['wpex_self_hosted_video_bg'] ) ) {
return;
}
// Make sure at least one video is defined
if ( empty( $atts['video_bg_webm'] ) && empty( $atts['video_bg_ogv'] ) && empty( $atts['video_bg_mp4'] ) ) {
return;
}
// Check sound
$sound = apply_filters( 'vcex_self_hosted_row_video_sound', false );
$sound = $sound ? '' : 'muted volume="0"';
$output .= '
';
}
/**
* Used to enqueue styles for Visual Composer modules
*
* @since 2.0.0
*/
function vcex_enque_style( $type, $value = '' ) {
// iLightbox
if ( 'ilightbox' == $type ) {
wpex_enqueue_ilightbox_skin( $value );
}
// Hover animation
elseif ( 'hover-animations' == $type ) {
wp_enqueue_style( 'wpex-hover-animations' );
}
}
/**
* Array of Icon box styles
*
* @since 2.0.0
*/
function vcex_icon_box_styles() {
// Define array
$array = array(
'one' => __( 'Left Icon', 'total' ),
'seven' => __( 'Right Icon', 'total' ),
'two' => __( 'Top Icon', 'total' ),
'three' => __( 'Top Icon Style 2 - legacy', 'total' ),
'four' => __( 'Outlined and Top Icon - legacy', 'total' ),
'five' => __( 'Boxed and Top Icon - legacy', 'total' ),
'six' => __( 'Boxed and Top Icon Style 2 - legacy', 'total' ),
);
// Apply filters
$array = apply_filters( 'vcex_icon_box_styles', $array );
// Flip array around for use with VC
$array = array_flip( $array );
// Return array
return $array;
}
/**
* Array of orderby options
*
* @since 2.0.0
*/
function vcex_orderby_array( $type = 'post' ) {
$array = array(
__( 'Default', 'total' ) => '',
__( 'Date', 'total' ) => 'date',
__( 'Title', 'total' ) => 'title',
__( 'Name', 'total' ) => 'name',
__( 'Modified', 'total' ) => 'modified',
__( 'Author', 'total' ) => 'author',
__( 'Random', 'total' ) => 'rand',
__( 'Parent', 'total' ) => 'parent',
__( 'Type', 'total' ) => 'type',
__( 'ID', 'total' ) => 'ID',
__( 'Comment Count', 'total' ) => 'comment_count',
__( 'Menu Order', 'total' ) => 'menu_order',
__( 'Meta Key Value', 'total' ) => 'meta_value',
__( 'Meta Key Value Num', 'total' ) => 'meta_value_num',
);
if ( 'woo_product' == $type ) {
$array[ __( 'Best Selling', 'total' ) ] = 'woo_best_selling';
$array[ __( 'Top Rated', 'total' ) ] = 'woo_top_rated';
}
return apply_filters( 'vcex_orderby', $array );
}
/**
* Array of ilightbox skins
*
* @since 2.0.0
* @todo deprecate this function and remove extra vcex_lightbox_skins settings from modules force people to use global setting
*/
function vcex_ilightbox_skins() {
$skins = array(
'' => __( 'Default', 'total' ),
);
$skins = array_merge( $skins, wpex_ilightbox_skins() );
$skins = array_flip( $skins );
return $skins;
}
/**
* Border Radius Classname
*
* @since 1.4.0
*/
function vcex_get_border_radius_class( $val ) {
if ( 'none' == $val || '' == $val ) {
return;
}
return 'wpex-'. $val;
}
/**
* Helper function for building links using link param
*
* @since 2.0.0
*/
function vcex_build_link( $link, $fallback = '' ) {
// If empty return fallback
if ( empty( $link ) ) {
return $fallback;
}
// Return if there isn't any link
if ( '||' == $link || '|||' == $link || '||||' == $link ) {
return;
}
// Return simple link escaped (fallback for old textfield input)
if ( false === strpos( $link, 'url:' ) ) {
return esc_url( $link );
}
// Build link
// Needs to use total function to fix issue with fallbacks
$link = vcex_parse_multi_attribute( $link, array( 'url' => '', 'title' => '', 'target' => '', 'rel' => '' ) );
// Sanitize
$link = is_array( $link ) ? $link : '';
// Return link
return $link;
}
/**
* Returns link data (used for fallback link settings)
*
* @since 2.0.0
*/
function vcex_get_link_data( $return, $link, $fallback = '' ) {
$link = vcex_build_link( $link, $fallback );
if ( 'url' == $return ) {
if ( is_array( $link ) && ! empty( $link['url'] ) ) {
return $link['url'];
} else {
return is_array( $link ) ? $fallback : $link;
}
}
if ( 'title' == $return ) {
if ( is_array( $link ) && ! empty( $link['title'] ) ) {
return $link['title'];
} else {
return $fallback;
}
}
if ( 'target' == $return ) {
if ( is_array( $link ) && ! empty( $link['target'] ) ) {
return $link['target'];
} else {
return $fallback;
}
}
if ( 'rel' == $return ) {
if ( is_array( $link ) && ! empty( $link['rel'] ) ) {
return $link['rel'];
} else {
return $fallback;
}
}
}
/**
* Returns correct icon class based on icon type
*
* @since 2.0.0
*/
function vcex_get_icon_class( $atts, $icon_location ) {
// Define vars
$icon = '';
$icon_type = ! empty( $atts['icon_type'] ) ? $atts['icon_type'] : 'fontawesome';
// Generate fontawesome icon class
if ( 'fontawesome' == $icon_type && ! empty( $atts[$icon_location] ) ) {
$icon = $atts[$icon_location];
$icon = str_replace( 'fa-', '', $icon );
$icon = str_replace( 'fa ', '', $icon );
$icon = 'fa fa-' . $icon;
} elseif ( ! empty( $atts[ $icon_location .'_'. $icon_type ] ) ) {
$icon = $atts[ $icon_location .'_'. $icon_type ];
}
// Sanitize
$icon = in_array( $icon, array( 'icon', 'none' ) ) ? '' : $icon;
// Return icon class
return $icon;
}
/**
* Adds inner row margin to compensate for the VC negative margins
*
*
* @since 2.0.0
*/
function vcex_offset_vc( $atts ) {
// No offset added here
if ( ! empty( $atts['full_width'] ) || ! empty( $atts['max_width'] ) ) {
return;
}
// Get column spacing
$spacing = ! empty( $atts['column_spacing'] ) ? $atts['column_spacing'] : '30';
// Return if spacing set to 0px
if ( '0px' == $spacing ) {
return;
}
// Define offset class
$classes = 'wpex-offset-vc-'. $spacing/2;
// Parallax check
if ( vcex_supports_advanced_parallax() ) {
if ( ! empty( $atts['vcex_parallax'] ) && ! empty( $atts['parallax_image'] ) ) {
return $classes;
}
}
// Self hosted video
if ( 'self_hosted' == $atts['video_bg'] && ! empty( $atts['video_bg_mp4'] ) ) {
return $classes;
}
// Youtube videos
if ( 'youtube' == $atts['video_bg'] && ! empty( $atts['video_bg_url'] ) ) {
return $classes;
}
// Overlays
$overlay = isset( $atts['wpex_bg_overlay'] ) ? $atts['wpex_bg_overlay'] : '';
if ( $overlay ) {
return $classes;
}
// Check for custom CSS
if ( ! empty( $atts['css'] ) ) {
if ( strpos( $atts['css'], 'background' )
|| strpos( $atts['css'], 'border' )
) {
return $classes;
}
} elseif ( ! empty( $atts['center_row'] )
|| ! empty( $atts['bg_image'] )
|| ! empty( $atts['bg_color'] )
|| ! empty( $atts['border_width'] )
) {
return $classes;
}
}
/**
* Returns video row background
*
* @since 2.0.0
*/
if ( ! function_exists( 'vcex_row_video' ) ) {
function vcex_row_video( $atts ) {
// Define output
$output = '';
// Return if disabled
if ( empty( $atts['wpex_self_hosted_video_bg'] ) ) {
return;
}
// Make sure at least one video is defined
if ( empty( $atts['video_bg_webm'] ) && empty( $atts['video_bg_ogv'] ) && empty( $atts['video_bg_mp4'] ) ) {
return;
}
// Check sound
$sound = apply_filters( 'vcex_self_hosted_row_video_sound', false );
$sound = $sound ? '' : 'muted volume="0"';
$output .= '