$value) { $new_explode[] = $explode[0]; } $explode = $new_explode; } foreach($explode as $key => $value) { if(!isset($value) && is_numeric($value)) { $value = $value ."px"; } if(empty($value) && ( isset($value) && $value !== "0") ) { $value = "0"; } else { $writen .= $attr_name ."-". $directions[$key] . ":".$value."; "; $comp_count ++; } $minifed .= $value ." "; } $minifed = $attr_name.":".trim($minifed)."; "; if($comp_count == 4) $writen = $minifed; //overwrite sets all values, those not set by the user are set to 0. complement only creates rules for set elements and skips unset rules $result = array( 'overwrite' => $minifed , 'complement' => $writen ); return $result; } /** * get_url - Returns a url based on a string that holds either post type and id or taxonomy and id */ static function get_url($link, $post_id = false) { $link = explode(',', $link, 2); if($link[0] == 'lightbox') { $link = wp_get_attachment_image_src($post_id, apply_filters('avf_avia_builder_helper_lightbox_size','large')); return $link[0]; } if(empty($link[1])) { return $link[0]; } if($link[0] == 'manually') { if(strpos($link[1], "@") !== false && strpos($link[1], "://") === false){ $link[1] = "mailto:".$link[1]; } return $link[1]; } if(post_type_exists( $link[0] )) { return get_permalink($link[1]); } if(taxonomy_exists( $link[0] )) { $return = get_term_link(get_term($link[1], $link[0])); if(is_object($return)) $return = ""; //if an object is returned it is a WP_Error object and something was not found return $return; } } /** * Returns a user friendly text that can be rendered to a screen reader output * Based on same input as to AviaHelper::get_url * * @since 4.2.7 * @added_by Günter * @param string $link * @param int|null $post_id * @return string */ static public function get_screen_reader_url_text( $link, $post_id = false ) { $link = explode( ',', $link, 2 ); if( $link[0] == 'lightbox' ) { $post = get_post( $post_id ); if( ! $post instanceof WP_Post ) { return __( 'No attachment image available', 'avia_framework' ); } $link = wp_get_attachment_image_src( $post_id, apply_filters( 'avf_avia_builder_helper_lightbox_size', 'large' ) ); if( false === $link ) { return __( 'No attachment image available for: ', 'avia_framework' ) . esc_html( $post->post_title ); } return __( 'Attachment image for: ', 'avia_framework' ) . esc_html( $post->post_title ); } if( empty( $link[1] ) ) { return __( 'Follow a manual added link', 'avia_framework' ); } if( $link[0] == 'manually' ) { if( strpos( $link[1], "@" ) !== false && strpos( $link[1], "://" ) === false ) { return __( 'Send an E-Mail to: ', 'avia_framework' ) . $link[1]; } return __( 'Follow a manual added link', 'avia_framework' ); } if( post_type_exists( $link[0] ) ) { $post = get_post( $link[1] ); if( ! $post instanceof WP_Post ) { return __( 'Wrong link - page does not exist', 'avia_framework' ); } return __( 'Link to: ', 'avia_framework' ) . esc_html( $post->post_title ); } if( taxonomy_exists( $link[0] ) ) { $term = get_term( $link[1], $link[0] ); if( ! $term instanceof WP_Term) { return __( 'Wrong link - page does not exist', 'avia_framework' ); } return sprintf( __( 'Link to %s in %s', 'avia_framework' ), $term->name, $term->taxonomy ); } return ''; } /** * get_entry - fetches an entry based on a post type and id */ static function get_entry($entry) { $entry = explode(',', $entry); if(empty($entry[1])) return false; if($entry[0] == 'manually') return false; if(post_type_exists( $entry[0] )) return get_post($entry[1]); } /** * fetch all available sidebars */ static function get_registered_sidebars($sidebars = array(), $exclude = array()) { //fetch all registered sidebars and save them to the sidebars array global $wp_registered_sidebars; foreach($wp_registered_sidebars as $sidebar) { if( !in_array($sidebar['name'], $exclude)) { $sidebars[$sidebar['name']] = $sidebar['name']; } } return $sidebars; } static function get_registered_image_sizes($exclude = array(), $enforce_both = false, $exclude_default = false) { global $_wp_additional_image_sizes; // Standard sizes $image_sizes = array( 'no scaling'=> array("width"=>"Original Width ", "height"=>" Original Height"), 'thumbnail' => array("width"=>get_option('thumbnail_size_w'), "height"=>get_option('thumbnail_size_h')), 'medium' => array("width"=>get_option('medium_size_w'), "height"=>get_option('medium_size_h')), 'large' => array("width"=>get_option('large_size_w'), "height"=>get_option('large_size_h'))); if(!empty($exclude_default)) unset($image_sizes['no scaling']); if ( isset( $_wp_additional_image_sizes ) && count( $_wp_additional_image_sizes ) ) $image_sizes = array_merge( $image_sizes, $_wp_additional_image_sizes ); $result = array(); foreach($image_sizes as $key => $image) { if( (is_array($exclude) && !in_array($key, $exclude)) || (is_numeric($exclude) && ($image['width'] > $exclude || $image['height'] > $exclude)) || !is_numeric($image['height'])) { if($enforce_both == true && is_numeric($image['height'])) { if($image['width'] < $exclude || $image['height'] < $exclude) continue; } $title = str_replace("_",' ', $key) ." (".$image['width']."x".$image['height'].")"; $result[ucwords( $title )] = $key; } } return $result; } static function list_menus() { $term_args = array( 'taxonomy' => 'nav_menu', 'hide_empty' => false ); $menus = AviaHelper::get_terms( $term_args ); $result = array(); if(!empty($menus)) { foreach ($menus as $menu) { $result[$menu->name] = $menu->term_id; } } return $result; } /** * is_ajax - Returns true when the page is loaded via ajax. */ static function is_ajax() { if ( defined('DOING_AJAX') ) return true; return ( isset( $_SERVER['HTTP_X_REQUESTED_WITH'] ) && strtolower( $_SERVER['HTTP_X_REQUESTED_WITH'] ) == 'xmlhttprequest' ) ? true : false; } /** * function that gets called on backend pages and hooks other functions into wordpress * * @return void */ static function backend() { add_action( 'print_media_templates', array('AviaHelper', 'print_templates' )); //create js templates for AviaBuilder Canvas Elements } /** * Helper function that prints an array as js object. can call itself in case of nested arrays * * @return void */ static function print_javascript($objects = array(), $print = true, $passed = "") { $output = ""; if($print) $output .= "\n\n\n"; echo $output; } return $output; } /** * Helper function that prints all the javascript templates * * @return void */ static function print_templates() { foreach (self::$templates as $key => $template) { echo "\n\n\n"; } //reset the array self::$templates = array(); } /** * Helper function that creates a new javascript template to be called * * @return void */ static function register_template($key, $html) { self::$templates[$key] = $html; } /** * Helper function that fetches all "public" post types. * * @return array $post_types example output: data-modal='true' */ static function public_post_types() { $post_types = get_post_types(array('public' => false, 'name' => 'attachment', 'show_ui'=>false, 'publicly_queryable'=>false), 'names', 'NOT'); $post_types['page'] = 'page'; $post_types = array_map("ucfirst", $post_types); $post_types = apply_filters('avia_public_post_types', $post_types); self::$cache['post_types'] = $post_types; return $post_types; } /** * Helper function that fetches all taxonomies attached to public post types. * * @return array $taxonomies */ static function public_taxonomies($post_types = false, $merged = false) { $taxonomies = array(); if(!$post_types) $post_types = empty(self::$cache['post_types']) ? self::public_post_types() : self::$cache['post_types']; if(!is_array($post_types)) $post_types = array($post_types => ucfirst($post_types)); foreach($post_types as $type => $post) { $taxonomies[$type] = get_object_taxonomies($type); } $taxonomies = apply_filters('avia_public_taxonomies', $taxonomies); self::$cache['taxonomies'] = $taxonomies; if($merged) { $new = array(); foreach($taxonomies as $taxonomy) { foreach($taxonomy as $tax) { $new[$tax] = ucwords(str_replace("_", " ",$tax)); } } $taxonomies = $new; } return $taxonomies; } /** * Helper function to ensure backwards comp. for WP version < 4.5 * * @since 4.4.2 * @added_by Günter * @param array $term_args * @return array|int|WP_Error List of WP_Term instances and their children. Will return WP_Error, if any of $taxonomies do not exist. */ static public function get_terms( array $term_args ) { global $wp_version; if( version_compare( $wp_version, '4.5.0', '>=' ) ) { $terms = get_terms( $term_args ); } else { $depr = $term_args; unset( $depr['taxonomy'] ); $terms = get_terms( $term_args['taxonomy'], $depr ); } return $terms; } /** * Helper function that converts an array into a html data string * * @param array $data example input: array('modal'=>'true') * @return string $data_string example output: data-modal='true' */ static function create_data_string($data = array()) { $data_string = ""; foreach($data as $key=>$value) { if(is_array($value)) $value = implode(", ",$value); $data_string .= " data-$key='$value' "; } return $data_string; } /** * Create a lower case version of a string without spaces so we can use that string for database settings * * @param string $string to convert * @return string the converted string */ static function save_string( $string , $replace = "_") { $string = strtolower($string); $trans = array( '&\#\d+?;' => '', '&\S+?;' => '', '\s+' => $replace, 'ä' => 'ae', 'ö' => 'oe', 'ü' => 'ue', 'Ä' => 'Ae', 'Ö' => 'Oe', 'Ü' => 'Ue', 'ß' => 'ss', '[^a-z0-9\-\._]' => '', //$replace.'+' => $replace, //allow doubles like -- or __ $replace.'$' => $replace, '^'.$replace => $replace, '\.+$' => '' ); $trans = apply_filters('avf_save_string_translations', $trans, $string, $replace); $string = strip_tags($string); foreach ($trans as $key => $val) { $string = preg_replace("#".$key."#i", $val, $string); } return stripslashes($string); } /** * Create a lower case version of a string without spaces and special characters so we can use that string for a href anchor link. * Returns the default if the remaining string is empty or invalid (not at least one a-z, 0-9). * * @param string $link * @param string $replace * @param string $default * @return string */ static public function valid_href( $link, $replace = '_', $default = '' ) { /** * Create a unique default value for the link if none provided */ if( '' == trim( $default ) ) { $default = uniqid( '', true ); $default = strtolower( str_replace( '.', '-', $default ) ); } $new_link = AviaHelper::save_string( $link, $replace ); if( '' == trim( $new_link ) ) { $new_link = $default; } else { /** * non latin letters in $link might return an invalid link from AviaHelper::save_string (e.g. ---) * Also make sure link starts with [a-z0-9] */ $sc_found = array(); preg_match_all( "/[a-z0-9]/s", $new_link, $sc_found, PREG_OFFSET_CAPTURE ); if( empty( $sc_found ) || ! is_array( $sc_found ) || empty( $sc_found[0]) || ( $sc_found[0][0][1] != 0 ) ) { $new_link = $default; } } return $new_link; } /** * Helper function that fetches the active value of the builder. also adds a filter * * @deprecated since version 4.2.1 */ static function builder_status($post_ID) { _deprecated_function( 'builder_status', '4.2.1', 'AviaBuilder::get_alb_builder_status()'); $status = get_post_meta($post_ID, '_aviaLayoutBuilder_active', true); $status = apply_filters('avf_builder_active', $status, $post_ID); return $status; } /** * Helper function that builds css styling strings which are applied to html elements * */ static function style_string($atts, $key = false, $new_key = false, $append_value = "") { $style_string = ""; //finish the style string by wrapping the arguments into a style string if((is_string($atts) || ! $atts ) && false == $key) { if(!empty($atts)) { $style_string = "style='".$atts."'"; } } else //otherwise build only the styling argument { if(empty($new_key)) $new_key = $key; if(isset($atts[$key]) && $atts[$key] !== "") { switch($new_key) { case "background-image": $style_string = $new_key.":url(".$atts[$key].$append_value."); "; break; case "background-repeat": if($atts[$key] == "stretch") $atts[$key] = "no-repeat"; $style_string = $new_key.":".$atts[$key].$append_value."; "; break; default: $style_string = $new_key.":".$atts[$key].$append_value."; "; break; } } } return $style_string; } /** * Helper function that builds background css styling strings * Useful when there are multiple background settings like an image and a gradient * Returns a string to be used with the background property, e.g. style="background: $string"; * * @param array $bg_image = array('url','position','repeat','attachment') * @param array $bg_gradient = array('direction','color1','color2') * direction: vertical, horizontal, radial, diagonal_tb, diagonal_bt * */ static function css_background_string($bg_image = array(), $bg_gradient = array()){ $background = array(); // bg image if ( ! empty( $bg_image ) ) { if ( $bg_image['0'] !== '' ) { $background['image_string'] = array(); $background['image_string'][] = 'url("'.$bg_image['0'].'")'; // bg image position if ( array_key_exists('1', $bg_image) ) { $background['image_string'][] = $bg_image['1']; } else { $background['image_string'][] = 'center'; } // bg image repeat if ( array_key_exists('2', $bg_image) ) { $background['image_string'][] = $bg_image['2']; } else { $background['image_string'][] = 'no-repeat'; } // bg image attachment if ( array_key_exists('3', $bg_image) ) { $background['image_string'][] = $bg_image['3']; } } } // bg image css string if ( ! empty ( $background['image_string'] ) ) { $background['image_string'] = implode( ' ', $background['image_string'] ); } // gradient if ( ! empty( $bg_gradient ) && count ( $bg_gradient ) == 3 ) { if ($bg_gradient['0'] !== '') { $background['gradient_string'] = array(); switch ($bg_gradient['0']) { case 'vertical': $background['gradient_string'][] = 'linear-gradient('; break; case 'horizontal': $background['gradient_string'][] = 'linear-gradient(to right,'; break; case 'radial': $background['gradient_string'][] = 'radial-gradient('; break; case 'diagonal_tb': $background['gradient_string'][] = 'linear-gradient(to bottom right,'; break; case 'diagonal_bt': $background['gradient_string'][] = 'linear-gradient(45deg,'; break; } // gradient css string if ( ! empty( $background['gradient_string'] ) ) { $background['gradient_string'][] .= $bg_gradient['1'] . ', ' . $bg_gradient['2'] . ')'; } } } // bg gradient css string if ( ! empty ( $background['gradient_string'] ) ) { $background['gradient_string'] = implode( ' ', $background['gradient_string'] ); } if ( ! empty( $background ) ) { $background = implode(', ', $background ); return $background; } else { return false; } } static function backend_post_type() { global $post, $typenow, $current_screen; $posttype = ""; //we have a post so we can just get the post type from that if ($post && $post->post_type) { $posttype = $post->post_type; } //check the global $typenow - set in admin.php elseif($typenow) { $posttype = $typenow; } //check the global $current_screen object - set in sceen.php elseif($current_screen && $current_screen->post_type) { $posttype = $current_screen->post_type; } //lastly check the post_type querystring elseif(isset($_REQUEST['post_type'])) { $posttype = sanitize_key($_REQUEST['post_type']); } return $posttype; } static function av_mobile_sizes($atts = array()) { $result = array('av_font_classes'=>'', 'av_title_font_classes'=>'', 'av_display_classes' => '', 'av_column_classes' => ''); $fonts = array('av-medium-font-size', 'av-small-font-size', 'av-mini-font-size'); $title_fonts= array('av-medium-font-size-title', 'av-small-font-size-title', 'av-mini-font-size-title'); $displays = array('av-desktop-hide', 'av-medium-hide', 'av-small-hide', 'av-mini-hide'); $columns = array('av-medium-columns', 'av-small-columns', 'av-mini-columns'); if(empty($atts)) $atts = array(); foreach($atts as $key => $attribute) { if(in_array($key, $fonts) && $attribute != "") { $result['av_font_classes'] .= " ".$key."-overwrite"; $result['av_font_classes'] .= " ".$key."-".$attribute; if($attribute != "hidden") self::$mobile_styles['av_font_classes'][$key][$attribute] = $attribute; } if(in_array($key, $title_fonts) && $attribute != "") { $newkey = str_ireplace('-title', "", $key); $result['av_title_font_classes'] .= " ".$newkey."-overwrite"; $result['av_title_font_classes'] .= " ".$newkey."-".$attribute; if($attribute != "hidden") { self::$mobile_styles['av_font_classes'][$newkey][$attribute] = $attribute; } } if(in_array($key, $displays) && $attribute != "") { $result['av_display_classes'] .= " ".$key; } if(in_array($key, $columns) && $attribute != "") { $result['av_column_classes'] .= " ".$key."-overwrite"; $result['av_column_classes'] .= " ".$key."-".$attribute; } } return $result; } static function av_print_mobile_sizes() { $print = ""; //rules are created dynamically, otherwise we would need to predefine more than 500 csss rules of which probably only 2-3 would be used per page $media_queries = apply_filters('avf_mobile_font_size_queries' , array( "av-medium-font-size" => "only screen and (min-width: 768px) and (max-width: 989px)", "av-small-font-size" => "only screen and (min-width: 480px) and (max-width: 767px)", "av-mini-font-size" => "only screen and (max-width: 479px)", )); if(isset(self::$mobile_styles['av_font_classes']) && is_array(self::$mobile_styles['av_font_classes'])) { $print .=""; } return $print; } } }